SEO Skill MCP Server

社区

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

分类: 开发工具第 60 / 438
Stars: ★ 603 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js 22+
凭据: 可选 API Key
许可证: Apache-2.0
最近提交: 今天
工具数: 4

64FMRS · C

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

最强项 · 文档质量 16/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

13/20

维护活跃度

12/20

文档质量

16/20

安装易用性

13/20

查看各项评分依据

可靠性 10/20: 静态审查仅依据 README、仓库描述与主题标签，未提供 SERVER MANIFEST、未执行任何命令、未看到提交的测试文件或真实 CI 工作流端口细节（虽 README 徽章声称有 ci.yml，但徽章属不可验证证据）。README 描述 70+ 工具、CLI 与 MCP 共用同一报告注册表（称 id 与 JSON Schema 不会漂移），并列出确定性 JSON、JUnit 输出、--fail-on 用于 CI，这些设计说明主路径可复现；但缺少任何已提交测试或实际 tool-list 握手证据，按静态校准不得高于 12，故给 10。
安全与权限 13/20: 凭证处理写得较细：Google OAuth token 优先用系统 keychain，无 keychain 时回落到 0600 私有文件；provider 凭证（DataForSEO/Semrush/Ahrefs/Bing/IndexNow key）同样使用 keychain + 私有文件回落，并支持 SEO_* 环境变量供 CI。IndexNow 明确先校验 key 文件再发请求，支持 --dry-run，上限 1000 URL 且必须同 host。外发数据有边界声明：仅在你显式启用时把选定的 Search Console 查询或派生种子文本发给研究 provider，不发送 Google 凭证、属性 ID、指标或 GA4 行数据；本地导入文件不上传。但证据仅为 README 自述，无法核实实际实现；第三方 provider 包通过 `seo providers install` 引入并在用户机器上运行任意代码，虽提到会展示版本/发布者/仓库/完整性/代码警告，但缺少沙箱、权限隔离或持久化确认机制的说明；Google 服务账号与 provider 密钥赋予较宽的 API 范围。未发现恶意、偷凭证或未确认的破坏性默认操作等红线，扣 7 分主要因权限最小化与安装第三方代码的确认/隔离细节不可验证。
维护活跃度 12/20: 仓库未归档，0 个 open issue，495 stars（仅作发现信号，不计分），Apache-2.0 许可证明确且有 TRADEMARKS 政策，SECURITY.md 提供私有漏洞上报通道，AGENTS.md 提供贡献架构与报告质量规则，README 列出 pnpm build/typecheck/test/lint/pack 质量门禁与 npm 发布包，另有两个第一方 provider 包发布示例。这些显示拥有方清晰、许可与安全响应渠道完备。扣分项：静态材料无法验证实际提交频率、发布节奏、依赖更新策略或 issue 响应时效；未提供版本兼容/API 稳定性承诺（仅 provider apiVersion: 1），因此不足以给高分，给 12。
文档质量 16/20: 文档分层完整：快速开始、命令总览（seo help）、报告目录发现（seo reports list/describe）、研究 provider 与本地导出的字段映射说明（支持 CSV/TSV/JSON/JSONL/NDJSON、UTF-8/UTF-16 检测、SHA-256 哈希、行列计数与上限）、Google 数据指南、TypeScript 库用法、CI 示例、隐私与遥测页面、成本说明（provider 按 API 计费，报告记录预估/实际费用、缓存与请求上限）。限制披露诚实：反复区分观测证据、派生发现与建议动作，声明部分数据不会记为 0、启发式会标注、IndexNow 受理不等于被索引、User-Agent 可伪造、provider 指标是估计值。扣分项：所有文档均为仓库自述，SERVER MANIFEST 缺失导致无法核对工具参数与实际暴露面；具体研究 provider 的 JSON 参数细节外包到外部站点而非仓库内；未提供常见故障排查清单（如 auth/keychain 失败的诊断步骤仅有 seo doctor）。故给 16。
安装易用性 13/20: 安装路径清晰：Node 22+，npm i -g seo，seo start 引导 Google 登录与本地项目配置，seo mcp install 支持 --codex/--claude-code/--cursor/--claude-desktop 并自动探测已安装客户端，任何本地 stdio 客户端可用 seo mcp serve 手动接入；无需 Google API key，仅做本地技术审计可完全免登录（seo report --url）；CI 可用服务账号 JSON 或 SEO_* 环境变量，无需浏览器。扣分项：未提供具体客户端配置文件示例（JSON 片段），安装步骤依赖交互式提示，研究 provider 与 Clicky/SerpBase 等需额外安装包并手动连接凭证，跨平台（Windows keychain 回落、headless）行为描述有限，且静态校准下无执行证据不得高于 15，综合给 13。

静态评测 · 未实际运行收录于 2026-09-18

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件访问网络

适合谁

希望用一条命令获得清晰审计结果、不想学习复杂仪表盘的自建站站长
需要通过 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 已被抓取、索引或排名
提供商返回的流量、搜索量、难度、可见度等均为估算值，不能等同于搜索引擎实测数据

安装接入

准备工作

运行环境：Node.js 22+

SEO_GOOGLE_SERVICE_ACCOUNT_JSON 可选密钥 CI 中使用的 Google 服务账号 JSON 密钥，通过 CI 密钥库提供，用于无浏览器访问 Search Console 和 Google Analytics。

SEO_CLICKY_SITEKEY 可选密钥 Clicky 统计的 sitekey，供代理和 CI 进程使用，替代保存在密钥库中的值。

SEO_BING_API_KEY 可选密钥 Bing Webmaster Tools 的 API 密钥（设置 > API Access 获取），设置后无需保存即可运行 Bing 报告。

SEO_INDEXNOW_KEY 可选密钥 IndexNow 提交用的密钥，供当前进程使用，替代本地密钥映射。

确认已安装 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 客户端中安装后（seo mcp install），检查工具列表里是否出现 seo_run_report、seo_list_providers、seo_describe_provider 和 seo_run_provider；调用 seo_list_providers 返回已安装提供方列表即说明连接正常。

常见排障

运行 `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

试试这样问

连接成功后，可以直接对 AI 助手这样说：

用 seo_run_report 对 sc-domain:example.com 跑一个主 SEO 报告
列出这台机器上已安装的研究提供方
用 seo_run_provider 跑一个 domain-overview 报告，查看 example.com 的市场概况
描述 keyword-research 报告的输入参数

工具能力 4

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 校验。

使用场景

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

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

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

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

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

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

支持客户端

Codex

Claude Code

Claude Desktop

Cursor

依据项目文档列出，未经本站实测。

详细介绍

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 官方产品。