seoscoreapi-mcp

SEO Score API — Model Context Protocol サーバー

Claude Desktop、Claude Code、Cursor、Windsurf、または MCP 対応の AI ツールから、SEO Score API に直接アクセスできます。包括的な監査、バックリンクデータ、モニタリング、履歴を利用できます。

クイックスタート

npx -y seoscoreapi-mcp

API キーを一度設定すれば、あとはそのまま使えます。

export SEO_SCORE_API_KEY="ssa_your_key_here"

（https://seoscoreapi.com で無料のキーを取得できます。カードは不要です。）

公開されるツール

ツール	内容	プラン
audit	URL の SEO を包括的に監査します。スコア、評価、80 項目以上のチェック、AI の読み取りやすさ、優先順位付きの修正項目を提供します。include_core_web_vitals: true を指定すると、測定済みの LCP、INP、CLS が追加されます（約 10 秒長くかかり、キーが必要です）	Free
batch_audit	一度に最大 10 個の URL を監査します（include_core_web_vitals は任意）	Starter ($5/mo)
usage	現在のプラン、月間利用状況、残りの利用枠	Free
report_url	ドメインの公開共有可能な HTML レポート	Free
add_monitor	定期的な再監査とアラートの対象に URL を追加します	Starter
list_monitors	監視対象の URL の一覧	Starter
history	URL の過去のスコア推移	Starter
history_domains	このキーで監査したすべてのドメインと、過去 30 日間の推移	Starter
backlinks	ドメインで観測された被リンク（監査データに基づくグラフ。すべての応答でデータに関する注意事項を明記）	Basic ($15/mo)
deep_audit	詳細なサイト監査：9 つの観点、数千件のカタログチェック、最大 150 件の AI チェック。結果が出るまで待機します（timeout_seconds のデフォルトは 600）	Pro ($39/mo)、Ultra、またはクレジット
start_deep_audit	詳細なサイト監査をキューに登録し、すぐに job_id を返します（webhook_url は任意）	同上
get_deep_audit	詳細なサイト監査ジョブのステータス。完了後は result を含みます	同上
deep_audit_usage	今月使用した詳細なサイト監査の回数と残りの回数	同上
remove_monitor	スコア監視から URL を削除します	Starter
compare	2～5 個の URL を構造化して比較します	Basic ($15/mo)
competitive_audit	キーワードに対する競合ページとの直接比較	Pro ($39/mo)
accessibility_audit	ADA / WCAG 2.1 AA 監査：スコア、訴訟リスク、修正案付きの違反項目（include_trackers は任意）	有料プラン。月間利用枠あり
ai_readability	AI／LLM システムがページをどれだけ読み取れるかを確認します	すべてのキー
trackers	ページが読み込むサードパーティのトラッカーとピクセル	すべてのキー（監査 1 回）
conversion	コンバージョンスコア：見出し、CTA、信頼性、フォーム、懸念事項	すべてのキー（監査 1 回）。修正項目の全一覧は有料プランで利用可能
quick_wins	Search Console のデータ行、または渡された CSV から 2 ページ目の改善機会を特定します	すべてのキー（監査 1 回）
llms_txt	ドメイン用の llms.txt ファイルを生成します	キー不要。厳選版は Basic 以上
geo_audit	GEO 監査：LLM に対するページの可視性を確認します	Basic
geo_brand_probe	LLM がブランドに言及する頻度を確認します	Basic
add_geo_monitor / list_geo_monitors / geo_monitor_history / remove_geo_monitor	GEO 監視	Basic
crawl_site	複数ページのサイトをクロールします（リンク切れのページ、リダイレクト、重複ページ、孤立ページ、表示の遅いページ）。結果が出るまで待機します	Pro、Ultra、または詳細監査クレジット
start_crawl / get_crawl	クロールを開始し、自分で状況を確認します	同上
citation_starter_prompts / citation_suggest_prompts	AI の引用を追跡するためのプロンプト	すべてのキー。利用回数に含まれません
create_citation_tracker / list_citation_trackers / get_citation_tracker / update_citation_tracker / delete_citation_tracker	ChatGPT、Gemini、Perplexity、Claude におけるブランドの言及を追跡します	Starter ($5/mo)
run_citation_tracker / get_citation_run / citation_tracker_history	トラッカーを実行し、実行結果を確認し、推移を確認します	Starter。チェック回数に含まれます
citation_check	ブランドと 1 つのプロンプトに対する単発の引用チェック	有料プラン。チェックごとに利用回数に含まれます
citation_topups	追加購入パックとアカウントのチェック残高	すべてのキー
citation_topup_checkout	追加購入パック用の Stripe Checkout リンク（ユーザーが支払うまで料金は発生しません）	有料プラン
citation_auto_reload	自動追加購入の設定を確認します	すべてのキー。読み取り専用

意図的に公開していない機能

• レポートファイル（GET /audit/export）：PDF はバイナリ形式ですが、MCP ツールの結果はテキストです。 audit ツールは同じデータを JSON として返します。ファイルを取得する場合は REST API または Python／Node SDK （audit_export／auditExport）を使用してください。
• 自動リロードを有効にする操作。 API キーに関するこの種のエンドポイントは API にありません。課金を承認するため、ダッシュボードからのみ設定できます。citation_auto_reload はこの設定を読み取ります。
• アカウント操作（/signup、/verify、/upgrade、/rotate-key）および公開スコアボードのオプトアウト。

設定

環境変数	デフォルト	用途
SEO_SCORE_API_KEY	（なし）	API キー
SEO_SCORE_BASE_URL	https://seoscoreapi.com	API ホスト
SEO_SCORE_DEEP_AUDIT_URL	SEO_SCORE_BASE_URL	Deep Audit ホスト（POST /site-audit、GET /site-audit/{job_id}、GET /deep-audit/usage）。SEO_SCORE_ENGINE_URL も引き続きフォールバックとして読み取られます。従来の https://engine.seoscoreapi.com も引き続き使用できます。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（Mac）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を編集します。

{
  "mcpServers": {
    "seoscoreapi": {
      "command": "npx",
      "args": ["-y", "seoscoreapi-mcp"],
      "env": {
        "SEO_SCORE_API_KEY": "ssa_your_key_here"
      }
    }
  }
}

Claude Desktop を再起動します。ツールピッカーに SEO Score のツールが表示されます。

Claude Code

claude mcp add seoscoreapi -e SEO_SCORE_API_KEY=ssa_your_key_here -- npx -y seoscoreapi-mcp

Cursor

Cursor の「Settings」→「MCP Servers」を開き、上記の Claude Desktop と同じ JSON 形式で新しいサーバーを追加します。

Windsurf

「Settings」→「Cascade」→「MCP Servers」を開き、同じ設定を貼り付けます。

その他の MCP クライアント

npx -y seoscoreapi-mcp を stdio トランスポートとして実行します。このサーバーは標準の MCP を使用し、上記の表にあるすべてのツールを公開します。

プロンプトの例

インストールしたら、AI アシスタントに自然な言葉で話しかけてください。

「https://stripe.com を監査して、修正すべき上位 3 つの項目を教えてください。」

「stripe.com、square.com、adyen.com を一括監査して、AI の読みやすさスコアを比較してください。」

「my-startup.com を指している被リンクには、どのようなものがありますか？」

「過去 30 日間のマーケティングサイトのスコア履歴を確認してください。」

「my-startup.com を SaaS サイトとして詳細監査し、重大度の高い指摘事項を一覧表示してください。」

「料金ページのアクセシビリティ監査を実行し、重大な WCAG 違反を一覧表示してください。」

「my-startup.com をクロールして、リンク切れと孤立ページを表示してください。」

「『SEO audit API』のスタータープロンプトを作成し、Acme の引用トラッカーを作成して、実行してください。」

AI が選択したツールはクライアントに表示されます。「どのツールを使いましたか？」と尋ねれば、いつでも実行の詳細を確認できます。

MCP を使う理由

MCP を使うと、カスタムの連携なしで、AI がこれまでアクセスできなかったデータ（実際のサイトの SEO スコア、被リンクグラフ、監視履歴など）にアクセスできます。「この URL を監査して」というプロンプトは、アイデアから結果まで 1 回のラウンドトリップで完了します。REST API と同じ信頼できる情報源を使うため、ツール間でスコアをコピーする必要はありません。

正確な説明

backlinks ツールが返すのは、監査データに基づくサンプルであり、網羅的な被リンクインデックスではありません。各レスポンスには、データセットの内容を正確に説明する data_caveat が含まれます。私たちは Ahrefs ではなく、そのふりをするつもりもありません。お客様の監査によって無料で構築される、独自の成長中のグラフを公開しています。

ソース

MCP サーバーはオープンソースです：https://github.com/SeoScoreAPI/seoscoreapi-mcp

ライセンス

MIT