A Seo Mcp

@automatelab/ai-seo-mcp

面向 Model Context Protocol 的 AI 引用工具包

检查 AI 系统引用或不引用你页面的原因。 MCP 服务。无需 API 密钥。

可在 Claude、Cursor、Windsurf、Codex 以及任何使用 stdio 通信的 MCP 客户端中运行。

---

检查内容

• AI 爬虫访问权限 - 检查 robots.txt 中是否允许或屏蔽 GPTBot、OAI-SearchBot、ClaudeBot 和 PerplexityBot
• llms.txt - 检查文件是否存在、符合规范且链接有效
• 结构化答案提取 - 检查 FAQ 标题、BLUF 段落和适合直接回答的内容块
• [[schema]] 完整性 - 检查 FAQPage、Article、Organization、Person；标记已弃用的模式
• 实体清晰度 - 检查有助于 AI 系统识别主题的命名实体密度和 sameAs 覆盖情况
• 引用格式 - 检查规范 URL 的规范性、og:url、hreflang 和 noindex 陷阱
• 站点地图新鲜度 - 检查用于告知爬虫页面为最新内容的 lastmod 信号

---

运行审计。获取按优先级排列的引用障碍清单。

你： 对 https://automatelab.tech/launching-the-ai-seo-mcp/ 运行 AI-SEO 审计。

结果（已截断）：

{
  "url": "https://automatelab.tech/launching-the-ai-seo-mcp/",
  "score": 61,
  "grade": "C",
  "dimension_scores": {
    "schema": 45, "technical": 80, "structure": 40,
    "robots": 90, "freshness": 85, "authority": 40,
    "entity_density": 21, "sitemap": 100
  },
  "findings": [
    {
      "severity": "critical",
      "category": "structure",
      "message": "No FAQ structure found (no FAQPage schema or H3 question headings).",
      "fix": "Add FAQ H3 headings ending in '?' with answer paragraphs, and a FAQPage JSON-LD block.",
      "estimated_impact": "high"
    },
    {
      "severity": "warning",
      "category": "authority",
      "message": "Low authority signals - missing Organization or author Person schema.",
      "fix": "Add Organization JSON-LD and Article.author as a Person node with sameAs links.",
      "estimated_impact": "high"
    }
  ]
}

每条发现都指出确切的修复方法。没有不透明的评分，也无需猜测。

---

安装

npx -y @automatelab/ai-seo-mcp

需要 Node 20 或更高版本。

Claude Desktop

将以下内容添加到 %APPDATA%\Claude\claude_desktop_config.json（Windows）或 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）：

{
  "mcpServers": {
    "ai-seo": {
      "command": "npx",
      "args": ["-y", "@automatelab/ai-seo-mcp"]
    }
  }
}

重启 Claude Desktop。任何支持 stdio 传输的 MCP 客户端都能使用，采用相同的 command / args 模式。

可选：为 SPA 启用无头渲染

默认情况下，audit_page 会读取原始 HTML——速度快，但会遗漏 React/Vue/Angular SPA 中的内容。传入 render: "headless" 可启动 Chromium 并审计渲染后的 DOM（每次审计增加 3-10s）。

只需安装一次：

npm install playwright-core
npx playwright install chromium

然后调用 audit_page 并传入 render: "headless"。其他情况使用静态模式即可——大多数营销网站和文档无需无头渲染也能正常检查。

---

在 CI 中运行（GitHub Action）

此仓库也可用作 GitHub Action。将它加入工作流，即可在任何页面的 AI 引用评分低于阈值时阻止 PR 合并——使用相同的审计引擎，在每次更改时进行检查。

- uses: actions/checkout@v4
- name: AI-SEO audit
  uses: AutomateLab-tech/[email protected]
  with:
    urls: "https://example.com,https://example.com/pricing"
    min-score: "70"            # fail if any URL scores below this
    respect-robots: "true"     # set false for staging / sites you own
    report-path: "ai-seo-report.md"   # optional Markdown report artifact
    fail-on-regression: "true"

该 Action 会从固定的 ref 构建审计工具，对每个 URL 运行 audit_page，将评分卡写入作业摘要；如果任何 URL 的评分低于 min-score，且 fail-on-regression 为 true，则以非零状态码退出。输出：min_score_observed、urls_audited、report_path。完整示例：examples/github-action-usage.yml。

---

延伸阅读

• automatelab.tech - 拆解与案例研究

---

MCP 工具一览（20 个工具）

工具	用途
audit_page	综合 AI-SEO 审计，按 8 个维度评分（schema、技术、结构、robots、新鲜度、权威性、实体密度、sitemap）。
audit_schema	根据 Schema.org 规则和 AI 引用最佳实践验证 JSON-LD。标记已弃用的模式。
audit_canonical	检查规范链接完整性、尾部斜杠规范和 og:url 一致性。
audit_site	单次调用即可扫描网站：运行 audit_page、check_robots、check_sitemap 和 audit_schema，并返回总体评级和排名前 5 的修复项。
audit_sitemap	全站内容审计：从 sitemap 中按步长抽样 N 个 URL，对每个 URL 运行 audit_page，并返回分布情况、最差页面和主要发现。
check_robots	解析 robots.txt 并报告所有已知 AI 爬虫的允许/禁止规则。揭示 GPTBot 被屏蔽但 OAI-SearchBot 获准访问的陷阱。
check_sitemap	验证 XML sitemap：是否存在、URL 数量、lastmod 新鲜度，以及图片/视频扩展。
check_technical	审计 HEAD 标签：canonical、OpenGraph、Twitter Card、hreflang、HTTPS、noindex 和标题规范。
score_ai_overview_eligibility	使用当前相关性因素，评估页面出现在 Google AI Overviews 中的概率。
score_citation_worthiness	评估页面或文本块对 Perplexity、ChatGPT、Google AI Overviews 和 Claude 的引用价值。包含各部分的 chunk_analysis / extractability_score：评估大模型能否从各个标题下清晰提取独立答案。
score_agentic_browsing	根据 Lighthouse 的“Agentic Browsing”类别（2026 年 5 月）评估页面：llms.txt、WebMCP、无障碍树完整性和布局稳定性。
score_test_citation	通过 MCP 抽样模拟“AI 引擎是否会针对这个查询引用此内容？”，并在确定性启发式回退机制下运行。
llms_txt_generate	根据域名的 sitemap 生成 llms.txt，并可选择生成 llms-full.txt。
llms_txt_validate	检查现有 llms.txt 是否符合规范，以及是否存在失效链接。
rewrite_aeo	按答案引擎优化方式改写内容（BLUF 结构、FAQ 格式、schema 补充）。
rewrite_geo	按生成式引擎优化方式改写内容（实体定义、对比表格、便于综合整理的结构）。
extract_entities	从页面内容和结构化数据中提取命名实体、sameAs 链接和引用密度评分。
diff_pages	比较两个 URL 的 AI 引用价值：并排展示各维度评分、差距分析，以及针对 url_a 的优先级排序修复建议。
report_save	将 audit_page / audit_site 结果渲染为 Markdown 报告，并写入 MCP_WORKSPACE_ROOT 下的磁盘。

v0.4.0 将工具名称从扁平的 snake_case 重命名为点号分隔形式（audit_page、check_robots 等），以便构建可导航的层级结构。请更新已保存的调用。

环境变量：参见 ENV.md。

---

贡献

欢迎提交 Bug 报告、功能创意和 PR。请参见 CONTRIBUTING.md。

安全

如需报告漏洞，请参见 SECURITY.md。

许可证

MIT - 参见 LICENSE。

由 automatelab.tech 构建

维护与验证

请参见维护指南，了解解读限制、当前适用的工具名称，以及可复现的验证方法。