SEO Perception

SEO Perception MCP

在 Cursor、Claude、VS Code 和其他 MCP 客户端中使用 Search Console、网站抓取结果和 SEO 待办事项。

文档 · 网站 · MCP 注册表

---

此仓库在 MCP 目录中列出了托管的 SEO Perception MCP 服务。仓库仅包含文档和客户端配置。无需在本地安装或运行任何内容：服务运行于 https://seoperception.com/mcp。

SEO Perception 会存储每周的 Google Search Console 数据、网站抓取结果，以及按优先级排列的可能性事项（针对每个 URL 的修复清单）。MCP 服务让你的 AI 助手能够读取同一工作区，并根据存储的证据为页面起草下一次修改，而不是凭空猜测。

概览

端点	https://seoperception.com/mcp
传输方式	Streamable HTTP（纯 JSON 响应）
身份验证	OAuth 2.1，使用动态客户端注册和 PKCE；或使用个人访问令牌，格式为 Authorization: Bearer <token>
权限范围	mcp:read（始终启用）。mcp:possibilities（可选：将现有待办事项标记为已完成或忽略）
工具	10 个。其中 9 个读取存储的数据。获授该权限范围后，其中 1 个可关闭可能性事项。
MCP 注册表名称	com.seoperception/mcp
服务卡片	/.well-known/mcp/server-card.json

套餐

从 7 天 Starter 试用期开始（包含 MCP）。试用期结束后，OAuth、个人令牌和 MCP 端点都需要有效的 Starter、Pro、Business 或 Enterprise 套餐。请参阅定价。

工具

9 个工具可读取 SEO Perception 已收集的数据。它们不会实时调用 Google。seoperception_update_possibilities 是唯一的写入工具：只有当连接包含 mcp:possibilities 时，它才会将现有的 Possibilities 标记为已完成或已忽略。只有 mcp:read 的连接无法更改任何内容。通过 OAuth 连接时会同时请求这两个权限范围。只有在创建个人令牌时启用相应选项，才能用它关闭 Possibilities。已创建的令牌仍为只读。

工具	标题	功能
seoperception_list_sites	列出网站	列出已拥有的网站及其存储的 GSC 和抓取数据新鲜度。
seoperception_get_site_overview	网站概览	汇总存储的搜索表现、主要页面、查询和排名趋势。
seoperception_search_queries	搜索查询	按内容匹配、排名区间、展示次数、落地页、CTR 和意图搜索并筛选存储的查询证据。
seoperception_list_opportunities	SEO 机会	列出存储的 Possibilities。可按状态、问题类型或 URL 筛选，也可以请求按类型分组的摘要。
seoperception_update_possibilities	关闭 Possibilities	按 ID、问题类型或 URL 将现有的 Possibilities 标记为已完成或已忽略。需要 mcp:possibilities。忽略时需要提供原因。
seoperception_get_page_diagnostics	页面诊断	合并单个页面的抓取元数据、存储的 GSC 趋势、热门查询和 Possibilities。
seoperception_find_content_gaps	内容和摘要缺口	查找存储的低 CTR、缺失查询、标题／摘要、问题和内容更新机会。
seoperception_find_content_decay	内容衰退	根据待更新候选行中的存储数据，检测点击次数和排名的持续下降。
seoperception_find_cannibalization	关键词蚕食	查找存储的查询冲突和确定性的首选页面。
seoperception_suggest_internal_links	内部链接建议	返回存储的目标页面和锚文本机会，不会抓取或探测 URL。

大多数工具都需要 siteId。先让助手列出你的网站，它就会自动获取该值。

设置

支持 OAuth 的客户端会在首次连接时打开浏览器登录，无需令牌。

如果你的客户端不支持 OAuth，请登录 SEO Perception，打开 Account > MCP，创建个人访问令牌（令牌仅显示一次），并将其存储为环境变量 SEOPERCEPTION_MCP_TOKEN。然后使用配置中的“token”变体。

Cursor

从 Cursor Marketplace 安装 SEO Perception 插件（上架后），或将以下内容添加到 ~/.cursor/mcp.json（所有项目）或 .cursor/mcp.json（单个项目）：

{
  "mcpServers": {
    "seo-perception": {
      "url": "https://seoperception.com/mcp"
    }
  }
}

Cursor 会显示该服务的登录提示。令牌变体：

{
  "mcpServers": {
    "seo-perception": {
      "url": "https://seoperception.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:SEOPERCEPTION_MCP_TOKEN}"
      }
    }
  }
}

Claude.ai 和 Claude Desktop（连接器）

1. 打开 Settings > Connectors。
2. 选择 Add custom connector。
3. 名称：SEO Perception。URL：https://seoperception.com/mcp。
4. 点击 Add，然后点击 Connect 并批准 SEO Perception 登录。

自定义连接器是否可用取决于你的 Claude 套餐。

Claude Code

claude mcp add --transport http seo-perception https://seoperception.com/mcp

然后在 Claude Code 中运行 /mcp 并选择 Authenticate。

VS Code（GitHub Copilot Agent 模式）

将以下内容添加到项目中的 .vscode/mcp.json，或者从命令面板运行 MCP: Add Server 并选择 HTTP：

{
  "servers": {
    "seo-perception": {
      "type": "http",
      "url": "https://seoperception.com/mcp"
    }
  }
}

服务首次连接时，VS Code 会启动 OAuth 登录。

Windsurf（Devin Desktop）

将以下内容添加到 mcp_config.json（当前版本位于 ~/.config/devin/mcp_config.json，较旧的 Windsurf 版本位于 ~/.codeium/windsurf/mcp_config.json）：

{
  "mcpServers": {
    "seo-perception": {
      "url": "https://seoperception.com/mcp"
    }
  }
}

当服务显示 Needs auth 时登录，或使用带有 headers 块的令牌变体，如 Cursor 示例所示。

Cline

在 Cline 面板中打开 MCP Servers > Remote Servers，输入名称 seo-perception、URL https://seoperception.com/mcp，传输方式选择 Streamable HTTP，然后点击 Add Server。或者编辑 cline_mcp_settings.json：

{
  "mcpServers": {
    "seo-perception": {
      "type": "streamableHttp",
      "url": "https://seoperception.com/mcp",
      "disabled": false,
      "autoApprove": []
    }
  }
}

明确设置 "type": "streamableHttp"；否则 Cline 会回退到旧版 SSE 传输方式。请参阅 llms-install.md，了解 Agent 可以遵循的分步说明。

Lovable

1. 打开 Connectors，点击 +，选择 MCP server。
2. 服务器名称：SEO Perception。URL：https://seoperception.com/mcp。
3. 保持选择 OAuth，点击 Add & authorize，然后批准登录。

其他 MCP 客户端

URL:            https://seoperception.com/mcp
Transport:      Streamable HTTP
Authorization:  OAuth 2.1 (discovered via WWW-Authenticate), or Bearer <your MCP token>

示例提示词

• “列出我的 SEO Perception 网站，并告诉我哪些数据是最新的。”
• “使用已存储的数据，总结我网站最明显的增长和下滑。”
• “显示优先级最高的待处理 SEO 机会，并说明依据。”
• “使用 SEO Perception 找出 /pricing 上下滑最严重的关键词，并建议具体的内容修改方案来挽回排名。”
• “找出排名在 5 到 20 位、展示次数至少为 50，且未出现在对应落地页上的非品牌查询。”
• “找出关键词蚕食问题，并建议优先展示哪个页面。”
• “找出最大的内容和摘要差距，然后建议改写内容，以匹配排名下滑的关键词。”
• “为有排名潜力的页面推荐内链和自然的锚文本。”
• “哪些页面出现了明显的内容衰退？”
• “将第 42 项可能性标记为已完成，前提是草稿已经保存在文件中。”

安全与数据边界

• 仅限你的网站。 每个工具仅限访问已登录账户中的网站。
• 仅有一项可选写入操作。 关闭一项可能性不会编辑网站、调用 Google 或启动重新爬取。下一次爬取时，“已完成”状态可能会恢复。忽略操作是永久性的，且必须提供原因。按问题类型或 URL 批量更改时，会先显示预览，直到确认后才会生效；一次最多关闭 25 行。
• 不进行实时 Google 调用。 工具读取的是 SEO Perception 已存储的每周 Search Console 数据、爬取数据和优先处理的问题列表。数据收集在产品自身的同步过程中进行，而不是在工具调用中进行。
• 权限范围。 必须具有 mcp:read 权限。mcp:possibilities 为可选权限，可用于关闭待办事项。OAuth 连接请求会同时申请这两种权限。如果编辑器需要能够关闭待办事项，请在授权页面允许这两种权限。仅请求 mcp:read 的客户端保持只读。个人令牌默认保持只读，除非你在创建令牌时启用关闭操作。
• 使用令牌，而非密码。 切勿将登录密码或会话 Cookie 放入 MCP 配置中。请在 Account > MCP 下创建和撤销个人访问令牌。
• 客户端的模型提供商。 MCP 客户端可能会将返回的结果发送给其模型提供商。请将这些结果视为敏感的网站分析数据。

故障排查

• 401：重新登录，或在 Account > MCP 下创建新令牌，并更新 SEOPERCEPTION_MCP_TOKEN。
• 403 paid_plan_required：MCP 需要包含此功能的套餐（参见上文的 Plan）。
• 429：等待响应中指定的重试时间。
• 列表为空：通常表示该网站尚无已存储的数据。

链接

• 文档和设置：https://seoperception.com/mcp-integration
• 网站：https://seoperception.com
• 定价：https://seoperception.com/pricing
• 隐私：https://seoperception.com/privacy
• 支持：https://seoperception.com/contact
• 服务卡片：https://seoperception.com/.well-known/mcp/server-card.json
• 官方 MCP Registry：com.seoperception/mcp

关于此仓库

此仓库仅包含列表元数据（README、server.json、glama.json、llms-install.md、Cursor 插件清单、徽标）。SEO Perception 应用和 MCP 服务的源代码不是开源的，也不属于此仓库。

由 Larsik Corp（Lars Koudal）制作。文档和配置文件依据 MIT 许可证发布。“SEO Perception”和徽标是 Larsik Corp 的商标。Google 和 Search Console 是 Google LLC 的商标；SEO Perception 与 Google 无关联，也未获其认可。