Vouched

Vouched

AI が引用できる SEO データ。Search Console、Google Analytics、キーワード、バックリンク、Google のリアルタイム検索結果、AI 回答での表示状況に対応するオープンソースの MCP サーバーです。

ウェブサイト · ツール · セルフホスト · MIT ライセンス

---

Claude、ChatGPT、Cursor に「先月、クリック数が減ったのはなぜ？」や「競合がランクインしていて、私たちがランクインしていないキーワードは？」と尋ねると、推測ではなく実際のデータに基づいて回答します。

すべてのツールは同じ JSON エンベロープを返します。含まれる各事実には、情報源、確度、観測日時が示されるため、エージェントもあなたも、Search Console の数値とインデックスの推定値を見分けられます。

2 つの実行方法

vouchedhq.com でホスト版を利用する。 AI クライアントに https://vouchedhq.com/mcp をコネクターとして追加し、サインインしてください。ご自身の Google データは無料です。リアルタイムの市場データは DataForSEO から取得し、Pro または Team プランが必要です。料金は原価で請求されます。料金をご覧ください。

セルフホストする。 ご自身の Cloudflare アカウントで、同じサーバーを実行します。独自の Google OAuth クライアントと、市場データを利用する場合は独自の DataForSEO キーを使用します。上乗せ料金はなく、当社のアカウントも不要です。docs/SELF_HOST.mdをご覧ください。

どちらも同じコードを実行し、同じツールを公開します。

ツール

ツールは 19 個あり、すべて読み取り専用です。Google やどのサイトにも書き込みは行いません。

ご自身のデータ（無料。Google への接続が必要です）

ツール	回答する内容
get_search_performance	クエリ、ページ、日付、国、デバイス別のクリック数、表示回数、CTR、掲載順位と、期間ごとの変化
inspect_indexing	この URL がインデックスされているか、Google が選択した正規 URL、最後にクロールされた日時
list_sitemaps	送信済みサイトマップと、エラー、警告、URL 数
get_website_analytics	GA4 のセッション数、ユーザー数、エンゲージメント

市場データ（DataForSEO を利用。ホスト版では Pro または Team プランが必要で、セルフホスト版では独自のキーを使用します）

ツール	回答する内容
inspect_domain	ドメインのオーガニックトラフィック、ランキングキーワード、主な競合
discover_competitors	同じキーワードでサイトと競合する相手
research_keywords	シードキーワードに関連する候補と、検索ボリューム、難易度、CPC、検索意図
inspect_keyword	1 つのキーワードの規模と難易度
inspect_serp	現在、Google でクエリにランクインしているサイトと、AI による概要などの機能
inspect_search_visibility	キーワードリストでのドメインの掲載順位
inspect_page	単一 URL のキーワードとトラフィック
compare_keyword_coverage	競合はランクインしていて、あなたはランクインしていないキーワード
inspect_backlinks	権威性、参照ドメイン、アンカーテキスト、個々のバックリンク
compare_backlink_gap	あなたではなく競合にリンクしているサイト
discover_ai_citations	あるトピックについて、AI の回答が引用しているサイト
inspect_ai_visibility	競合と比較した、AI の回答でのドメインの言及頻度

ユーティリティ

ツール	内容
describe_capabilities	このサーバーで有効な機能と、各ツールの料金
list_websites	トラッキング対象のウェブサイトと Google への接続
export_dataset	省略されたレスポンスの全結果。7 日間保存されます

各ツールの入力、出力、レスポンス例は、vouchedhq.com/toolsの専用ページで確認できます。自動生成されたリファレンスはdocs/TOOLS.mdにあります。

データの取得元

Vouched 独自の検索インデックスやウェブクローラーはありません。Vouched が構築・運用しているのは MCP サーバーです。具体的には、サインイン、レスポンスエンベロープ、すべての事実に付与される出所と信頼度、キャッシュ、期間比較、エクスポート、課金を担います。ツールが扱うデータは、Google アカウントまたは DataForSEO から取得します。

ツール	上流 API	provenance のソースクラス
get_search_performance、inspect_indexing、list_sitemaps	Google Search Console API（Search Analytics、URL Inspection、Sitemaps）。ご自身の Google サインインで読み取ります	webmaster_console
get_website_analytics	Google Analytics Data API（GA4）。同じサインインを使用します	analytics_property
inspect_domain、discover_competitors、research_keywords、inspect_keyword、inspect_page、compare_keyword_coverage	DataForSEO Labs API	search_index
inspect_serp	DataForSEO SERP API（Google のリアルタイム検索結果）	live_serp
inspect_search_visibility	DataForSEO Labs API。順位のリアルタイム再確認を指定した場合は SERP API も使用します	search_index、live_serp
inspect_backlinks、compare_backlink_gap	DataForSEO Backlinks API	backlink_index
discover_ai_citations、inspect_ai_visibility	DataForSEO AI Optimization API（Google AI Overviews または ChatGPT の LLM Mentions）	ai_answer
describe_capabilities、list_websites、export_dataset	なし。Vouched 独自のデータです	なし

ホスト型の Pro および Team プランでは、市場データの呼び出しは Vouched の DataForSEO アカウント経由で行われ、プランに含まれる市場データの利用分として、DataForSEO の料金で課金されます（料金を参照）。セルフホスト環境では、ご自身の DataForSEO キーを使用します。DataForSEO に送信されるのは、リクエストで指定されたキーワード、ドメイン、URL のみで、Google のデータが送信されることはありません。

レスポンスの例

get_search_performance の結果を簡略化したものです。

{
  "schema_version": "ofe/1.0",
  "domain": "gsc",
  "data": { "domain": "xmit.sh", "startDate": "2026-08-28", "endDate": "2026-09-24", "dimensions": ["query"] },
  "facts": [
    {
      "type": "gsc.query_performance",
      "subject": ["property:...", "keyword:any:GLOBAL:transactional email api"],
      "data": { "dimensions": { "query": "transactional email api" }, "clicks": 41, "impressions": 3120, "ctr": 0.013, "position": 8.2 },
      "provenance": {
        "source_class": "webmaster_console",
        "method": "gsc.searchAnalytics.query",
        "confidence": 1,
        "observed_at": "2026-09-25T08:00:00Z",
        "cache_hit": false
      }
    }
  ],
  "deltas": [{ "fact_type": "gsc.query_performance", "field": "clicks", "previous": 29, "current": 41 }],
  "coverage": { "returned": 25, "total": null, "scope_note": "capped at 25 rows; more are available via export_dataset" },
  "resources": [{ "uri": "mcpseo://gsc/...", "description": "Up to 1000 rows for this same query" }],
  "next_actions": []
}

deltas は前の期間との比較を示し、coverage は結果に含まれない内容を示します。resources には残りのデータが含まれ、next_actions は有用な後続の呼び出しがある場合に提案します。完全な構造は docs/OFE_ENVELOPE.md を参照してください。

クライアントを接続する

ホスト型の場合：

# Claude Code: the plugin (MCP server plus an SEO analysis skill)
claude plugin marketplace add muditjuneja/vouched
claude plugin install vouched@vouched

# Claude Code: the MCP server only
claude mcp add --transport http vouched https://vouchedhq.com/mcp

# Gemini CLI
gemini extensions install https://github.com/muditjuneja/vouched

Claude または ChatGPT で、https://vouchedhq.com/mcp をカスタムコネクターとして追加します。Cursor の場合は、~/.cursor/mcp.json に追加します。

{ "mcpServers": { "vouched": { "url": "https://vouchedhq.com/mcp" } } }

初回起動時に、クライアントからサインインページが開きます（標準的な MCP OAuth）。ヘッダーしか送信できないクライアントでは、代わりにダッシュボードで API キーを発行して使用できます。

セルフホストの場合は、クライアントの接続先に Worker の /mcp URL とベアラートークンを指定してください。docs/SELF_HOST.md を参照してください。

開発

npm install
cp .dev.vars.example .dev.vars   # MCP_BEARER_TOKEN at minimum
npm run db:migrate:local
npm run dev                      # http://localhost:8787/mcp

npm test
npm run typecheck
npm run lint

開発中は DATAFORSEO_BASE_URL=https://sandbox.dataforseo.com を設定してください。DataForSEO のサンドボックスは無料で、実際のレスポンスと同じ形式のダミーデータを返します。

Cloudflare Workers、Hono、D1、R2、KV を基盤に構築されています。Google SDK は使用せず、Google API を直接呼び出します。

ドキュメント

• セルフホスト
• アーキテクチャ
• レスポンスエンベロープ
• ツールリファレンス
• ホスト型サービスの内部構造 とデプロイ方法

プライバシー

Google のデータは、リクエストがあった場合にのみ読み取られ、Google の限定的な利用に関する要件に従って取り扱われます。販売、広告への利用、AI モデルのトレーニングに使用されることはありません。プライバシーポリシーを参照してください。

コントリビューションとサポート

Issue やプルリクエストを歓迎します。ホスト型サービスについては、[email protected] までメールでお問い合わせください。

ライセンス

MIT