Creator SEO MCP

creator-seo-mcp

一款面向内容创作者的 MCP 服务，可将 Google Search Console 与页面内容相连，并根据预估收入为每个 SEO 机会排序，而非追逐虚荣点击量。

通用 SEO 工具只会展示原始 GSC 数据。这个工具会根据你实际的展示广告 RPM 和联盟佣金率，告诉你哪项改进最有价值。

功能介绍

六种工具，可协同完成创作者 SEO 工作流：

工具	描述
get_striking_distance_keywords	查询排名在第 4 至第 15 位且实际展示量可观的关键词，并提供对应排名页面和与首页的差距
get_page_performance	查看单个 URL 的完整 GSC 数据：点击量、展示量、CTR、排名，以及带来这些数据的查询
analyze_content_decay	标记点击量或展示量逐月下降的页面
audit_page_onpage	获取 URL，读取标题、meta、标题层级和正文，与目标查询进行比较，并提出具体修改建议
find_cannibalization	检测多个页面相互竞争、分散权重的查询
get_top_opportunities	核心工具：综合所有信号，按收入加权，并返回一份排序后的行动清单

安装

uvx creator-seo-mcp

或使用 pip 安装：

pip install creator-seo-mcp

设置

1. Google Search Console 凭据

按照 docs/gsc-setup.md 中的说明：

• 在 Google Cloud 中启用 Search Console API
• 创建 OAuth 2.0 Desktop 客户端
• 下载 credentials.json

2. Claude Desktop 配置

添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "creator-seo-mcp": {
      "command": "uvx",
      "args": ["creator-seo-mcp"],
      "env": {
        "GOOGLE_CREDENTIALS_PATH": "/path/to/credentials.json",
        "CREATOR_SEO_SITE_RPM": "15"
      }
    }
  }
}

3. Claude Code 配置

claude mcp add creator-seo-mcp uvx creator-seo-mcp \
  -e GOOGLE_CREDENTIALS_PATH=/path/to/credentials.json \
  -e CREATOR_SEO_SITE_RPM=15

4. 收入配置（可选，但建议设置）

设置你的展示广告 RPM，让机会按实际收入排序：

export CREATOR_SEO_SITE_RPM=22          # your Mediavine/Raptive RPM
export CREATOR_SEO_AFFILIATE_CATEGORIES='{"gaming-deals": 2.0}'

所有选项请参见 .env.example。

Agent 提示词示例

• “展示本周按收入加权的五大 SEO 机会。”
• “与上个月相比，我的哪些文章流量正在下降？”
• “我的《博德之门 3》配装指南一直排在第 2 页。请根据其主要关键词进行审查，并告诉我该如何改进。”
• “找出哪些文章因同一个搜索词而相互竞争。”
• “这篇文章与其试图获得排名的查询之间，页面优化方面有哪些差距？”

Two Average Gamers 案例研究

get_top_opportunities 的真实输出：于 2026-08-25 对 Two Average Gamers 实时运行。该网站是 Mediavine 展示广告和 Amazon 联盟链接支持的顶级 200 游戏博客，统计过去 28 天的数据（根据 Search Console，共 392K 次展示、3.5K 次点击）。

这是实际的「优化前」基线，而非示例。美元估算使用默认的 $15 RPM 占位值（将 CREATOR_SEO_SITE_RPM 设为你实际的广告网络 RPM，即可获得准确数据）。在三类信号共计 147 个评分机会中，按预估收入排名前 5 的机会如下：

#	类型	页面	查询	发现
1	接近首页	best-letterboxd-alternatives...	"letterboxd for games"	排名 4.6，97K 次展示，与首页相差 1.6 位
2	关键词蚕食	同一页面 + 其他 3 个页面	"letterboxd for games"	4 个 TAG 页面在同一查询上瓜分 99.8K 次展示
3	接近首页	backloggd-review	"backloggd"	排名 5.5，11.4K 次展示，与首页相差 2.5 位
4	关键词蚕食	同一页面 + 其他 2 个页面	"backloggd"	3 个 TAG 页面在同一查询上瓜分 15.1K 次展示
5	接近首页	backloggd-vs-gg-vs-savepoint	"backloggd"	排名 5.5，3.7K 次展示，与首页相差 2.5 位

本次运行中，analyze_content_decay 还标记出 40 个环比点击量下降的页面。表现最差的是一篇 Palworld 诉讼文章，点击量下降了 100%（从 10 次降至 0 次）；其次是一篇 Palworld 塔楼 Boss 攻略，点击量下降了 61%。这些内容都值得在已有流量彻底消失前更新。

更新（2026-08-25）： 上述两个接近首页机会对应的标题和 H1 修改已上线。对实际页面重新运行 audit_page_onpage 后确认如下：

页面	目标查询	标题中包含？	H1 中包含？	剩余建议
best-letterboxd-alternatives...	"letterboxd for games"	✅	✅	无
backloggd-review	"backloggd"	✅	✅	无
backloggd-vs-gg-vs-savepoint	"backloggd"	✅	✅	无

目前还没有可报告的排名或流量变化，这符合预期，并非没有结果：Search Console 数据存在 2-3 天的更新延迟，因此同一天重新拉取的数据仍覆盖与上述原始基线相同的 2026-07-26 至 2026-08-22 时间段，当时这些修改尚未实施。Google 还需要重新抓取页面并调整排名，这通常比原始数据延迟所需的时间更长。等 GSC 拉取的数据实际覆盖修改后的时段（预计还需 2-3 周），并能提供实际排名和点击量变化后，我们会再次更新本节；在此之前不会更新。

参与贡献

欢迎提交问题和 PR。请参阅 CONTRIBUTING.md 了解指南。

许可证

MIT