JinDaGe - stobo-mcp MCP Details

article

README

🚀 Stobo MCP Server

Stobo MCP Server 可从 Claude Desktop 对任意网站进行 SEO、AEO 和 E-E-A-T 审计，提供结构化的修复简报，开发人员可直接将其导入 Claude Code、Cursor 或 VS Code 中并开始修复工作。

🚀 快速开始

审计示例

You: stobo this site: example.com

Claude: I just received a complete audit for example.com. SEO, AEO, EEAT,
per-page breakdowns, 30+ checks with scores and details.

Want me to generate a fix brief you can download and drop into
Claude Code, Cursor, or hand off to your developer?

✨ 主要特性

为何不使用 web_fetch

手动抓取每个页面在 16 次以上的调用中大约需要 386,000 个令牌，并且仍然会遗漏核心网页指标、首字节时间和弗莱施-金凯德可读性指数。这些指标需要服务器端计算。而 Stobo 只需一次调用即可完成所有操作。

| | 手动 (web_fetch) | Stobo MCP | | --- | --- | --- | | audit_site | 71,000 令牌 · 6 次抓取 | 20,000 令牌 · 1 次调用 | | audit_freshness | 60,000 令牌 · 20 次抓取 | 3,000 令牌 · 1 次调用 | | generate_llms_txt | 35,000 令牌 · 6 次抓取 | 3,000 令牌 · 1 次调用 | | extract_tone | 35,000 令牌 · 10 次抓取 | 5,000 令牌 · 1 次调用 | | 完整套件 | 264,500 令牌 · 56 次抓取 | 47,000 令牌 · 9 次调用 |

使用 Stobo MCP 可减少 82% 的令牌使用量，并且能获取 Claude 仅从原始 HTML 无法计算的指标。

审计后的操作

Claude 会收到 30 多项关于 SEO、AEO 和 E-E-A-T 的评分检查，然后提供一个修复简报：结构化的 Markdown 文件，包含每个未通过的检查，按影响程度排序，并提供具体的修复说明。可将其粘贴到 Claude Code、Cursor 或 VS Code 中开始修复。

Claude 还提供快速修复的生成器。例如，如果 robots.txt 未通过检查，Claude 会生成一个新的。对于 llms.txt、站点地图和新鲜度代码也是如此。审计到修复的循环在单个对话中完成。

📦 安装指南

使用 pip 安装

pip install stobo-mcp

使用 uvx 安装

uvx stobo-mcp

💻 使用示例

工具使用

免费工具（无需 API 密钥）

| 对 Claude 说 | 功能 | 工具 | | --- | --- | --- | | "Stobo this site: example.com" | 对整个网站进行 30 项 SEO + 7 项 AEO 检查 + E-E-A-T + 博客检测 | audit_site | | "Audit this article: example.com/blog/post" | 对单篇文章进行 7 项 SEO + 14 项 AEO 检查 | audit_article | | "Generate a fix brief" | 根据已完成的审计生成结构化的 Markdown 修复简报，包含编号任务、优先级顺序和修复说明，可直接用于 IDE | generate_fix_brief | | "Check freshness across example.com/sitemap.xml" | 扫描站点地图中的 datePublished 和 dateModified 覆盖情况 | audit_freshness | | "Generate a robots.txt for example.com" | 生成对 AI 爬虫友好的 robots.txt，涵盖所有 21 种主要爬虫 | generate_robots_txt | | "Generate a sitemap for example.com" | 通过广度优先搜索爬取最多 200 个 URL 并返回 sitemap.xml | generate_sitemap | | "Generate freshness code for example.com/blog/post" | 生成包含 datePublished 和 dateModified 的 JSON-LD 代码片段 | generate_freshness_code | | "Check connection" | 诊断连接情况，还会告知是否有更新的 MCP 版本可用 | check_connection |

高级工具（即将推出）

| 对 Claude 说 | 功能 | 工具 | | --- | --- | --- | | "Generate llms.txt for example.com" | 爬取网站并返回符合规范的 llms.txt | generate_llms_txt | | "Extract brand voice from example.com/blog" | 分析最多 10 篇文章并创建持久的语气配置文件 | extract_tone | | "Rewrite this article: example.com/blog/post" | 在一个流程中完成审计 + 语气匹配 + 全文重写 | rewrite_article | | "Audit the UX of example.com" | 对网站进行 50 多项 UX 检查，包括可访问性、表单、排版和导航 | audit_ux | | "How many credits do I have?" | 查看信用余额和使用明细 | get_credits |

路由规则

域名或主页 → audit_site
博客文章或文章 URL → audit_article
任何审计完成后 → Claude 会自动提供 generate_fix_brief

📚 详细文档

配置设置

将以下内容添加到 Claude Desktop 配置文件中： macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "stobo": {
      "command": "stobo-mcp",
      "env": {
        "STOBO_API_KEY": "your-api-key",
        "STOBO_BASE_URL": "https://api.trystobo.com"
      }
    }
  }
}

STOBO_API_KEY 是可选的，没有它，每个审计和修复简报工具都能正常工作。高级工具的 API 密钥支持即将推出。完整的设置指南请参考 docs.trystobo.com。

升级方法

pip install --upgrade stobo-mcp

运行 check_connection，Claude 会告知是否有更新版本可用。

v0.5.0 版本新特性

generate_fix_brief：可从任何已完成的审计中生成结构化的修复简报，免费、即时，无需 LLM。
Claude 现在在每次 audit_site 或 audit_article 运行后会自动提供修复简报。
check_connection 会报告是否有更新版本可用。
服务器、客户端和包的版本字符串现在保持一致。

📄 许可证

本项目采用 MIT 许可证。

stobo-mcp