Agent Skills
返回列表
Ahrefs MCP 安装

Ahrefs MCP 安装

AI Agent 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_23833631/install-ahrefs-mcp-skill,为 WorkBuddy 配置 Ahrefs MCP 服务器。

技能介绍

这个技能解决什么问题

在 WorkBuddy 中接入 Ahrefs 远程 MCP 服务器(https://api.ahrefs.com/mcp/mcp)时,直接配成 type: "http" 模式并不能稳定弹出 OAuth 授权窗口——WorkBuddy 对自定义 MCP 服务器的 OAuth 流程支持不完整。这个技能改用本地 mcp-remote stdio 代理接管授权:自动打开浏览器让用户登录 Ahrefs 并点击 Allow,拿到的 token 缓存到 ~/.mcp-auth/,后续启动无需重复授权。

另一个实际坑是 Windows 上用 npx mcp-remote 会报 MCP error -32000: Connection closed,所以技能要求把 mcp-remote 本地安装,并以绝对路径调用 Node.js。

核心能力与关键步骤

  • 自动探测 Node.js:优先使用 WorkBuddy 自带的 Node.js,拿到可执行文件的绝对路径
  • 本地安装代理:把 mcp-remote@latest 安装到 ~/.workbuddy/binaries/node/workspace/
  • 写入配置:生成包含 Ahrefs 条目的 ~/.workbuddy/mcp.json,同时保留已有服务器配置

整体流程:运行 scripts/setup.py 自动完成上述三步;完全退出并重启 WorkBuddy;在 Connectors > Custom Connectors 中找到 ahrefs 并点击 Trust;在自动弹出的浏览器里完成登录与授权;最后开一个新对话,用 public-domain-rating-free 这类免费工具验证连通性。没有 Python 时,手动依次完成探测 Node、本地安装、写配置三件事也可以。

适用边界与注意点

  • 配置路径不能写错:要写 ~/.workbuddy/mcp.json(无点前缀),带点的 .mcp.json 是自动生成的,重启即被覆盖
  • 不要手动编辑 .mcp.json:它由 mcp.json 生成,改动等不到下次重启
  • 不要用 npx、不要走直接 HTTP 模式:前者在 Windows 上必现 Connection closed,后者 OAuth 弹窗根本不会出现
  • 会话内不生效:中途接入 Ahrefs 后,工具要等下一个新对话才出现
  • 账号门槛:Ahrefs 需 Lite 或更高套餐才开放 MCP 访问

常见故障的排查方案(Connection closed、连接器缺失、OAuth 失败、端口冲突等)整理在 references/troubleshooting.md。

使用场景

  • 在 WorkBuddy 里配置 Ahrefs MCP,直接写 http 模式不弹 OAuth 授权窗口,改用本地 mcp-remote 代理完成登录授权。
  • 在 Windows 上接入 Ahrefs,用 npx 启动 mcp-remote 报 Connection closed,需改成本地安装并用绝对 node 路径。
  • 已安装 Ahrefs 连接器,重启后在新对话里调用 public-domain-rating-free 查询域名评分,验证 MCP 是否连通。
  • 既有其他服务器配置,要在 ~/.workbuddy/mcp.json 追加 Ahrefs 条目且不覆盖已有内容。

适合人员

  • 负责在 WorkBuddy 中集成第三方 MCP 服务的开发者,需要在 Windows 环境下避开 npx 与 OAuth 弹窗的坑。
  • 日常用 Ahrefs 做竞品与关键词分析的 SEO 工程师,想让 Agent 在 WorkBuddy 内直接调用 Ahrefs 工具。
  • 维护团队 WorkBuddy 配置的基础设施同学,需要可复现、不覆盖现有服务器的 Ahrefs 接入流程。