如何通过 MCP 将 Diffbot 连接到 Cursor

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Diffbot、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

Diffbot + Cursor

从你的 AI 使用 Diffbot 结构化网页数据：对任意页面分类，并把文章、商品、讨论、图片和视频提取为带类型的 JSON 或 markdown，用 DQL 搜索 Diffbot 知识图谱（Knowledge Graph），用 Enhance 匹配一家企业或一个人，在文本中识别实体和情感，并搜索 Diffbot 的网页索引。除账户查询外，所有工具都会消耗 Diffbot 额度；知识图谱结果每条 25 个额度。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

DIFFBOT_TOKEN

步骤 1 — 获取凭证

设置大约需要 2 分钟。你需要一个 Diffbot 账户；有一个每月附带额度的免费套餐。

1. 在 https://app.diffbot.com/get-started/ 注册。
2. 打开控制台（https://app.diffbot.com），通过右上角的令牌链接复制你的 API token。
3. 把它粘贴到 DIFFBOT_TOKEN。Diffbot 以查询参数 token 接收它（网页搜索则用 Bearer 请求头）；它只发往 diffbot.com 的主机。
4. 安装连接器并运行 diffbot_get_account：它显示套餐、每月额度和每日用量，并确认令牌有效。

哪些工具消耗额度：除 diffbot_get_account 外，所有工具都会消耗 Diffbot 额度。提取一个页面计 1 个额度，通过 Diffbot 代理计 2 个（diffbot_analyze、diffbot_extract_article、diffbot_extract_product、diffbot_extract_discussion、diffbot_extract_image、diffbot_extract_video）；使用 paging 时，文章或讨论帖的每一个后续页面再计 1 个额度。diffbot_analyze_text 每 10,000 个字符计 1 个额度。知识图谱很贵：diffbot_search_kg 每返回一个实体计 25 个额度，每次分面（facet）查询计 100 个；diffbot_enhance 每个匹配计 25 个，使用 refresh 时计 100 个。没有结果的搜索和匹配免费。diffbot_search_web 也是付费的。超出套餐配额的额度按套餐费率计费。AI 会把 size 控制得很小（这里默认 5 个实体，即最多 125 个额度），并在可能返回大量实体的知识图谱调用之前告诉你额度成本。

读取页面：diffbot_analyze 对任意 URL 进行分类（文章、商品、讨论、图片、视频、列表、活动或其他），并用相应的 API 提取；内容位于 objects[] 中。mode: llm 改为返回主要内容的 markdown，把页面类型作为 mode 则强制使用该类型提取（对被归为“其他”的页面，可用 fallback 指定类型）。类型已知时，AI 会直接调用对应工具：

• diffbot_extract_article：标题、正文、作者、日期、网站、语言、带知识图谱链接的标签、分类、情感和图片；natural_language 可追加摘要、实体或事实，paging 会合并多页文章。
• diffbot_extract_product：标题、品牌、促销价和原价、库存状态、SKU、GTIN、规格、图片、分类和评价。
• diffbot_extract_discussion：论坛帖子、评论区或评价页面中的帖子，包含作者、日期、正文、投票和情感；paging 会继续读取后续页面（max_pages 默认 20）。
• diffbot_extract_image 和 diffbot_extract_video：图片的 URL、尺寸、说明文字和替代文本；视频的标题、描述、时长、播放次数、嵌入 URL 和缩略图 URL。

知识图谱：diffbot_search_kg 用 DQL 在数十亿个组织、人物、文章、商品和活动中搜索，例如 type:Organization industries:"Software Companies" location.country.name:"China" nbEmployees>500 sortBy:nbEmployees 或 type:Person employments.employer.name:"Diffbot" employments.isCurrent:true。filter（例如 name;homepageUri;nbEmployees）只返回需要的字段，filter_exclude 去掉某些字段；cluster 对文章分组或去重。diffbot_enhance 根据你掌握的信息（名称加上 URL、地点、电话、邮箱、雇主、职位或学校）匹配一个 Organization 或 Person，返回最佳匹配及其 score；threshold 设置最低分数。

文本和网页搜索：diffbot_analyze_text 最多读取 100,000 个字符，返回带知识图谱 id 和重要度的实体、-1 到 1 的情感值，按需还可返回事实、记录、分类、句子和摘要。diffbot_search_web 对 Diffbot 自有索引中的页面排序，返回 URL、标题、日期、分数和可供引用的内容片段；text 中可以使用 site:、url:、after: 和 before:，max_tokens 可缩短响应。

会修改的内容：没有。所有工具都只读，安装时也没有关闭任何工具；唯一的成本是额度。

数据格式：提取对象中的日期是 RFC 1123 文本（Fri, 04 Sep 2020 00:00:00 GMT）。diffbotUri 和 id 用于标识知识图谱实体。价格以文本（offerPrice）和带货币符号的 offerPriceDetails.amount 两种形式返回。知识图谱结果位于 data[].entity，hits 是匹配总数。响应上限约 100 KB，提取结果中会去掉完整的页面 HTML（text 字段保留内容）。

分页：diffbot_search_kg 用 from 和 size 分页（不适用于 Article 查询）；每一页实体都会重新计费。diffbot_search_web 返回 size 条结果（默认 10 条）。

不可信内容：提取的页面、搜索结果和知识图谱记录都来自第三方网站。AI 会把其中的指令当作数据，而不是命令。

常见错误：401 Not authorized API token 表示令牌错误或未激活，请从控制台重新复制。404 Could not download page 表示 URL 无法访问、被拦截或需要登录，可尝试 use_proxy: default（2 个额度）。429 表示同时请求过多，或额度不足以完成知识图谱调用，请稍候或检查套餐。DQL 返回 400 表示 query 有语法错误：含空格的值要加引号，并使用本体中的字段名（https://www.diffbot.com/docs/dql/reference）。正文中带有 errorCode 的提取响应会作为失败调用报告，并附上 Diffbot 的消息。

该连接器不运行 Crawl 或 Bulk 任务、自定义提取规则、知识图谱导出为 CSV 或 Excel、批量 Enhance 任务，也不支持 Diffbot LLM 聊天。

步骤 2 — 安装 adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 Cursor 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Cursor 从 ~/.cursor/mcp.json 读取 MCP 服务器。添加以下条目：

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 Cursor。
3. 打开 Cursor → Settings → MCP，确认 anythingmcp 已列出并处于已连接状态。
4. 开始对话，智能体现在可以调用 Diffbot 的工具。

可用工具

示例提示

• “提取这篇新闻文章，告诉我作者、日期、三句话的摘要和情感倾向。”
• “读取这个商品页面，告诉我促销价、原价以及是否有货。”
• “在知识图谱中找 5 家员工超过 500 人的中国软件公司，只显示网站和员工人数。先告诉我额度成本。”
• “在知识图谱中匹配 diffbot.com 背后的公司，显示它的行业、所在地和员工人数。”
• “我们这个月用了多少 Diffbot 额度？哪个产品用得最多？”

FAQ

Cursor 免费套餐支持自定义 MCP 服务器吗？ 支持，Hobby、Pro 和 Business 套餐均可使用 MCP。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT
• 连接到 Gemini
• 连接到 Meta Muse
• 连接到 Microsoft Copilot