SEO Perception

SEO Perception MCP

Search Console、サイトのクロール、SEO のタスクを、Cursor、Claude、VS Code などの MCP クライアントで利用できます。

ドキュメント · ウェブサイト · MCP レジストリ

---

このリポジトリには、MCP ディレクトリに掲載されている ホスト型 SEO Perception MCP サーバーの情報が記載されています。ドキュメントとクライアント設定のみが含まれています。ローカルにインストールしたり実行したりする必要はありません。サーバーは https://seoperception.com/mcp で稼働しています。

SEO Perception は、Google Search Console の週次データ、サイトのクロール結果、Possibilities（URL ごとに優先順位を付けた修正リスト）を保存します。MCP サーバーを使うと、AI アシスタントが同じワークスペースを参照し、推測ではなく保存された根拠に基づいて、ページの次の編集案を作成できます。

概要

エンドポイント	https://seoperception.com/mcp
トランスポート	Streamable HTTP（プレーンな JSON レスポンス）
認証	クライアントの動的登録と PKCE を使用する OAuth 2.1、または Authorization: Bearer <token> として指定する個人用アクセストークン
スコープ	mcp:read（常時）。mcp:possibilities（任意：既存のタスクを完了または無視としてマーク）
ツール	10 個。9 個は保存済みデータを読み取ります。1 個はこのスコープが付与されている場合に Possibilities を終了できます。
MCP レジストリ名	com.seoperception/mcp
サーバーカード	/.well-known/mcp/server-card.json

プラン

まず、7 日間の Starter トライアルをお試しください（MCP を含みます）。トライアル終了後は、OAuth、個人用トークン、MCP エンドポイントを利用するために、Starter、Pro、Business、または Enterprise の有効なプランが必要です。料金をご覧ください。

ツール

9つのツールが、SEO Perception によってすでに収集されたデータを読み取ります。Google にリアルタイムでアクセスすることはありません。書き込みを行うのは seoperception_update_possibilities のみです。このツールは、接続に mcp:possibilities が含まれている場合に限り、既存の Possibilities を完了または無視としてマークします。mcp:read のみを持つ接続では、何も変更できません。OAuth 接続では、両方のスコープが求められます。個人用トークンで Possibilities を完了にできるのは、トークンの作成時にその設定を有効にした場合に限られます。すでに作成済みのトークンは、引き続き読み取り専用です。

ツール	タイトル	機能
seoperception_list_sites	サイトの一覧	所有しているウェブサイトと、保存済みの GSC およびクロールの最新状況を一覧表示します。
seoperception_get_site_overview	サイトの概要	保存済みの検索パフォーマンス、主要ページ、クエリ、順位の推移をまとめます。
seoperception_search_queries	検索クエリ	コンテンツとの一致、掲載順位の範囲、インプレッション、ランディングページ、CTR、検索意図で、保存済みのクエリデータを検索・絞り込みます。
seoperception_list_opportunities	SEO の機会	保存済みの Possibilities を一覧表示します。ステータス、問題の種類、URL で絞り込むか、種類別にグループ化した概要を取得できます。
seoperception_update_possibilities	Possibilities を完了	ID、問題の種類、URL を指定して、既存の Possibilities を完了または無視としてマークします。mcp:possibilities が必要です。無視する場合は理由が必要です。
seoperception_get_page_diagnostics	ページ診断	1ページ分のクロールメタデータ、保存済みの GSC の推移、上位クエリ、Possibilities をまとめます。
seoperception_find_content_gaps	コンテンツとスニペットのギャップ	CTR の低下、クエリの欠落、タイトルやスニペット、質問、更新に関する保存済みの機会を見つけます。
seoperception_find_content_decay	コンテンツの劣化	保存済みのクリック数と掲載順位の継続的な低下を、未対応の更新候補の行から検出します。
seoperception_find_cannibalization	キーワードのカニバリゼーション	保存済みのクエリの競合と、決定論的に選ばれた優先ページを見つけます。
seoperception_suggest_internal_links	内部リンクの提案	URL をクロールしたり調査したりせずに、保存済みのリンク先とアンカーテキストの候補を返します。

ほとんどのツールでは siteId を指定します。まずサイトを一覧表示するようアシスタントに頼めば、サイト ID が自動的に設定されます。

セットアップ

OAuth に対応したクライアントでは、初回接続時にブラウザーでサインイン画面が開きます。トークンは不要です。

お使いのクライアントが OAuth に対応していない場合は、SEO Perception にサインインし、Account > MCP を開いて個人用アクセストークンを作成します（表示されるのは一度だけです）。そのトークンを環境変数 SEOPERCEPTION_MCP_TOKEN に保存し、設定の「token」版を使用してください。

Cursor

Cursor Marketplace から SEO Perception プラグインをインストールするか（掲載後）、~/.cursor/mcp.json（すべてのプロジェクト用）または .cursor/mcp.json（1つのプロジェクト用）に次の内容を追加します。

{
  "mcpServers": {
    "seo-perception": {
      "url": "https://seoperception.com/mcp"
    }
  }
}

Cursor にサーバーのサインイン画面が表示されます。トークン版：

{
  "mcpServers": {
    "seo-perception": {
      "url": "https://seoperception.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:SEOPERCEPTION_MCP_TOKEN}"
      }
    }
  }
}

Claude.ai と Claude Desktop（コネクタ）

1. Settings > Connectors を開きます。
2. Add custom connector を選択します。
3. 名前：SEO Perception。URL：https://seoperception.com/mcp。
4. Add、次に Connect をクリックし、SEO Perception のサインインを承認します。

カスタムコネクタを利用できるかどうかは、Claude のプランによって異なります。

Claude Code

claude mcp add --transport http seo-perception https://seoperception.com/mcp

次に、Claude Code 内で /mcp を実行し、Authenticate を選択します。

VS Code（GitHub Copilot エージェントモード）

プロジェクト内の .vscode/mcp.json に追加するか、コマンドパレットから MCP: Add Server を実行し、HTTP を選択します。

{
  "servers": {
    "seo-perception": {
      "type": "http",
      "url": "https://seoperception.com/mcp"
    }
  }
}

サーバーが初めて接続するときに、VS Code で OAuth サインインが開始されます。

Windsurf（Devin Desktop）

mcp_config.json に追加します（現在のビルドでは ~/.config/devin/mcp_config.json、旧バージョンの Windsurf ビルドでは ~/.codeium/windsurf/mcp_config.json）。

{
  "mcpServers": {
    "seo-perception": {
      "url": "https://seoperception.com/mcp"
    }
  }
}

サーバーに Needs auth と表示されたらサインインするか、Cursor の例のように headers ブロックを含むトークン版を使用してください。

Cline

Cline パネルで MCP Servers > Remote Servers を開き、名前に seo-perception、URL に https://seoperception.com/mcp を入力し、トランスポートに Streamable HTTP を選択してから Add Server をクリックします。または、cline_mcp_settings.json を編集します。

{
  "mcpServers": {
    "seo-perception": {
      "type": "streamableHttp",
      "url": "https://seoperception.com/mcp",
      "disabled": false,
      "autoApprove": []
    }
  }
}

"type": "streamableHttp" を明示的に設定してください。設定しない場合、Cline は従来の SSE トランスポートにフォールバックします。エージェントが実行できる手順については、llms-install.md を参照してください。

Lovable

1. Connectors を開き、+ をクリックして、MCP server を選択します。
2. サーバー名：SEO Perception。URL：https://seoperception.com/mcp。
3. OAuth のまま、Add & authorize をクリックし、サインインを承認します。

その他の MCP クライアント

URL:            https://seoperception.com/mcp
Transport:      Streamable HTTP
Authorization:  OAuth 2.1 (discovered via WWW-Authenticate), or Bearer <your MCP token>

プロンプトの例

• 「SEO Perception のサイト一覧を表示し、どのデータが最も新しいか教えてください。」
• 「保存済みデータを使って、サイトの最も大きな増加と減少を要約してください。」
• 「優先度が最も高い未対応の SEO 機会を表示し、根拠を説明してください。」
• 「SEO Perception を使って /pricing で最も大きく順位を落としたキーワードを見つけ、順位回復のための具体的なコンテンツ変更を提案してください。」
• 「表示回数が 50 回以上で、順位が 5 位から 20 位の範囲にあるものの、ランディングページに含まれていない非ブランドクエリを見つけてください。」
• 「キーワードのカニバリゼーションを見つけ、どのページを優先すべきか提案してください。」
• 「コンテンツとスニペットの最大のギャップを見つけ、順位を落としたキーワードに合う書き換えを提案してください。」
• 「ランキングの可能性があるページに向けた内部リンクと自然なアンカーテキストを提案してください。」
• 「コンテンツの劣化が顕著なページはどれですか？」
• 「下書きがファイルに保存されたら、可能性 42 を完了としてマークしてください。」

セキュリティとデータの境界

• ご自身のサイトのみ。 すべてのツールは、サインイン中のアカウントにあるウェブサイトのみを対象とします。
• 任意の書き込み操作は 1 つ。 可能性を閉じても、ウェブサイトの編集、Google への呼び出し、再クロールの開始は行われません。「完了」は次回のクロールで再び表示されることがあります。「無視」は取り消せず、理由が必要です。課題の種類または URL による変更は、確認が true になるまでプレビューされ、一度に閉じられる行は最大 25 件です。
• Google へのライブ呼び出しはありません。 ツールが読み取るのは、SEO Perception がすでに保存した Search Console の週次データ、クロールデータ、優先度順の修正リストです。データの収集は製品独自の同期処理で行われ、ツール呼び出し内では行われません。
• スコープ。 mcp:read は必須です。mcp:possibilities は任意で、ToDo を閉じる操作を許可します。OAuth Connect は両方を要求します。エディターに ToDo を閉じる権限を与える場合は、同意画面で両方を許可してください。mcp:read のみを要求するクライアントは読み取り専用です。個人用トークンは、作成時に閉じる操作を有効にしない限り、読み取り専用です。
• パスワードではなくトークンを使用してください。 MCP の設定にログインパスワードやセッション Cookie を決して入力しないでください。Account > MCP で個人用アクセストークンを作成し、取り消してください。
• クライアントのモデルプロバイダー。 MCP クライアントは、返された結果をモデルプロバイダーに送信する場合があります。サイト分析データは機密情報として扱ってください。

トラブルシューティング

• 401：再度サインインするか、Account > MCP で新しいトークンを作成し、SEOPERCEPTION_MCP_TOKEN を更新してください。
• 403 paid_plan_required：MCP を含むプランが必要です（上記のプランを参照してください）。
• 429：レスポンスに記載された再試行時間まで待ってください。
• 空のリスト：通常、そのサイトの保存済みデータがまだありません。

リンク

• ドキュメントとセットアップ：https://seoperception.com/mcp-integration
• ウェブサイト：https://seoperception.com
• 料金：https://seoperception.com/pricing
• プライバシー：https://seoperception.com/privacy
• サポート：https://seoperception.com/contact
• サーバーカード：https://seoperception.com/.well-known/mcp/server-card.json
• 公式 MCP レジストリ：com.seoperception/mcp

このリポジトリについて

このリポジトリに含まれるのは、掲載情報のメタデータ（README、server.json、glama.json、llms-install.md、Cursor プラグインのマニフェスト、ロゴ）のみです。SEO Perception アプリケーションおよび MCP サーバーのソースコードはオープンソースではなく、このリポジトリには含まれていません。

Larsik Corp（Lars Koudal）が作成しました。ドキュメントと設定ファイルはMIT Licenseのもとで公開されています。「SEO Perception」とロゴは Larsik Corp の商標です。Google および Search Console は Google LLC の商標です。SEO Perception は Google と提携しておらず、Google の承認も受けていません。