Duckduckgo Search

🚀 MCP 鸭子🦆 插件

MCP 鸭子🦆 プラグインは、コンテンツ抽出とウェブクローリング機能を強化するためのツールです。DuckDuckGo 検索を通じたコンテンツ収集をサポートし、豊富なデータ処理能力を提供します。

🚀 クイックスタート

MCP 鸭子🦆 プラグインを使い始めるには、まずインストールが必要です。以下の手順に従って、簡単にセットアップできます。

✨ 主な機能

強化されたコンテンツ抽出

このプラグインは、強力なコンテンツ分析と収集機能を提供します。

• ウェブページ分析：DuckDuckGo の検索結果から HTML コンテンツを抽出して解析します。
• スマートコンテンツ認識：ウェブサイトの種類に応じて、主要な情報領域を自動的に特定します。
• メタデータ抽出：タイトル、説明、著者、キーワード、公開日などの情報を抽出します。
• 画像検出：ウェブページ内の主要な画像やメディアリソースを識別します。
• ソーシャルリンク抽出：ウェブページに埋め込まれたソーシャルメディアのリンクを取得します。
• コンテンツ構造分析：ウェブページの見出しやセクションを抽出し、ページの構造を理解しやすくします。
• 公式ソース識別：ドメイン名とコンテンツの信号に基づいて、情報源が公式チャネルかどうかを判断します。

ウェブクローリング機能

プラグインは、基本的なウェブクローラー機能も提供します。

• 設定可能な深さ：元の URL から最大 3 層のリンクをたどります。
• リンク制限：ページごとに取得する最大リンク数を制御します（1 - 5）。
• ドメイン制限：「同一ドメイン内のみでクローリング」オプションを選択できます。
• 関連コンテンツ発見：クローリング結果に基づいて、関連するウェブページのコンテンツを分析して抽出します。

📦 インストール

快速インストール

pip install mcp-duckduckgo

リポジトリのクローン（開発用）

プロジェクトを変更したり、コードを貢献したりする場合は、まずリポジトリをクローンします。

git clone https://github.com/gianlucamazza/mcp-duckduckgo.git
cd mcp-duckduckgo
pip install -e .

💻 使用例

基本的な使用法

MCP サーバーの初期化

以下のコマンドを実行して、MCP サーバーを起動します。

mcp-duckduckgo serve --port=8000

依存関係のインストール

プロジェクトのルートディレクトリで、すべての依存関係をインストールします。

pip install -r requirements.txt

📚 ドキュメント

開発ガイド

プロジェクト構造

プロジェクトは以下の主要なファイルを含んでいます。

mcp_duckduckgo/
├── mcp_duckduckgo/    # プラグインのメインコード
│   ├── models.py       # データモデルの定義
│   ├── search.py       # 検索機能の実装
│   └── server.py       # MCP サーバーの実装
└── scripts/            # 開発用スクリプト
    ├── install_dev.sh  # 開発環境のセットアップ
    ├── run.sh          # MCP サーバーの実行（開発モード）
    ├── test.sh         # テストケースの実行とカバレッジレポートの生成
    └── lint.sh         # コードフォーマットのチェックと修正

開発用スクリプト

プロジェクトは、scripts/ ディレクトリに便利なスクリプトを提供しています。

• install_dev.sh：開発環境に必要な依存関係をインストールします。
• run.sh：開発モードで MCP サーバーを実行します。
• test.sh：テストケースを実行し、カバレッジレポートを生成します。
• lint.sh：コードフォーマットをチェックして修正します。

テストガイド

プロジェクトでテストを実行するには、以下のコマンドを実行します。

python -m pytest tests/ --cov=mcp_duckduckgo/

依存関係の管理

プロジェクトの依存関係情報は requirements.txt ファイルに記録されています。すべての依存関係をインストールするには、以下のコマンドを実行します。

pip install -r requirements.txt

貢献ガイド

貢献を歓迎します！以下の手順に従ってください。

1. リポジトリをクローンします：git clone https://github.com/gianlucamazza/mcp-duckduckgo.git
2. 機能ブランチを作成します：git checkout -b feature/your-feature-name
3. 変更をコミットします：git add . && git commit -m "新機能の追加"
4. リモートリポジトリにプッシュします：git push origin feature/your-feature-name
5. メインブランチに Pull Request を送信します。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。具体的な内容は以下の通りです。

MIT License

ご興味いただき、ありがとうございます！何か質問や提案があれば、いつでもご連絡ください。