SEOmatic

AI エージェント向け SEOmatic

普段お使いの AI エージェントで、自分のウェブサイト向けの SEO エージェントを利用できます。Google Search Console の実際のデータについて質問したり、ページを監査したり、ChatGPT、 Claude、Perplexity、Google AI Overviews がサイトをどのように説明しているかを確認したり、キーワードやバックリンクを調査したり、修正案を準備したりできます。承認するまで何も公開されません。承認後、SEOmatic は WordPress、Shopify、Webflow、Wix などの連携済み CMS に公開し、変更前後の効果を測定します。

このリポジトリには、各エージェント向けのインストールファイルがすべてまとめられています。ホスト型 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 キー	設定、AI エージェント、API キー（管理者ロール）
ドキュメント	https://seomatic.ai/developers/mcp

無料の SEOmatic アカウント（OAuth または API キー）で、診断、Search Console、サイト監査、AI での可視性の結果など、すべてを閲覧できます。MCP 経由で修正案を準備するには（task_manage による作成と判断、campaign_manage）、agents:act スコープを持つキーが付与される有料プランが必要です。REST API または CLI 経由で操作するには Infrastructure プランが必要です。承認は常にお客様自身が行います。エージェントが記録するのは、お客様が下した判断のみです。

クイックスタート

Agent Skills に対応した任意のエージェント（Claude Code、 Cursor、Codex、Gemini CLI、OpenCode、Kiro など 40 以上）に、20 個の SEO スキルを追加します。

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 の数値が引用されます。常時稼働のボットをお望みですか？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 クライアント · 任意のエージェント：スキルのみ
• スキル · ツール · リポジトリの構成 · スキルを同期する

質問できること

• どのキーワードなら、検索結果の 1 ページ目にランクインできそうですか？
• 過去 28 日間でトラフィックが減少したページと、その理由を教えてください。
• サイトの SEO を全面的に監査してください。
• このトピックについて人々が尋ねたとき、ChatGPT は私のサイトに言及しますか？
• 今月獲得したバックリンクを教えてください。競合にはリンクしていて、私にはリンクしていないのは誰ですか？
• 毎週月曜日に SEO の週次レポートを作成してください。

ツールの対象はサインインしたワークスペースに限定されるため、ドメインを指定する必要はありません。

---

Claude（Web 版およびデスクトップ版）

設定、コネクタ、カスタムコネクタを追加：

• 名前：SEOmatic
• URL：https://app.seomatic.ai/api/mcp

接続をクリックし、SEOmatic にサインインします。キーは不要です。ガイド付きワークフローを利用するには、設定、機能、スキル、スキルをアップロードからスキルを追加します（skills/ 内の任意のフォルダーを zip にします）。

Claude Cowork

Cowork は Claude Code と同じプラグインを読み込みます。カスタマイズ、プラグイン、マーケットプレイスを追加を開き、Minh42/seomatic-mcp を入力してから、seomatic をインストールします。SEOmatic コネクタ（初回使用時に OAuth）と、20 個すべてのスキルが利用できます。コネクタのみを利用する場合は、Claude の手順で追加します。

Claude Code

プラグインとして（MCP サーバーと 20 個のスキル）：

/plugin marketplace add Minh42/seomatic-mcp
/plugin install seomatic@seomatic

シェルからは、同じ操作を 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 版とデスクトップ版（開発者モードを利用できるプラン）：設定、アプリとコネクタ、詳細設定で開発者モードをオンにし、作成を選択します：

• 名前：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" }
  }
}

続いて、設定、MCP で seomatic の横にある接続を選択し、サインインします。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

G r o k B o t で、週次ルーチンを実行する常時稼働の SEO チームメイトを利用できます。ワンクリックで、SEO チームメイトをインストールし、SEOmatic に一度接続します（OAuth）。すぐに使えるボットをさらに 8 個（トラフィック減少の監視、週次ブリーフ、手軽な改善策、AI での可視性、ローカル SEO、代理店レポート、コンテンツプランナー、テクニカル監視）grok-bot/templates からインストールできます。手動で作成する場合は、grok-bot/ の手順に従います。指示を貼り付け、grok-bot/SETUP.md に従って MCP サーバーに接続し（OAuth）、スキルと 3 つのルーチンを追加します。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 } }
  }
}

Gemini CLI は、2026-06-18 に個人の Google アカウント向けの提供を終了しました。Google Workspace アカウントと Gemini API キーのユーザーは引き続き利用できます。それ以外の方は Google Antigravity をご利用ください。

Gemini web（gemini.google.com）は、個人アカウントではカスタム MCP サーバーを受け付けません。Gemini CLI、または管理者が https://app.seomatic.ai/api/mcp をカスタム MCP コネクターとして追加できる Gemini Enterprise ワークスペースをご利用ください。

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 キーを使用してください。Settings、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

スキル（全20個。常に最新の状態に保たれています）：

hermes skills tap add Minh42/seomatic-mcp

または、1つずつインストールします：hermes skills install Minh42/seomatic-mcp/skills/seomatic-seo-audit。 MCP スキルでは requires_mcp_servers: [seomatic] が宣言されているため、サーバーを接続すると表示されます。seomatic CLI スキルは、読み込み時に SEOMATIC_API_KEY を尋ねます。

NanoClaw

キーは OneCLI vault に保存し、ncl のフラグには決して含めないでください。vault は 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}'

そのシークレットをグループのエージェントに割り当て（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 のエージェントが必要な手順をすべて実行できるように案内しています。これを NanoClaw のチェックアウトに .claude/skills/add-seomatic-tool/SKILL.md としてコピーし、/add-seomatic-tool を実行してください。他のエージェントにスキル CLI からインストールされないよう、skills/ の外に配置されています。ガイド付きワークフローを追加するには、skills/ の任意のフォルダーをグループのスキルにコピーしてください。

Paperclip

スキル：Skills、Import from GitHub の順に選択し、Minh42/seomatic-mcp を追加して、Find skills で SEOmatic スキルを選択し、Import を選択します。Paperclip はインポート時に、各スキルで宣言された実行要件（CLI スキルの場合は SEOMATIC_API_KEY、それ以外の場合は seomatic MCP サーバー）を表示します。SEOMATIC_API_KEY を会社のシークレットとして追加し、SEOMatic を使用するエージェントに公開してください。MCP スキルの場合は、SEOMatic MCP サーバーをエージェントのランタイムに追加します（Claude Code エージェントの場合：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）

「カスタム MCP サーバー」画面がある Cue やその他のエージェントでも、同じ 3 つの値を入力します。

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 に、https://app.seomatic.ai/api/mcp の SEOmatic 用カスタムコネクターを追加するよう依頼し、求められたら SEOmatic にサインインします。コネクター一覧に表示されたら、そこから 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" }
    }
  }
}

代わりに OAuth でサインインする場合は、headers を省略します（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 で ai.seomatic/seomatic として SEOmatic が見つかります。レジストリーのエントリーは SEOmatic アプリのリポジトリーにある server.json から公開されており、これがソースです。ここにある server.json は、ソースと同一の状態に保たれているコピーです。MCP サーバーを自動でインストールするエージェントでは、llms-install.md に従ってください。

任意のエージェント：スキルのみ

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 を操作するため、シェルコマンドを実行できる任意のエージェントで、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 サーバー	1 つのクエリで競合している自社ページと、どのページを優先すべきか
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 / オープンエージェントのプラグイン形式
gemini-extension.json, GEMINI.md	Gemini CLI 拡張機能
kimi.plugin.json	Kimi Code プラグイン
lhm.plugin.json	LobeHub
SKILL.md, 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 カスタムアプリ

アプリからのスキルの同期

6 つの MCP スキルは SEOmatic アプリのリポジトリで管理されています。ここで 最新の状態に更新するには、次のコマンドを実行します。

scripts/sync-skills.sh /path/to/seomatic-app
git diff --stat

このスクリプトは skills/seomatic-*/SKILL.md をコピーし、アプリ側のコピーに Paperclip の要件ブロックがない場合は追加して、ルートの SKILL.md を skills/seomatic/SKILL.md から更新します。リポジトリ間のトークンがないため、 GitHub Action では実行できません。リリース前に手動で実行してください。

ライセンス

MIT。サポート：https://seomatic.ai/contact