SEO Skill MCP Server

社区

面向 AI Agent 的本地 SEO 命令行与 MCP 服务器，使用你自己的爬取、Search Console 和 GA4 数据完成 70+ 项 SEO 审计。

★ 495 Stars 分类 · 开发工具非常热门

64FMRS · C

SEO Skill 是一个本地优先的 SEO 命令行工具与 stdio MCP 服务器，将爬取、Search Console、流量分析和可选研究提供商数据整合为可核查的报告。它强调证据分级、部分数据不当作零、推荐附带验证方式，适合站长、AI Agent 与开发者。项目采用 Apache-2.0 许可，由第三方而非 Google 或任何搜索引擎官方维护，使用前需注意数据留存于本机、可选外部增强的网络边界以及研究提供商的潜在费用。

可靠性

10/20

安全与权限

13/20

维护活跃度

12/20

文档质量

16/20

安装易用性

13/20

查看 FMRS 评分方法 →

SEO Skill 是一个以本地优先为设计原则的 SEO 工具，通过 seo 命令和本地 stdio MCP 服务器，把站内爬取、Google Search Console、已连接的流量分析（Google Analytics、Clicky）以及可选研究提供商（DataForSEO、Semrush、Ahrefs、Bing Webmaster）的数据，转化为可核查、可执行的 SEO 报告。它提供技术性阻碍排查、关键词与竞品研究、程序化页面模式分析、链接证据、AI 提及研究、服务器日志爬虫流量分析以及 IndexNow 提交通知等能力。报告严格区分观测证据、派生结论和推荐动作，部分数据不会被当作零，启发式规则会被明确标注。数据、项目配置、Google 令牌与缓存均保存在本机。该项目为 Apache-2.0 开源，由 iannuttall/seo 仓库维护，并非 Google 官方产品。

工具能力

seo_run_report

按报告 ID 运行 SEO 报告，可返回结构化 JSON（含 actions 视图）。CLI 与 MCP 读取同一报告注册表，因此 ID 与 JSON Schema 不会漂移。

seo_list_providers

列出与 MCP 服务器安装在同一台计算机上的提供商包。

seo_describe_provider

返回提供商包声明的动作输入与输出 JSON Schema，便于 Agent 发现可运行的动作。

seo_run_provider

按提供商 ID 与动作 ID 运行提供商包定义的动作，输入输出会依据包 schema 校验。

安装接入

确认已安装 Node 22 或更高版本。
全局安装：npm i -g seo。
运行 seo start 完成 Google 登录、选择 Search Console 属性、可选连接流量分析并保存本地项目配置。
安装 MCP 服务器：运行 seo mcp install，安装向导会检测已安装的客户端；也可显式指定 --codex、--claude-code、--cursor 或 --claude-desktop。
其他支持本地 stdio MCP 的客户端可手动配置启动 seo mcp serve。
可选：运行 seo skill install 安装打包的 SEO 技能。

选型与风险

适合谁

希望用一条命令获得清晰审计结果、不想学习复杂仪表盘的自建站站长
需要通过 MCP 获取真实爬取、Search Console、分析与关键词证据的 AI Agent
希望把同一报告引擎嵌入脚本、CI 任务或 TypeScript 应用的开发者

不适合谁

期望托管式仪表盘或云端数据存储的用户——该工具的数据保存在本机
需要使用官方 Google 或 SEO 服务商认证背书的用户——本项目由第三方维护
没有 Node 22+ 运行环境的用户

所需权限

读取本机配置目录以保存项目配置、爬取报告和提供商缓存
访问系统钥匙串存储 Google OAuth 令牌、Bing API 密钥、IndexNow 密钥等凭据（不可用时回退到 0600 私有文件）
在启用时访问被审计网站、Google Search Console、Google Analytics、Bing Webmaster、Clicky 及所选研究提供商的网络请求
可访问 Chrome UX Report、IndexNow 和 npm registry
CI 环境可选使用 Google 服务账号 JSON 密钥和 SEO_GOOGLE_SERVICE_ACCOUNT_JSON、SEO_BING_API_KEY、SEO_CLICKY_SITEKEY、SEO_INDEXNOW_KEY 等环境变量

风险与副作用

可选外部增强可能在你明确启用时，把选定的 Search Console 查询文本或派生种子词发送给所选研究提供商；不会发送 Google 凭据、属性 ID、Search Console 指标或 Google Analytics 行数据
使用系统钥匙串时，无法访问钥匙串的进程可能读取同一进程用户可读的凭据；无钥匙串时会回退到本机私有文件
研究提供商可能产生 API 费用，报告会展示预估与实际成本，但需自行设置消费限制
爬取会向目标站点发出大量请求，可能触发站点防护或封禁；报告中会保留 HTTP 状态、提供商标记与访问建议
用户代理字符串可能被伪造，服务器日志报告描述的是日志中出现的请求字符串，而非经过验证的爬虫身份
IndexNow 请求被接受仅代表已接收，不证明 URL 已被抓取、索引或排名
提供商返回的流量、搜索量、难度、可见度等均为估算值，不能等同于搜索引擎实测数据

常见排障

运行 `seo doctor` 检查本地认证与配置状态
运行 `seo auth status` 查看当前凭据存储模式；可用 `seo auth storage --keychain` 或 `--file` 切换
多个 Google 账号时运行 `seo auth login` 添加账号，`seo auth accounts` 查看列表
MCP 服务器未生效时，确认客户端已通过 `seo mcp install` 配置，或手动配置启动 `seo mcp serve`
无 Google 连接时可用 `seo report --url https://example.com` 先执行纯本地技术爬取
运行 `seo reports describe <id> --json` 在构造参数前查看报告输入 schema
大型页面清单返回分页时，使用 `--inventory-page <number>` 直到 nextPage 为 null

使用场景

对自有网站执行技术性 SEO 审计，获得按影响排序的修复清单

使用 Search Console 数据寻找排名 4-10 的快速见效机会和第二页 URL

进行关键词、竞品和程序化页面模式研究

在 CI 中以 JSON 或 JUnit 输出运行报告并设置失败阈值

分析服务器访问日志中的搜索与 AI 爬虫请求

在发布后通过 IndexNow 通知 URL 变更

支持客户端

Codex完整支持

Claude Code完整支持

Claude Desktop完整支持

Cursor完整支持