关于 seoscoreapi-mcp
seoscoreapi-mcp 将 SEO Score API 的站点分析与监控能力提供给 MCP 客户端,适用于 SEO、内容和网站团队。它涵盖 SEO、可访问性、AI 可读性、反向链接及品牌引用追踪等工具。
主要功能
- 01单页与批量 SEO 审计
- 02深度审计和多页面爬取
- 03无障碍与 AI 可读性检查
- 04分数历史和定期监控
- 05反向链接与品牌引用追踪
- 06比较页面及竞品审计
适用场景
- 01检查页面问题并获取优先修复项
- 02追踪网站分数变化与监控提醒
- 03检查页面的 WCAG 问题和 AI 可读性
- 04监测品牌在 LLM 回答中的引用
MCP 相关
MCP 服务以标准 MCP 工具形式向客户端暴露 SEO Score API 功能,通过 SEO_SCORE_API_KEY 配置 API 密钥。它使用 stdio 传输,可连接支持 MCP 的 AI 工具。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
45收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| url | string | 是 | 要审计的 URL。必须包含协议(https://...)。 |
| include_core_web_vitals | boolean | 否 | 同时使用 Google PageSpeed Insights 测量 Core Web Vitals(LCP、INP、CLS、FCP、TTFB),并在 core_web_vitals 下返回结果。首次测量某个 URL 时会增加约 10 秒(缓存 24 小时)。需要 API 密钥。除非用户询问页面速度或 Core Web Vitals,否则请勿启用。 |
详细介绍
SEO Score API — 模型上下文协议服务
让 Claude Desktop、Claude Code、Cursor、Windsurf 或任何支持 MCP 的 AI 工具直接访问 SEO Score API:完整审计、反向链接数据、监控和历史记录。
快速开始
npx -y seoscoreapi-mcp
只需设置一次 API 密钥,即可无须再操心:
export SEO_SCORE_API_KEY="ssa_your_key_here"
(前往 https://seoscoreapi.com 免费获取密钥——无需信用卡。)
提供的工具
| 工具 | 功能 | 套餐 |
|---|---|---|
audit | 对一个 URL 进行完整 SEO 审计——评分、等级、80 多项检查、AI 可读性和按优先级排列的修复建议。include_core_web_vitals: true 会添加实测的 LCP、INP 和 CLS(耗时约多 10 秒,需要密钥) | 免费 |
batch_audit | 一次审计最多 10 个 URL(include_core_web_vitals 可选) | Starter($5/月) |
usage | 当前套餐 + 每月用量 + 剩余配额 | 免费 |
report_url | 为某个域名生成可公开分享的 HTML 报告 | 免费 |
add_monitor | 添加 URL,以便按计划重新审计并接收提醒 | Starter |
list_monitors | 列出受监控的 URL | Starter |
history | 某个 URL 过去评分的时间序列 | Starter |
history_domains | 使用此密钥审计过的所有域名及其 30 天趋势 | Starter |
backlinks | 某个域名的已观测反向链接(由审计数据提供的图谱;每次响应都会诚实说明数据局限) | Basic($15/月) |
deep_audit | 深度站点审计:9 个维度、数千项目录检查和最多 150 项 AI 检查;等待结果返回(timeout_seconds 默认值为 600) | Pro($39/月)、Ultra 或点数 |
start_deep_audit | 将深度站点审计加入队列,并立即返回其 job_id(webhook_url 可选) | 同上 |
get_deep_audit | 深度站点审计任务的状态,完成后附带 result | 同上 |
deep_audit_usage | 本月已使用和剩余的深度站点审计次数 | 同上 |
remove_monitor | 移除对 URL 的评分监控 | Starter |
compare | 对 2–5 个 URL 进行结构化差异比较 | Basic($15/月) |
competitive_audit | 针对某个关键词,将页面与竞争对手的页面进行正面对比 | Pro($39/月) |
accessibility_audit | ADA / WCAG 2.1 AA 审计:评分、诉讼风险、违规项及修复建议(include_trackers 可选) | 付费套餐;每月有专属额度 |
ai_readability | 页面被 AI/LLM 系统读取的效果 | 任意密钥 |
trackers | 页面加载的第三方跟踪器和像素 | 任意密钥(一次审计) |
conversion | 转化评分:标题、CTA、信任度、表单、异议 | 任意密钥(一次审计);付费套餐提供完整修复清单 |
quick_wins | 根据 Search Console 数据行或你提供的 CSV,找出第 2 页的快速提升机会 | 任意密钥(一次审计) |
llms_txt | 为某个域名生成 llms.txt 文件 | 无需密钥;Basic 及以上套餐提供精选版本 |
geo_audit | GEO 审计:页面在 LLM 中的可见度 | Basic |
geo_brand_probe | LLM 提及某个品牌的频率 | Basic |
add_geo_monitor / list_geo_monitors / geo_monitor_history / remove_geo_monitor | GEO 监控 | Basic |
crawl_site | 多页面站点爬取(失效页面、重定向、重复页面、孤立页面、加载缓慢的页面);等待结果返回 | Pro、Ultra 或一次深度审计点数 |
start_crawl / get_crawl | 启动爬取并自行轮询状态 | 同上 |
citation_starter_prompts / citation_suggest_prompts | 用于跟踪 AI 引用的提示词 | 任意密钥;不计量 |
create_citation_tracker / list_citation_trackers / get_citation_tracker / update_citation_tracker / delete_citation_tracker | 跟踪品牌在 ChatGPT、Gemini、Perplexity 和 Claude 中的情况 | Starter($5/月) |
run_citation_tracker / get_citation_run / citation_tracker_history | 运行跟踪器、读取运行结果、查看趋势 | Starter;按检查次数计量 |
citation_check | 对某个品牌和一条提示词进行单次引用检查 | 付费套餐;按次计量 |
citation_topups | 充值包和账户的检查余额 | 任意密钥 |
citation_topup_checkout | 充值包的 Stripe Checkout 链接(用户付款前不会扣费) | 付费套餐 |
citation_auto_reload | 查看自动充值设置 | 任意密钥;只读 |
有意不暴露的功能
- 报告文件(
GET /audit/export):PDF 是二进制文件,而 MCP 工具结果是文本。audit工具会以 JSON 格式返回相同的数据;如需获取文件,请使用 REST API 或 Python / Node SDK(audit_export/auditExport)。 - 启用自动重新加载。 API 没有用于 API 密钥的此类端点:它会授权扣款,因此只能在控制面板中设置。
citation_auto_reload会读取该设置。 - 账户操作(
/signup、/verify、/upgrade、/rotate-key)以及公开排行榜的退出选项。
配置
| 环境变量 | 默认值 | 用途 |
|---|---|---|
SEO_SCORE_API_KEY | (无) | 你的 API 密钥 |
SEO_SCORE_BASE_URL | https://seoscoreapi.com | API 主机 |
SEO_SCORE_DEEP_AUDIT_URL | SEO_SCORE_BASE_URL | Deep Audit 主机(POST /site-audit、GET /site-audit/{job_id}、GET /deep-audit/usage)。仍会读取 SEO_SCORE_ENGINE_URL 作为回退值;旧版 https://engine.seoscoreapi.com 仍可使用。 |
Claude Desktop
编辑 ~/Library/Application Support/Claude/claude_desktop_config.json(Mac)或 %APPDATA%\Claude\claude_desktop_config.json(Windows):
{
"mcpServers": {
"seoscoreapi": {
"command": "npx",
"args": ["-y", "seoscoreapi-mcp"],
"env": {
"SEO_SCORE_API_KEY": "ssa_your_key_here"
}
}
}
}
重启 Claude Desktop。你会在工具选择器中看到 SEO Score 工具。
Claude Code
claude mcp add seoscoreapi -e SEO_SCORE_API_KEY=ssa_your_key_here -- npx -y seoscoreapi-mcp
Cursor
打开 Cursor 设置 → MCP 服务 → 添加新服务,使用与上文 Claude Desktop 相同的 JSON 结构。
Windsurf
设置 → Cascade → MCP 服务 → 粘贴相同配置。
任何其他 MCP 客户端
将 npx -y seoscoreapi-mcp 作为 stdio 传输运行。该服务使用标准 MCP 协议,并提供上表中的所有工具。
示例提示词
安装后,可以自然地向 AI 助手提问:
“审核 https://stripe.com,并告诉我最需要修复的 3 个问题。”
“对 stripe.com、square.com 和 adyen.com 进行批量审核,然后比较它们的 AI 可读性评分。”
“我们发现有哪些反向链接指向 my-startup.com?”
“查看我们营销网站过去 30 天的评分历史。”
“将 my-startup.com 作为 SaaS 网站进行深度审核,并列出高严重性问题。”
“审核我们的定价页面的无障碍性,并列出严重的 WCAG 问题。”
“抓取 my-startup.com,并显示失效链接和孤立页面。”
“为‘SEO audit API’生成入门提示词,为 Acme 创建引用跟踪器,然后运行它。”
AI 选择的工具会显示在你的客户端中;你随时可以询问“你使用了哪些工具?”,查看调用记录。
为什么选择 MCP?
MCP 让 AI 无需任何自定义连接,就能访问原本无法获取的数据——你网站的实际 SEO 评分、反向链接图谱、监控历史记录。每当你提示“审核此 URL”,就能在一次往返中从想法得到结果。数据源与 REST API 相同;无需在工具之间复制评分。
如实说明
backlinks 工具返回的是基于审核生成的样本,而非完整的反向链接索引。每个响应都包含 data_caveat,准确说明数据集的具体内容。我们不是 Ahrefs,也不会假装是——我们提供的是由客户审核免费构建、不断扩大的独特图谱。
源代码
MCP 服务是开源的:https://github.com/SeoScoreAPI/seoscoreapi-mcp
许可证
MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。