跳转到主要内容

​
何时使用 API Key

认证方式适用场景
OAuth 2.1ChatGPT、Claude、Cursor、Gemini 等支持浏览器登录的客户端；Coze、Dify 安装官方工具时
API KeyCoze 自定义 MCP、Dify API Key 模式、QClaw、Cursor、Claude Code、脚本 / 无头环境

​
创建 API Key

1

登录并打开账号信息

登录 https://www.bazhuayu.com/ 后点击账号信息。登录八爪鱼官网后点击账号信息
2

进入 API 密钥并新增

点击 API 密钥，新增密钥。（建议每个连接的智能体都有独立的密钥便于管理）在账户中心点击 API 密钥并新增密钥
3

自定义名称并生成

自定义密钥名称，点击生成。填写密钥名称并点击生成密钥
4

复制并妥善保存密钥

此后便获取到密钥。（注意！！！密钥只会在这个界面显示一次，后续无法获取，一定妥善保存。同时建议每次连接新载体都新建密钥，便于管理）生成后复制 API 密钥并妥善保存
不要将 API Key 提交到 Git、飞书文档公开页、截图或客服群。仅在 MCP 客户端的「密钥 / Headers」配置项中填写。

​
在 MCP 客户端中配置

​
通用 HTTP MCP 配置

{
  "type": "http",
  "url": "https://mcp.bazhuayu.com",
  "headers": {
    "x-api-key": "你的APIKey"
  }
}

​
Cursor 示例（~/.cursor/mcp.json）

{
  "mcpServers": {
    "octoparse": {
      "type": "http",
      "url": "https://mcp.bazhuayu.com",
      "headers": {
        "x-api-key": "你的APIKey"
      }
    }
  }
}

​
Claude Code 示例（~/.claude/settings.json）

{
  "mcpServers": {
    "octoparse": {
      "type": "http",
      "url": "https://mcp.bazhuayu.com",
      "headers": {
        "x-api-key": "你的APIKey"
      }
    }
  }
}
保存后重启客户端，在 MCP 工具列表中应能看到八爪鱼相关工具。 更多客户端（ChatGPT、Gemini、OpenClaw、VS Code）见 客户端配置指南。

​
验证是否生效

连接成功后，可在对话中尝试：
  • 「用八爪鱼搜索一个采集新闻标题的模板」
  • 「列出我账户下的八爪鱼任务」
若返回 401 / 403，请检查 Key 是否有效、是否填在 x-api-key 字段，以及 URL 是否正确。

​
与各平台教程的关系

​
下一步

工作流程示例

从搜模板到导出数据的完整示例。

故障排查

授权失败、工具不可见等问题。