关于 SEOmatic
SEOmatic 是面向 Agent 的托管 SEO MCP 服务,为网站运营者提供 Search Console 数据、页面审计、关键词与反向链接研究及 AI 可见度检查。网站修改须先获批准,之后才能发布到已连接的 CMS 并衡量效果。
主要功能
- 01Search Console 表现洞察
- 02页面审计与关键词研究
- 03反向链接和 AI 可见度分析
- 04暂存并审批网站修改
- 05衡量已发布修改效果
适用场景
- 01查找接近搜索结果首页的页面
- 02调查流量下降和 SEO 问题
- 03检查品牌在 AI 答案中的提及
- 04发布前审核网站修改
MCP 相关
托管的 Streamable HTTP 服务端点 `https://app.seomatic.ai/api/mcp` 向兼容客户端提供 SEO 数据和网站操作工具。可使用 OAuth 2.1 或 Bearer API 密钥;暂存操作须经批准才能生效。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://app.seomatic.ai/api/mcpclaude mcp add --transport http ai-seomatic-seomatic https://app.seomatic.ai/api/mcp{"mcpServers":{"ai-seomatic-seomatic":{"type":"http","url":"https://app.seomatic.ai/api/mcp"}}}在 Cursor 中打开{"servers":{"ai-seomatic-seomatic":{"type":"http","url":"https://app.seomatic.ai/api/mcp"}}}在 VS Code 中打开{"mcpServers":{"ai-seomatic-seomatic":{"type":"http","url":"https://app.seomatic.ai/api/mcp"}}}{"mcpServers":{"ai-seomatic-seomatic":{"serverUrl":"https://app.seomatic.ai/api/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
2| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| site | string | 是 | 用户自己的网站,例如 example.com |
详细介绍
面向 AI Agent 的 SEOmatic
为你自己的网站提供 SEO Agent,可在你已经使用的 AI Agent 中运行。询问真实的 Google Search Console 数据、审核页面、查看 ChatGPT、Claude、Perplexity 和 Google AI Overviews 如何描述你、研究关键词和反向链接,并暂存修复内容。未经你批准,任何内容都不会上线;批准后,SEOmatic 会将内容发布到 WordPress、Shopify、Webflow、Wix 及其他已连接的 CMS,并衡量修改前后的效果。
此仓库集中存放每种 Agent 的安装文件:托管的 MCP 服务配置、20 个 Agent Skills、Grok Bot 模板,以及 Claude Code、Cowork、Cursor、Codex、Grok Build、Gemini CLI、Kimi Code 和 DeepSeek Harness 的插件清单。
| 内容 | 位置 |
|---|---|
| MCP 端点 | https://app.seomatic.ai/api/mcp(Streamable HTTP) |
| 身份验证 | OAuth 2.1(动态客户端注册)或 Authorization: Bearer smk_live_... |
| REST API | https://app.seomatic.ai/api/v1 |
| CLI | npm 上的 seomatic(npx -y seomatic) |
| API 密钥 | Settings, AI Agents, API Keys(管理员角色) |
| 文档 | https://seomatic.ai/developers/mcp |
免费的 SEOmatic 账户(OAuth 或 API 密钥)可以读取所有内容:诊断、Search Console、网站审核和 AI 可见度结果。通过 MCP 暂存修复内容(task_manage 创建和决定、campaign_manage)需要付费方案,其密钥包含 agents:act 范围。通过 REST API 或 CLI 执行操作需要 Infrastructure 方案。批准权始终由你掌握:Agent 只会记录你作出的决定。
快速开始
将 20 个 SEO 技能添加到任何能够读取 Agent Skills 的 Agent(Claude Code、Cursor、Codex、Gemini CLI、OpenCode、Kiro 等 40 多种工具):
npx skills add Minh42/seomatic-mcp --full-depth
然后连接它们使用的 MCP 服务(OAuth,免费账户,无需银行卡):
claude mcp add --transport http seomatic https://app.seomatic.ai/api/mcp
提问:“我的哪些页面最有希望进入搜索结果第 1 页?” 答案会引用你真实的 Search Console 数据。想要使用始终在线的 Bot?请参阅 Grok Bot 模板。
目录
- 快速开始 · 你可以询问的内容
- 安装:Claude · Claude Cowork · Claude Code · ChatGPT · Codex · Cursor · Grok Bot · Grok Build · Gemini CLI 和 Gemini · Google Antigravity · Kimi Code · OpenClaw · Hermes Agent · NanoClaw · Paperclip · DeepSeek Harness · Manus 和 Cue · Perplexity Computer · Muse · OpenCode · Kilo Code · Warp · Goose · Kiro · GitHub Copilot CLI · Cline 和其他 MCP 客户端 · 任意 Agent:仅使用技能
- 技能 · 工具 · 仓库结构 · 同步技能
你可以询问的内容
- 我有哪些关键词快要排进搜索结果第 1 页了?
- 过去 28 天哪些页面的流量下降了?原因是什么?
- 对我的网站进行全面 SEO 审核。
- 用户询问我的主题时,ChatGPT 会提到我的网站吗?
- 我这个月获得了哪些反向链接?哪些网站链接了我的竞争对手,却没有链接我?
- 每周一为我撰写一份 SEO 简报。
工具的作用范围仅限于你登录的工作区,因此你无需提供域名。
Claude(Web 版和桌面版)
设置、Connectors、Add custom connector:
- 名称:
SEOmatic - URL:
https://app.seomatic.ai/api/mcp
点击 Connect 并登录 SEOmatic。无需密钥。对于引导式工作流,请在设置、Capabilities、Skills、Upload skill 中添加技能(将 skills/ 下的任意文件夹打包为 zip)。
Claude Cowork
Cowork 读取与 Claude Code 相同的插件。打开 Customize、Plugins、Add marketplace,输入 Minh42/seomatic-mcp,然后安装 seomatic。它包含 SEOmatic 连接器(首次使用时通过 OAuth 授权)和全部二十个技能。
如果只需要连接器,请按照 Claude 中的说明添加。
Claude Code
作为插件(MCP 服务加二十个技能):
/plugin marketplace add Minh42/seomatic-mcp
/plugin install seomatic@seomatic
在 shell 中,执行 claude plugin marketplace add Minh42/seomatic-mcp,然后执行 claude plugin install seomatic@seomatic,效果相同。运行 /mcp 并选择
seomatic 进行登录。
仅 MCP 服务:
claude mcp add --transport http seomatic https://app.seomatic.ai/api/mcp
ChatGPT
ChatGPT Web 版和桌面版(支持开发者模式的套餐):设置、Apps and Connectors、Advanced settings,开启 Developer mode,然后 点击 Create:
- 名称:
SEOmatic - MCP 服务 URL:
https://app.seomatic.ai/api/mcp - 身份验证:OAuth
ChatGPT 提示时,请登录 SEOmatic。
Codex
作为插件(仓库采用开放插件格式,包含 plugin.json、mcp.json 和
.agents/plugins/marketplace.json):
codex plugin marketplace add Minh42/seomatic-mcp
codex plugin add seomatic@seomatic
仅 MCP 服务:
codex mcp add seomatic --url https://app.seomatic.ai/api/mcp
codex mcp login seomatic
无头模式(CI、服务器):export SEOMATIC_API_KEY=smk_live_...,然后执行
codex mcp add seomatic --url https://app.seomatic.ai/api/mcp --bearer-token-env-var SEOMATIC_API_KEY。
Cursor
一键安装: 将 SEOmatic 添加到 Cursor
或者添加到 ~/.cursor/mcp.json:
{
"mcpServers": {
"seomatic": { "url": "https://app.seomatic.ai/api/mcp" }
}
}
然后在 Settings, MCP 中,点击 seomatic 旁边的 Connect 进行登录。Cursor 在此处使用
OAuth:它不会向此服务发送自定义标头,因此不要在配置中粘贴
API 密钥。
作为插件(MCP 服务、技能和规则):仓库包含
.cursor-plugin/。在 Cursor 插件市场上架后,从市场安装;也可以在本地安装:
git clone https://github.com/Minh42/seomatic-mcp.git
ln -s "$(pwd)/seomatic-mcp" ~/.cursor/plugins/local/seomatic
然后选择 Developer: Reload Window。
Grok Bot
在 Grok Bot 上打造全天候 SEO 助手,并设置每周
例行任务。一键安装:安装 SEO Teammate,然后连接一次 SEOmatic(OAuth)。另外八个现成机器人(流量下滑监控、每周简报、快速见效项、AI 可见度、本地 SEO、代理机构报告、内容规划器、技术监控)可从
grok-bot/templates 安装。若要手动构建,请按
grok-bot/ 中的说明操作:粘贴指令,根据
grok-bot/SETUP.md 连接 MCP 服务(OAuth),并添加技能和三个例行任务。对于 CLI 技能,请将 SEOMATIC_API_KEY
添加为机器人密钥。
Grok Build
仓库包含 .grok-plugin/plugin.json(元数据;Grok Build 会从
skills/ 获取技能,并从根目录的 .mcp.json 获取托管的 MCP 服务,首次使用时通过 OAuth 授权)以及 .grok-plugin/marketplace.json,因此 Grok
Build 可以将其添加为插件市场来源:将 Minh42/seomatic-mcp 添加为
插件市场,然后安装 seomatic。SEOmatic 在
xAI 插件市场 上架后,也可从那里安装。
Gemini CLI 和 Gemini
这个仓库是一个 Gemini CLI 扩展(gemini-extension.json 加上
GEMINI.md):
gemini extensions install https://github.com/Minh42/seomatic-mcp
它会安装托管的 MCP 服务和技能。Gemini CLI 首次使用时会打开浏览器供你登录;再次登录请运行 /mcp auth seomatic。
仅安装 MCP 服务,配置在 ~/.gemini/settings.json 中:
{
"mcpServers": {
"seomatic": { "httpUrl": "https://app.seomatic.ai/api/mcp", "oauth": { "enabled": true } }
}
}
自 2026-06-18 起,Gemini CLI 不再向个人 Google 账号提供服务。Google Workspace 账号和 Gemini API 密钥用户仍可使用;其他用户可改用 Google Antigravity。
Gemini 网页版(gemini.google.com)不支持个人账号添加自定义 MCP 服务。请使用 Gemini CLI,或使用 Gemini Enterprise 工作区,让管理员添加 https://app.seomatic.ai/api/mcp 作为自定义 MCP 连接器。
Google Antigravity
请使用 API 密钥:Antigravity 用于远程 MCP 服务的 OAuth 流程存在上游故障。在 Settings, AI Agents 中创建密钥,然后从终端添加:
agy mcp add -H "Authorization: Bearer smk_live_YOUR_KEY" seomatic https://app.seomatic.ai/api/mcp
或添加到 ~/.gemini/config/mcp_config.json 中:
{
"mcpServers": {
"seomatic": {
"serverUrl": "https://app.seomatic.ai/api/mcp",
"headers": { "Authorization": "Bearer smk_live_YOUR_KEY" }
}
}
}
Kimi Code
仓库中包含 kimi.plugin.json(技能和 MCP 服务):
/plugins install https://github.com/Minh42/seomatic-mcp
仅安装 MCP 服务:
kimi mcp add --transport http --auth oauth seomatic https://app.seomatic.ai/api/mcp
kimi mcp auth seomatic
OpenClaw
从 ClawHub 安装技能(调用 seomatic CLI,需要 API 密钥):
clawhub install @Minh42/seomatic
然后在 ~/.openclaw/openclaw.json 的
skills.entries.seomatic.apiKey 下设置密钥,或为网关导出 SEOMATIC_API_KEY。MCP 技能也发布在 ClawHub 上(seomatic-seo-audit、
seomatic-striking-distance,……)。
MCP 服务:OpenClaw 以无头模式运行,因此请使用 API 密钥。打开设置,选择 MCP、 Add server:
{
"seomatic": {
"url": "https://app.seomatic.ai/api/mcp",
"transport": "streamable-http",
"headers": { "Authorization": "Bearer smk_live_YOUR_KEY" }
}
}
Hermes Agent
hermes mcp add seomatic --url https://app.seomatic.ai/api/mcp --auth oauth
技能(共二十个,保持更新):
hermes skills tap add Minh42/seomatic-mcp
也可以逐个安装:hermes skills install Minh42/seomatic-mcp/skills/seomatic-seo-audit。
MCP 技能声明了 requires_mcp_servers: [seomatic],因此连接服务后就会显示。seomatic CLI 技能加载时会提示输入
SEOMATIC_API_KEY。
NanoClaw
请将密钥保存在 OneCLI 保管库中,切勿将其放在 ncl 标志中。保管库会在向
app.seomatic.ai 发起请求时注入密钥:
onecli secrets create --name SEOmatic --type api_key \
--value "$SEOMATIC_API_KEY" --host-pattern app.seomatic.ai \
--header-name Authorization --value-format 'Bearer {value}'
将该密钥关联到群组的 Agent(onecli agents set-secrets
会替换整个列表,因此请将它与已有密钥合并),然后在不添加任何标头的情况下添加服务并重启:
ncl groups config add-mcp-server --id <group-id> --name seomatic \
--url https://app.seomatic.ai/api/mcp
ncl groups restart --id <group-id>
nanoclaw/add-seomatic-tool.md 会引导 NanoClaw 的 Agent 完成整个流程,包括合并密钥。将它复制到 NanoClaw 检出目录中的 .claude/skills/add-seomatic-tool/SKILL.md,然后运行
/add-seomatic-tool。该文件位于 skills/ 之外,因此技能 CLI 不会将它安装到其他 Agent 中。将 skills/ 中的任意文件夹复制到群组的技能目录,即可添加相应的引导式工作流。
Paperclip
技能:选择 Skills、Import from GitHub,添加 Minh42/seomatic-mcp,
选择 Find skills,选中 SEOmatic 技能,然后选择 Import。Paperclip 会在导入时显示每项技能声明的运行时要求(CLI 技能需要 SEOMATIC_API_KEY,其他技能需要 seomatic MCP 服务)。将 SEOMATIC_API_KEY
添加为公司密钥,并将其提供给使用 SEOmatic 的 Agent。对于 MCP 技能,请将 SEOmatic MCP 服务添加到 Agent 的运行时中(对于 Claude
Code Agent:claude mcp add --transport http seomatic https://app.seomatic.ai/api/mcp --header "Authorization: Bearer $SEOMATIC_API_KEY")。
DeepSeek Harness(dsh)
plugins/dsh-seomatic 套件会将 dsh 连接到托管的 MCP 服务,并注册一个 seomatic 技能:
dsh plugin --profile web add "github:Minh42/seomatic-mcp#path:/plugins/dsh-seomatic"
export SEOMATIC_API_KEY=smk_live_...
dsh web
同一套件也发布在 npm 上,名称为 dsh-seomatic
(dsh plugin --profile web add dsh-seomatic)。工具会以 mcp__seomatic__* 的形式显示。未提供密钥时,配置仍会启动,但不会提供 SEOmatic 工具。请参阅插件 README。
Manus 和 Cue
设置、连接器、自定义 MCP、添加自定义 MCP、直接配置:
- 名称:
SEOmatic - 传输方式:Streamable HTTP
- URL:
https://app.seomatic.ai/api/mcp - 标头:
Authorization: Bearer smk_live_YOUR_KEY(或在支持的情况下使用 OAuth)
Cue 和其他带有“自定义 MCP 服务”界面的 Agent 都使用相同的三个值。
Perplexity Computer
Pro、Max 和 Enterprise:设置、连接器、添加自定义连接器 (或 perplexity.ai/computer/connectors、+ 自定义连接器):
- 名称:
SEOmatic - MCP URL:
https://app.seomatic.ai/api/mcp - 传输方式:Streamable HTTP
- 身份验证:OAuth,或使用你的
smk_live_...密钥作为 API 密钥
Muse
请 Muse 为 SEOmatic 添加自定义连接器,并在提示登录时登录 SEOmatic,地址为
https://app.seomatic.ai/api/mcp。连接器出现在列表中后,即可从中使用 SEOmatic。
OpenCode
在 opencode.json(项目级)或 ~/.config/opencode/opencode.json 中:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"seomatic": {
"type": "remote",
"url": "https://app.seomatic.ai/api/mcp",
"headers": { "Authorization": "Bearer smk_live_YOUR_KEY" }
}
}
}
省略 headers 即可改用 OAuth 登录(opencode mcp auth seomatic)。
Kilo Code
kilo.jsonc 使用与 OpenCode 相同的代码块:
{
"mcp": {
"seomatic": {
"type": "remote",
"url": "https://app.seomatic.ai/api/mcp",
"headers": { "Authorization": "Bearer smk_live_YOUR_KEY" }
}
}
}
Warp
设置、AI、MCP 服务、+ 添加,然后粘贴:
{
"seomatic": {
"url": "https://app.seomatic.ai/api/mcp",
"headers": { "Authorization": "Bearer smk_live_YOUR_KEY" }
}
}
Goose
运行 goose configure,选择添加扩展、远程扩展(Streamable HTTP),
名称填写 seomatic,URL 填写 https://app.seomatic.ai/api/mcp,并添加
Authorization 标头,值为 Bearer smk_live_YOUR_KEY。在
~/.config/goose/config.yaml 中的配置如下:
extensions:
seomatic:
enabled: true
name: seomatic
type: streamable_http
uri: https://app.seomatic.ai/api/mcp
headers:
Authorization: Bearer smk_live_YOUR_KEY
timeout: 300
Kiro
在 ~/.kiro/settings/mcp.json 中(或项目中的 .kiro/settings/mcp.json)。
建议使用 Authorization 标头:
{
"mcpServers": {
"seomatic": {
"url": "https://app.seomatic.ai/api/mcp",
"headers": { "Authorization": "Bearer smk_live_YOUR_KEY" }
}
}
}
GitHub Copilot CLI
copilot mcp add --transport http seomatic https://app.seomatic.ai/api/mcp
若要使用 API 密钥,请在 ~/.copilot/mcp-config.json 中添加标头:
{
"mcpServers": {
"seomatic": {
"type": "http",
"url": "https://app.seomatic.ai/api/mcp",
"headers": { "Authorization": "Bearer smk_live_YOUR_KEY" },
"tools": ["*"]
}
}
}
Cline 和其他 MCP 客户端
任何支持 Streamable HTTP 的客户端都可以使用。使用 API 密钥时(以下展示的是 Cline 的
cline_mcp_settings.json):
{
"mcpServers": {
"seomatic": {
"url": "https://app.seomatic.ai/api/mcp",
"type": "streamableHttp",
"headers": { "Authorization": "Bearer smk_live_YOUR_KEY_HERE" }
}
}
}
仅支持 OAuth 的客户端只需提供 URL。VS Code 和 GitHub Copilot 可在
GitHub MCP Registry 中找到 SEOmatic,名称为
ai.seomatic/seomatic。该 Registry 条目根据 SEOmatic 应用仓库中的 server.json 发布,
它是权威来源;此处的 server.json 是与其保持一致的副本。自行安装
MCP 服务的 Agent 可参阅 llms-install.md。
任何 Agent:仅使用技能
skills CLI 可将技能安装到 Claude Code、Cursor、Codex、Gemini CLI、OpenClaw 等更多工具中:
npx skills add Minh42/seomatic-mcp # the seomatic CLI skill
npx skills add Minh42/seomatic-mcp --full-depth # all twenty skills
seomatic 技能通过 CLI 工作,因此任何能够运行 shell 命令的 Agent 都可以使用,无需配置 MCP:在你自己的
计算机上运行 npx -y seomatic login --device,或在服务端使用 SEOMATIC_API_KEY。
技能
| 技能 | 需求 | 功能 |
|---|---|---|
seomatic | CLI + SEOMATIC_API_KEY | 通过 npx -y seomatic 完成所有操作:Search Console、审计及任何工具 |
seomatic-seo-audit | MCP 服务 | 执行完整审计,并生成按优先级排序的修复列表 |
seomatic-striking-distance | MCP 服务 | 第 2 页查询、点击提升空间,以及待分阶段实施的修复 |
seomatic-weekly-brief | MCP 服务 | 简短的周一简报,概述变化 |
seomatic-ai-visibility-review | MCP 服务 | AI 答案如何展示你的品牌,以及跟踪的提示词 |
seomatic-ai-citations | MCP 服务 | AI 引用和 AI 引荐的第一方证据 |
seomatic-approval-workflow | MCP 服务 | 审核已暂存的工作、批准或驳回,并回滚 |
seomatic-traffic-drop | MCP 服务 | 流量下降的原因:季节性、页面、索引和竞争对手 |
seomatic-ctr-fix | MCP 服务 | 有排名但失去点击的页面;新的标题和元数据 |
seomatic-content-refresh | MCP 服务 | 流量衰退的页面,以及每个页面的具体需求 |
seomatic-cannibalization | MCP 服务 | 自有页面争夺同一查询,以及应该由哪个页面胜出 |
seomatic-indexing-check | MCP 服务 | 检查关键页面的 URL,每项状态都以通俗语言说明 |
seomatic-internal-linking | MCP 服务 | 从强势页面添加上下文链接,指向接近第 1 页排名的页面 |
seomatic-keyword-research | MCP 服务 | 从你自己的 Search Console 获取关键词,并映射到对应页面 |
seomatic-content-brief | MCP 服务 | 根据实时搜索结果生成简报,并在发布前为草稿评分 |
seomatic-competitor-gap | MCP 服务 | 真正排名超过你的竞争对手,以及他们胜出的关键词 |
seomatic-backlink-audit | MCP 服务 | 判断权威度是否构成瓶颈,并寻找真实的链接机会 |
seomatic-local-seo | MCP 服务 | 商家资料、评价、地图包和位置页面 |
seomatic-ai-crawlers | MCP 服务 | 哪些 AI 机器人会抓取你的网站、哪些内容被屏蔽,以及从抓取到引用的情况 |
seomatic-client-report | MCP 服务 | 根据真实数据生成客户或老板的月度报告 |
每项技能都遵循相同规则:数字仅来自工具结果,日期范围按原样引用,未经你批准,任何内容都不会上线。
工具
16 个工具,每个工具都标注为只读或暂存,并限定在已连接的工作区内:gsc_performance、gsc_insights、gsc_indexing、
keyword_research、keyword_clusters、backlink_profile、
serp_competitors、site_pages、ai_citations、visibility_manage、
traffic_analytics、local_presence、dataset_library、
strategy_insights、task_manage、campaign_manage。你能看到的内容取决于你的套餐和已连接的数据源。参考:
https://seomatic.ai/developers/mcp
仓库结构
| 路径 | 用途 |
|---|---|
.mcp.json | Claude Code 插件 MCP 配置 |
.claude-plugin/ | Claude Code 和 Cowork 插件及市场 |
.cursor-plugin/、rules/ | Cursor 插件、市场、MCP 配置和规则 |
.grok-plugin/ | Grok Build 插件及市场 |
plugin.json、mcp.json、.agents/plugins/ | Codex / 开放 Agent 插件格式 |
gemini-extension.json、GEMINI.md | Gemini CLI 扩展 |
kimi.plugin.json | Kimi Code 插件 |
lhm.plugin.json | LobeHub |
SKILL.md、skills/ | Agent Skills(根目录的 SKILL.md = skills/seomatic/SKILL.md) |
plugins/dsh-seomatic/ | DeepSeek Harness 程序包(npm dsh-seomatic) |
server.json | 官方 MCP 注册表条目的副本(从应用仓库发布) |
nanoclaw/add-seomatic-tool.md | NanoClaw 技能(复制到 .claude/skills/add-seomatic-tool/SKILL.md) |
grok-bot/、make-app/ | Grok Bot 模板、Make 自定义应用 |
从应用同步技能
这六项 MCP 技能在 SEOmatic 应用仓库中维护。要在此处更新它们:
scripts/sync-skills.sh /path/to/seomatic-app
git diff --stat
该脚本会复制 skills/seomatic-*/SKILL.md,在应用副本没有 Paperclip 要求区块时添加该区块,并从 skills/seomatic/SKILL.md 更新根目录的 SKILL.md。GitHub Action 无法在没有跨仓库令牌的情况下完成此操作,因此请在发布前手动运行。
许可证
MIT。支持:https://seomatic.ai/contact
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。