Skip to main content
将八爪鱼采集能力接入 Coze(扣子)、Dify、QClaw(小龙虾)、ChatGPT、Claude、Cursor、Gemini 等兼容 MCP 的 AI 智能体。 八爪鱼 MCP 是面向 AI 智能体的标准化数据连接器。在对话中可以直接查询数据中心已经积累的存量内容,也可以搜索预置模板、触发云端采集、导出多种格式的数据,或按需采集 Temu、TikTok Shop 电商数据,无需手写爬虫代码。 截至 2026 年 7 月 22 日,实测服务版本为 0.8.3.3-85ef7c4b,协商协议版本为 2025-11-25,公开 10 个工具。服务端会持续更新,客户端实际可用能力应以连接后的工具发现结果为准。

前置条件

  • 八爪鱼账户 — 免费版也可连接;免费 / 基础版用户每周可通过 MCP 获得 2,000 条免费采集额度
  • 兼容 MCP 的客户端 — 见下方 平台对接,或 客户端配置指南

让 Agent 自动添加(推荐)

WorkBuddy、QClaw、豆包专业版等具备工具配置能力的 Agent,通常可以根据一段对话自行添加 MCP 服务。先在账户中心创建 API Key,再将下面的内容发给 Agent,并把占位符替换为你的真实 Key:
仅在可信的本地 Agent 或私密对话中提供 API Key。不要把真实 Key 发送到群聊、公开对话或截图中;安装完成后也不要让 Agent 回显密钥。
这里的“只使用 API Key”是针对上述 Agent 自动配置场景,用于避免客户端误判鉴权方式。ChatGPT、Claude、Cursor 等平台教程中明确支持的 OAuth 流程仍可正常使用。若 Agent 无权修改配置,请按客户端配置指南手动添加。

能力范围

支持

  • 搜索预置采集模板
  • 触发并监控云采集任务
  • 预览并导出多种格式的数据
  • 列出 / 搜索已有任务
  • 启动或停止云端任务
  • 查询数据中心的网页与媒体存量内容
  • 提交并查询电商评论采集
  • 兑换优惠码

不支持

  • 仅支持本地运行的任务(需桌面客户端)
  • 创建或编辑任务配置
  • 上传自定义模板
  • 访问账户设置或账单
  • 无预置模板时自动生成任意网页采集规则

认证方式

OAuth 2.1(推荐)

浏览器登录八爪鱼账户,无需手动复制 API Key。适合 ChatGPT、Claude、Cursor、Gemini、Coze、Dify 等支持 OAuth 的客户端。

API Key

使用请求头 x-api-key 直连。适合 Dify、Coze 自定义 MCP、QClaw、无头环境等。详见 获取 API Key
请勿将 API Key 写入公开仓库、截图或群聊。泄露后请立即在账户中心作废并重新创建。

按场景拆分数据任务

八爪鱼只提供一个 MCP 服务。为了让 Agent 更准确地选择工具,服务将完整的数据任务拆分为以下具体场景;它们不是三套彼此独立的产品,同一个业务任务可以组合使用多组工具。 例如,Agent 可以先从数据中心做跨平台检索,发现重点商品或网站后,再转入电商实时采集或模板化采集流程补充数据。 数据中心交付的是提前采集的存量数据:用户发起查询时直接检索已有内容,不必等待临时创建网页采集任务。一次于 2026 年 7 月 29 日进行的只读核验中,list_platforms 返回 898 个平台条目,映射到 787 个去重域名。这是当前可检索来源目录的规模口径,不是内容记录总数或固定服务承诺;同一域名可以对应多个产品入口或客户端形态,例如 toutiao.com 对应微头条、头条号、今日头条等多个条目。 目录覆盖社交社区、新闻资讯、财经证券、汽车、消费维权、招投标、政务公开资源和海外媒体等来源,数据形态包括网页、图片与视频。已核验的示例包括小红书、微信、微信视频号、知乎、豆瓣、百度贴吧、Facebook、人民网、新华网、腾讯新闻、东方财富网、雪球网、懂车帝、汽车之家、中国政府采购网、Reuters、Bloomberg、The Guardian 和 Yahoo! JAPAN。实际记录总量、可检索时间范围和平台目录都会持续变化;查询前应以 list_platforms 的实时返回为准。

通用采集工具

数据中心与电商数据工具

各工具参数见侧栏 通用采集工具数据中心与电商数据 分组。

快速开始

1

确认客户端支持 MCP

在 AI 产品中找到「MCP / 连接器 / 工具」配置入口。
2

让 Agent 添加或手动填写

优先将上方对话发送给支持自主配置的 Agent;也可以手动填写 https://mcp.bazhuayu.com(国际环境使用 https://mcp.octoparse.com)。
3

完成认证

选择 OAuth 登录,或配置 API Key
4

在对话中试用

先用只读请求验证连接,例如:「列出数据中心当前支持的平台」,或「帮我找一个采集电商商品列表的八爪鱼模板」。

示例工作流

完整流程见 工作流程示例
  1. search_templates — 发现模板
  2. execute_task(validateOnly) — 校验参数和数据源选择
  3. execute_task — 通过 MCP Tasks 或兼容模式运行云采集
  4. tasks/get / tasks/result — 支持 MCP Tasks 时跟踪状态
  5. export_data — 预览数据并取得导出文件

协议能力与 Resources

当前服务协商得到以下能力:
  • tools.listChanged:工具列表变化时可通知客户端刷新
  • resources.listChanged:资源列表变化时可通知客户端刷新
  • MCP Tasks:支持列出、取消和跟踪工具任务;execute_task 可选支持 Task 模式
  • Completions 与 Logging:可供兼容客户端使用
服务提供 octoparse://workflow 工作流说明,以及模板搜索、任务搜索和导出预览三个 ui://widget/... 资源。Widget 面向支持 OpenAI Apps SDK 等 UI 资源的客户端;普通 MCP 客户端仍可正常调用工具,但不一定渲染这些界面。

平台对接

下一步

获取 API Key

API Key 创建与 x-api-key 配置说明。

速率限制

请求配额与 429 重试建议。

故障排查

连接、授权与任务执行常见问题。