Seo Performance Mcp

seo-performance-mcp

无需猜测，即可知道哪些博客文章需要更新、扩展、合并或删除。

一个 MCP 服务，可将分散在各处的 SEO 和分析数据整合起来，为每个 URL 给出明确结论。将它接入 Claude、Cursor 或任何支持 MCP 的客户端，然后询问：“这周我应该更新哪三篇文章？”——即可获得有数据支撑的答案。

功能介绍

seo-performance-mcp 会整合你已经在使用的各个渠道中的发布后信号：

• Google Search Console - 点击次数、展示次数、点击率、排名、热门查询
• Matomo 或 GA4 - 访问量、停留时间、跳出率
• Microsoft Clarity - 滚动深度、愤怒点击、无效点击
• AI 引用追踪 - 今天与上个月相比，哪些 LLM 引用了你的 URL
• 站点地图 / CMS - 发布日期、标签、字数（通过 XML 站点地图支持任何平台；还可选接入 Ghost，以获取更丰富的元数据）

随后，它会针对这些信号运行确定性规则引擎，并为每个 URL 输出结论：

refresh / expand / merge / kill / double_down / hold

同时提供原因代码、证据和 0-1 的置信度评分。仅用于报告——此服务不会修改你的文章。

重要性

大多数内容团队要在五个分析页面中查看数据，还要凭直觉判断。因此，优质文章会悄悄失去价值，平庸的文章却得到过度推广，而明显“应该重写这篇”的文章，往往要等到流量已经暴跌后才被发现。

这个 MCP 能闭合反馈环路：

• 提出一个问题，输入一个 URL，获得一个结论。
• 对整个内容群组使用相同逻辑，因此排名具有可比性。
• 所有决策都可追溯至 src/verdict/rules.ts 中设定的数值阈值。
• AI 客户端（Claude、Cursor、MCP 宿主）可用日常语言驱动完整的内容审查。

适用对象

• 内容营销人员：运营着 50 篇以上博客文章，并且不想再凭猜测决定更新哪些内容。
• SEO 顾问：开展审查时，希望使用可移植、确定性的评分层，而不是定制电子表格。
• AI 优先的内容团队：正在连接重写 Agent——这个 MCP 就是上游信号层。
• 独立出版商：使用 Ghost、WordPress、Hugo、Astro、Next、Webflow，或任何可提供站点地图的 CMS。

你将获得

运行一次内容群组分析后，你将获得：

• 一张包含所有文章的排名表，并附有结论和置信度评分。
• 每个“refresh” URL 对应一份 Markdown 简报：数据 + 热门查询 + 编辑（或写作 Agent）可立即执行的建议操作。
• 一份“快速见效机会”清单：排名在 5-15 位、点击率低于预期的查询——这是该网站中最快能通过重写标题见效的机会。
• 一份历史 AI 引用对比：哪些 LLM 曾引用你，后来又停止引用。

安装

npx -y @automatelab/seo-performance-mcp

在 Claude、Claude Code 或 Cursor 的 MCP 配置中：

{
  "mcpServers": {
    "seo-performance": {
      "command": "npx",
      "args": ["-y", "@automatelab/seo-performance-mcp"],
      "env": {
        "POSTS_SITEMAP_URL": "https://example.com/sitemap.xml",
        "GSC_SERVICE_ACCOUNT_JSON": "<base64-encoded service-account JSON>",
        "GSC_SITE_URL": "sc-domain:example.com",
        "MATOMO_URL": "https://example.com/analytics",
        "MATOMO_TOKEN": "...",
        "MATOMO_SITE_ID": "1",
        "GA4_PROPERTY_ID": "123456789",
        "GA4_SERVICE_ACCOUNT_JSON": "<base64-encoded service-account JSON>",
        "CLARITY_PROJECT_ID": "...",
        "CLARITY_API_TOKEN": "...",
        "CITATION_INTELLIGENCE_URL": "https://citation.example.com"
      }
    }
  }
}

所有环境变量均为可选项。缺少环境配置的适配器会跳过对应的数据切片；服务仍会启动。结论引擎会根据现有的数据切片运行。

平台集成

将它指向任意网站即可，无需 CMS 插件。文章发现层按以下优先级进行解析：

1. POSTS_LIST - {url, title?, published_at?, tags?, word_count?} 的 JSON 数组。如果你已有内容索引并希望精确控制，请使用此项。
2. Ghost Admin API - 如果同时设置了 GHOST_ADMIN_API_URL 和 GHOST_ADMIN_API_KEY，则会使用 Ghost 作为更丰富的元数据来源。可选。
3. HTML 提取 - 实时读取每个 URL 中的 og:title、article:published_time 和 JSON-LD datePublished。
4. XML 站点地图 - 将 POSTS_SITEMAP_URL 设置为你的站点地图（或站点地图索引），服务便会从 <loc> 和 <lastmod> 枚举文章。

大多数用户只需设置 POSTS_SITEMAP_URL。WordPress、Hugo、Astro、Next.js、Webflow、Framer、Wix、Squarespace、Notion-as-a-site 和 Substack 镜像站点默认都提供站点地图。

要添加全新平台：无需编写任何内容——只需将 POSTS_SITEMAP_URL 指向该平台即可。

提供的工具

工具	返回内容
posts_list	来自站点地图、Ghost 或你的 POSTS_LIST 的帖子列表，包含 {url, title, age_days, tags}。
posts_snapshot	按 URL 汇总 30/60/90 天窗口的数据：GSC + Matomo + GA4 + Clarity + 引用 + 元数据。
posts_decay_curve	每周 GSC 点击量/展示量/排名区间 + decay/plateau/growth 趋势标签。
posts_verdict	评估结果（refresh/expand/merge/kill/double_down/hold）+ 原因代码 + 0-1 置信度。
posts_refresh_brief	提供给人工或下游大模型编辑器的 Markdown 简报：数据、热门查询、建议操作。
cohort_report	按优先级排序的队列评估结果表 + 置信度。“这周应该刷新哪三篇帖子？”
posts_cite_loss	给定 URL 流失的大模型引用。需要 CITATION_INTELLIGENCE_URL。
gsc_quick_wins	处于第 5-15 位且点击率较低的 (page, query) 对，是最快见效的标题改写机会。

用作 GitHub Action

通过 CI 按计划运行任意工具，并将输出发布到 GitHub Issue、Discussion 或 PR。此 Action 已发布到 GitHub Marketplace。

- uses: AutomateLab-tech/seo-performance-mcp@v1
  with:
    tool: cohort_report
    format: markdown
    input: '{"window": 90, "min_age_days": 90, "limit": 20}'
    gsc-service-account-json: ${{ secrets.GSC_SERVICE_ACCOUNT_JSON }}
    gsc-site-url: ${{ secrets.GSC_SITE_URL }}
    posts-sitemap-url: ${{ secrets.POSTS_SITEMAP_URL }}

输出：

输出项	说明
result	工具输出的多行字符串（根据 format，内容为 markdown 或 JSON）。
result-file	写入工具输出的文件路径。可交给 peter-evans/create-issue-from-file 等工具处理。
rows	仅当 cohort_report 使用 format: json 时返回：返回的行数。

examples/weekly-cohort-report.yml 中提供了一个完整的每周审计工作流，可创建包含队列报告的 GitHub Issue。

用作一次性命令行工具

此软件包还附带一个 seo-perf-cli 可执行文件，无需 MCP 客户端即可运行单个工具：

npx -p @automatelab/seo-performance-mcp seo-perf-cli cohort_report \
  --input '{"window": 90, "limit": 20}' \
  --format markdown

环境变量与 MCP 服务相同。cohort_report 和 posts_refresh_brief 支持 --format markdown；其他工具会回退为带围栏的 JSON。

配套技能 + Cursor 规则

仓库中附带了三个轻量路由文件，让客户端中的大模型知道何时调用这些工具：

• skills/seo-performance/SKILL.md - 工具路由技能。放入 ~/.claude/skills/seo-performance/（或按项目放入 .claude/skills/），即可在 Claude Code 中自动加载。将单个问题路由到合适的工具。
• skills/weekly-audit/SKILL.md - 一次性每周审计手册。将 gsc_quick_wins + cohort_report + posts_cite_loss 组合为去重的跨信号排序摘要，并为每个 URL 提出编辑建议。与路由技能一同放置。
• cursor/rules/seo-performance.mdc - 复制到任意 Cursor 工作区中的 .cursor/rules/seo-performance.mdc。

均为可选项。MCP 服务无需这些文件也能运行；它们只是缩短“该调用哪个工具”的往返过程。

MCP 提示词

此服务提供三个提示词，用于组合调用手册中的工具。任何 MCP 客户端（Claude Desktop、Claude Code、Cursor、Continue）都可以列出并调用它们：

提示词	执行内容
audit_cohort	对发布满 90 天的帖子运行 cohort_report，然后对每条需要刷新/扩展/合并的记录运行 posts_refresh_brief。即每周审计。
find_quick_wins	运行 gsc_quick_wins（第 5-15 位）+ 对每个 URL 运行 posts_snapshot，然后提出基于原样查询的 meta_title 改写建议。
citation_loss_sweep	对每个 URL 运行 posts_cite_loss，对有流失的帖子生成 refresh_brief，并给出有针对性的 H1/导语措辞建议。

评估引擎

确定性、基于规则且可追溯。原因代码：

• ctr_below_position_expected
• position_drift
• decay_30d_over_30pct / decay_60d_over_50pct
• stagnant_no_clicks
• thin_content_low_dwell
• rising_impressions_low_ctr / rising_clicks_continue_investment
• citation_loss / citation_growth
• duplicate_or_cannibalizing
• high_bounce_low_scroll
• fresh_post_too_young

映射关系（原因 → 评估结果）及所有阈值均位于 src/verdict/rules.ts 中。可编辑该文件，在测试中固定规则，并发布你自己的规则手册。

开发

npm install
npm run dev        # tsx src/index.ts
npm run build      # tsc
npm test           # vitest

许可证

MIT

维护与验证

有关解读限制、适用情况下的当前工具名称以及可复现的验证，请参阅维护指南。