Skip to main content

何时使用 API Key

创建 API Key

1

登录并打开账号信息

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

进入 API 密钥并新增

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

自定义名称并生成

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

复制并妥善保存密钥

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

方式一:交给 Agent 自动配置(推荐)

WorkBuddy、QClaw、豆包专业版等能够管理工具配置的 Agent,可以自行选择当前客户端支持的配置方式、写入 MCP 设置并测试连接。将下面的内容发给 Agent,并把占位符替换为刚刚创建的 Key:
Agent 若要求确认写入配置文件、重启客户端或执行连接测试,可以在核对目标路径和命令后授权。若它尝试启动 OAuth,请提醒它严格使用 x-api-key 请求头。
仅在可信的本地 Agent 或私密对话中粘贴真实 Key。Agent 不具备配置权限或自动安装失败时,改用下面的手动配置。

方式二:手动配置

通用 HTTP MCP 配置

Cursor 示例(~/.cursor/mcp.json

Claude Code 示例(~/.claude/settings.json

保存后重启客户端,在 MCP 工具列表中应能看到八爪鱼相关工具。 更多客户端(ChatGPT、Gemini、OpenClaw、VS Code)见 客户端配置指南

验证是否生效

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

与各平台教程的关系

下一步

工作流程示例

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

故障排查

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