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 许可证。
微信扫一扫