SurfRank MCP 服务器

让你的 AI 代理直接从聊天窗口在 SurfRank 上运行 AI 可见性报告、研究关键词并跟踪竞争对手。

此包将 SurfRank 公共 API 公开为 Model Context Protocol (MCP) 工具，因此任何兼容 MCP 的 AI 助手（如 Claude Desktop、Claude Code、Cursor、Windsurf、ChatGPT MCP 连接器等）都可以代表你调用 SurfRank。

什么是 SurfRank？

SurfRank 用于衡量你的品牌在 AI 回答（ChatGPT、Perplexity、Gemini、Claude、Grok、DeepSeek、Meta AI）中的可见度。它针对每个引擎运行你跟踪的关键词，根据竞争对手对你的提及进行评分，并挖掘出能带来显著效果的内容机会。

Related MCP server: DataForSEO MCP Server

什么是 MCP？

Model Context Protocol 是 Anthropic 推出的开放标准，允许 AI 代理发现并调用外部工具。安装此服务器一次，你的代理即可获得 24 项新能力——无需插件 API，无需复杂的 OAuth 流程，也无需胶水代码。

连接后你可以要求代理做什么

💬 “为 SaaS 行业的 surfrank.ai 创建一个 SurfRank 项目，然后跟踪这 10 个关键词……”

💬 “我最新的 AI 可见性报告显示了什么？哪些引擎没有显示我的品牌？”

💬 “为 competitor.com 运行一次快速测试，并将其与我的分数进行比较。”

💬 “列出我前 5 名的内容机会，并为影响力最大的那些起草文章。”

代理会选择正确的工具，使用你的密钥调用 SurfRank API，并以自然语言回复。积分将以与直接 API 调用相同的费率从你的 SurfRank 账户中扣除。

要求

• Node.js 18 或更高版本（MCP SDK 所需）。

• 按需付费 (Pay As You Go) 计划下的 SurfRank API 密钥。请在 app.surfrank.ai/api-management 生成。

• 兼容 MCP 的客户端（请参阅配置部分）。

安装

使用 npx 临时运行——无需安装：

npx -y @surfrank/mcp-server

或者全局安装：

npm install -g @surfrank/mcp-server

配置

在下方选择你的客户端，并将代码片段粘贴到其 MCP 配置文件中。

Claude Desktop

编辑你的 Claude Desktop 配置文件：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "surfrank": {
      "command": "npx",
      "args": ["-y", "@surfrank/mcp-server"],
      "env": {
        "SURFRANK_API_KEY": "sr_your_key_here"
      }
    }
  }
}

重启 Claude Desktop。你应该会在 MCP 服务器菜单中看到 surfrank。

Cursor

编辑 ~/.cursor/mcp.json（或使用 设置 → MCP → 添加服务器）：

{
  "mcpServers": {
    "surfrank": {
      "command": "npx",
      "args": ["-y", "@surfrank/mcp-server"],
      "env": {
        "SURFRANK_API_KEY": "sr_your_key_here"
      }
    }
  }
}

Claude Code

claude mcp add surfrank -- npx -y @surfrank/mcp-server
export SURFRANK_API_KEY=sr_your_key_here

Windsurf

编辑 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "surfrank": {
      "command": "npx",
      "args": ["-y", "@surfrank/mcp-server"],
      "env": { "SURFRANK_API_KEY": "sr_your_key_here" }
    }
  }
}

可用工具

该服务器将每个 SurfRank 公共 API 端点公开为一个工具（总共 24 个）。你的代理会自动发现它们——你无需在提示词中列出它们。

每个工具都与 https://api.surfrank.ai/api/v1/public/* 下的 REST 端点一一对应。

作用域 API 密钥

如果你生成了项目作用域的 API 密钥，MCP 服务器将只能在该项目上运行。任何引用不同项目 ID 的工具调用都会被 SurfRank API 拒绝并返回 403，错误信息会原样显示在代理的回复中。

当你将单个工作区或团队成员连接到单个品牌时，这是推荐的设置。

积分使用

积分扣除标准与直接 API 调用相同：

每个工具响应都包含一个 credits 对象，以便你的代理（和你）可以实时跟踪使用情况。

环境变量

调试

使用官方 MCP 检查器直接探测服务器——在接入新客户端或诊断连接问题时非常有用：

SURFRANK_API_KEY=sr_your_key_here \
  npx @modelcontextprotocol/inspector npx @surfrank/mcp-server

检查器会打开一个浏览器 UI，你可以在其中列出工具并手动调用它们，就像 AI 代理所做的那样。

安全说明

• API 密钥在创建时仅显示一次，并以 SHA-256 哈希形式存储在 SurfRank 的服务器上。如果你丢失了密钥，请撤销并重新生成——它无法恢复。

• 凭据保留在你的本地 MCP 配置文件中。此包绝不会将它们写入磁盘，也绝不会向外发送。

• 每个 API 密钥的速率限制为 每分钟 60 次请求。超过限制将返回 HTTP 429。

链接

• 🌐 SurfRank — surfrank.ai

• 🔑 API 管理 — app.surfrank.ai/api-management

• 📘 公共 API 文档 — 在 API 管理 → 文档选项卡中

• 🐛 问题反馈 — github.com/SurfRankAI/mcp-server/issues

• 📦 npm — @surfrank/mcp-server

许可证

MIT © SurfRank Pte. Ltd. — 请参阅 LICENSE。