mcpField
S
SEOmatic

SEOmatic

远程服务
seomatic.ai商业与营销12 周前更新

关于 SEOmatic

SEOmatic 是面向 Agent 的托管 SEO MCP 服务,为网站运营者提供 Search Console 数据、页面审计、关键词与反向链接研究及 AI 可见度检查。网站修改须先获批准,之后才能发布到已连接的 CMS 并衡量效果。

主要功能

  1. 01Search Console 表现洞察
  2. 02页面审计与关键词研究
  3. 03反向链接和 AI 可见度分析
  4. 04暂存并审批网站修改
  5. 05衡量已发布修改效果

适用场景

  1. 01查找接近搜索结果首页的页面
  2. 02调查流量下降和 SEO 问题
  3. 03检查品牌在 AI 答案中的提及
  4. 04发布前审核网站修改

MCP 相关

托管的 Streamable HTTP 服务端点 `https://app.seomatic.ai/api/mcp` 向兼容客户端提供 SEO 数据和网站操作工具。可使用 OAuth 2.1 或 Bearer API 密钥;暂存操作须经批准才能生效。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://app.seomatic.ai/api/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

2
参数类型必填说明
sitestring是用户自己的网站,例如 example.com

详细介绍

SEOmatic

面向 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 APIhttps://app.seomatic.ai/api/v1
CLInpm 上的 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 模板。

目录

你可以询问的内容

  • 我有哪些关键词快要排进搜索结果第 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。


技能

技能需求功能
seomaticCLI + SEOMATIC_API_KEY通过 npx -y seomatic 完成所有操作:Search Console、审计及任何工具
seomatic-seo-auditMCP 服务执行完整审计,并生成按优先级排序的修复列表
seomatic-striking-distanceMCP 服务第 2 页查询、点击提升空间,以及待分阶段实施的修复
seomatic-weekly-briefMCP 服务简短的周一简报,概述变化
seomatic-ai-visibility-reviewMCP 服务AI 答案如何展示你的品牌,以及跟踪的提示词
seomatic-ai-citationsMCP 服务AI 引用和 AI 引荐的第一方证据
seomatic-approval-workflowMCP 服务审核已暂存的工作、批准或驳回,并回滚
seomatic-traffic-dropMCP 服务流量下降的原因:季节性、页面、索引和竞争对手
seomatic-ctr-fixMCP 服务有排名但失去点击的页面;新的标题和元数据
seomatic-content-refreshMCP 服务流量衰退的页面,以及每个页面的具体需求
seomatic-cannibalizationMCP 服务自有页面争夺同一查询,以及应该由哪个页面胜出
seomatic-indexing-checkMCP 服务检查关键页面的 URL,每项状态都以通俗语言说明
seomatic-internal-linkingMCP 服务从强势页面添加上下文链接,指向接近第 1 页排名的页面
seomatic-keyword-researchMCP 服务从你自己的 Search Console 获取关键词,并映射到对应页面
seomatic-content-briefMCP 服务根据实时搜索结果生成简报,并在发布前为草稿评分
seomatic-competitor-gapMCP 服务真正排名超过你的竞争对手,以及他们胜出的关键词
seomatic-backlink-auditMCP 服务判断权威度是否构成瓶颈,并寻找真实的链接机会
seomatic-local-seoMCP 服务商家资料、评价、地图包和位置页面
seomatic-ai-crawlersMCP 服务哪些 AI 机器人会抓取你的网站、哪些内容被屏蔽,以及从抓取到引用的情况
seomatic-client-reportMCP 服务根据真实数据生成客户或老板的月度报告

每项技能都遵循相同规则:数字仅来自工具结果,日期范围按原样引用,未经你批准,任何内容都不会上线。

工具

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.jsonClaude 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.mdGemini CLI 扩展
kimi.plugin.jsonKimi Code 插件
lhm.plugin.jsonLobeHub
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.mdNanoClaw 技能(复制到 .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

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。