Diffbot MCPサーバー

Diffbot MCPサーバーは、エージェントやLLMパイプライン向けに、多彩で有用なWebデータ処理ツールを提供します。

Diffbotとは？ Diffbotは、Webを構造化するAIを構築している小さな研究企業です。当社の製品は、公開Web全体に対するAPIのように、アプリケーションを自動的に構造化されたWebに接続します。

ツール

🧬 extract

Webフェッチツールの代替 従来のフェッチツールは、50万トークン以上のHTMLか、ページ内容をマークダウンで近似したものを返します。Extractはフェッチするページを分類し、内容を意味のある一貫したJSON構造に抽出します。応答は、データの忠実性を維持しながらトークン使用量を最小限に抑えるように最適化されています。 Diffbot Extract API を利用しています。

🔎 search_web

正確性を優先し、人気度を優先しないWeb検索ツール Diffbotの自社Webインデックスに基づいて構築されています。ランキングモデルは、二次情報源よりも一次情報源を強く優先します（例：プレスリリース > そのプレスリリースに関するニュース記事）。ソース引用のためにマークダウン形式のコンテンツチャンクを返します。トークン管理が組み込まれて最適化されています。

🪄 enhance

組織や人物向けのWebルックアップツール Web検索とは異なり、enhanceはDiffbotナレッジグラフから組織や人物に関する構造化データを（名前、URL、またはその他の受け入れ可能な入力によって）返します。事実確認、市場調査、またはセールスインテリジェンスのワークフローに役立ちます。

🧠 resolve_entities

テキスト内のエンティティを認識し解決する Diffbot NLPを使用して、テキスト内の組織、人物、場所、住所、その他の固有名詞を認識します。エンティティはDiffbotナレッジグラフ内のエンティティIDに解決され、dqlを使用してさらにコンテキストを取得できます。ハルシネーションを抑制し、AIが深いリサーチを進めるために必要なコンテキストを提供します。

🕷️ crawl

Webページ（シード）上のすべてのリンクを見つけ、それらをすべて抽出する 古典的なWebクロールに、オントロジー的なWeb抽出のボーナスが付いています。crawlを使用して、ドキュメントのアーカイブ、Webプロジェクトのスナップショット取得、またはサイトマッピングを行います。

🎯 dql

Diffbotナレッジグラフに対して、組織、人物、記事、場所、製品エンティティをクエリする Diffbotナレッジグラフには、組織、人物、（ニュース）記事、場所、製品に関するウィキペディア規模のリンクされたグラフデータベースが含まれています。Diffbot MCPはプロンプトを構造化クエリ（dql）に変換し、分析後のための構造化レコードを返します。

🧭 dql_ontology

正確なdqlオントロジーナビゲーションのためのヘルパーユーティリティ Diffbotのオントロジーとタクソノミリファレンス全体の鍵を保持しています。Diffbot MCPが正確なdqlクエリを作成するために使用します。人間が触る必要はありませんが、好奇心を満たすために自由に使用してください。

Related MCP server: AgentWebSearch-MCP

認証

ツールを使用するには、無料のDiffbotトークンが必要です。 こちらから入手してください。

はじめに

クイックスタート

最も簡単な開始方法は、MCPクライアントをDiffbotがホストするリモートMCPサーバーに直接接続することです。

https://mcp.diffbot.com/mcp?token=<YOUR_DIFFBOT_TOKEN>

このリポジトリはリモートサーバーに直接デプロイされます。

ローカルインストール

リポジトリをクローンします

git clone git@github.com:diffbot/diffbot-mcp.git

依存関係をインストールします

pip install .

これで、python3 diffbot_mcp_server.py でサーバーを実行できます。MCPクライアントでこのサーバーを設定する場合は、この手順をスキップしても構いません。

（オプション）Dockerインストール

イメージをビルドします

docker build -t diffbot-mcp .

MCPクライアントでのセットアップ

Claude Desktopをセットアップするには、公式インストールガイド に従い、この claude_desktop_config.json 設定例を使用してください（必要に応じて変数を置き換えてください）。

この標準設定は、ほとんどのIDEと環境で動作します。

{
    "mcpServers": {
        "diffbot-mcp": {
            "command": "python3",
            "args": [
                "/<YOUR_PROJECT_FOLDER>/diffbot-mcp/diffbot_mcp_server.py"
            ],
            "env": {
                "DIFFBOT_TOKEN": "<YOUR_DIFFBOT_TOKEN>"
            }
        }
    }
}

Dockerインストールの場合は、次の設定に従ってください。

{
    "mcpServers": {
        "diffbot-mcp": {
            "command": "docker",
            "args": [
                "run",
                "--rm",
                "-i",
                "-e", "DIFFBOT_TOKEN=<YOUR_DIFFBOT_TOKEN>",
                "diffbot-mcp"
            ]
        }
    }
}

リモート設定の場合、リモートサーバーURLを入力し、トランスポートタイプとして「http」を含めるだけです。

{
  "servers": {
    "diffbot-mcp": {
      "type": "http",
      "url": "https://mcp.diffbot.com/mcp/?token=<YOUR_DIFFBOT_TOKEN>"
    }
  }
}

ローカル設定の場合、シークレット管理を改善するためにこの修正設定を試してください。

{
	"servers": {
        "diffbot-mcp": {
            "command": "python3",
            "args": [
                "/<YOUR_PROJECT_FOLDER>/diffbot-mcp/diffbot_mcp_server.py"
            ],
            "env": {
                "DIFFBOT_TOKEN": "${input:diffbot-api-key}"
            }
        }
	},
	"inputs": [
		{
			"password": true,
			"id": "diffbot-api-key",
			"type": "promptString",
			"description": "Diffbot API Key"
		}
	]
}

ヘルプとサポート

このプロジェクトは @jeromechoo によって構築・保守されています。サポートが必要な場合は、Issueを提出してください。可能な限り迅速に対応します。より迅速な回答が必要な場合は、sales@diffbot.com までお問い合わせください 😜。