Google Search MCP Server (SERP)

ホスト型の Model Context Protocol (MCP) サーバーです。Claude、Cursor、Windsurf、その他あらゆる MCP クライアントに、読み取り専用の Google 検索ツールを8つ提供します。AI Overview や People Also Ask を含むライブの SERP を取得し、Google AI Mode のクエリを実行し、ニュース、ショッピング、商品詳細、ショート動画の結果をすべて構造化 JSON として読み取れます。Google Cloud プロジェクトも検索エンジンのセットアップも不要です。

https://mcp.hasdata.com/api/mcp?apis=google_serp

ここでは「SERP」と「Google Search」は同じプロダクトを指します。このサーバーは、Google の検索エンジン結果ページをパースして返します。

目次

• 必要なもの

• クイックスタート

• プロンプト例

• ツール

• エラーと失敗の経路

• 料金、無料枠、制限

• ツールの選び方

• 他との比較

• FAQ

• HasData へのリンク

• 開発

• コントリビュート

• ライセンス

Related MCP server: Serper Search MCP Server

必要なもの

カスタムヘッダーを送信できる streamable HTTP 対応の MCP クライアントと、ダッシュボード から取得する HasData API キーです。キーはカード登録なしで無料で作成でき、トライアルではツールにもよりますが約100〜200回の呼び出しを利用できます。これ以外は何も必要ありません。リモートサーバーなので、最短のセットアップは URL とヘッダーを設定するだけです。Google Cloud プロジェクトや Programmable Search Engine の準備は不要です。stdio 専用クライアントの場合は、代わりに @hasdata/google-search-mcp（npm）または hasdata-google-search-mcp（PyPI）のランチャーが使えます。

クイックスタート

サーバー URL はどのクライアントでも同じです。このサーバーは Claude Code と Claude Desktop で実際に動作確認しています。以降の各ブロックは、各クライアント公式のリモートサーバー設定形式に準じています。

OAuth に対応したクライアントでは、同じ URL をコネクタとして追加し、設定ファイルにキーを書かずにサインインできます。

claude mcp add --transport http google-search "https://mcp.hasdata.com/api/mcp?apis=google_serp" \
  --header "x-api-key: HASDATA_API_KEY"

Claude Desktop は設定ファイルからローカル（stdio）サーバーのみを読み込むため、リモートサーバーへは stdio ランチャー経由で接続します。@hasdata/google-search-mcp パッケージがそのランチャーで、環境変数からキーを読み取ります。

claude_desktop_config.json:

{
  "mcpServers": {
    "google-search": {
      "command": "npx",
      "args": ["-y", "@hasdata/google-search-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

Node ではなく Python を使う場合は、ランチャーを PyPI パッケージに差し替えてください。uvx なら手動インストールなしで実行できます。

{
  "mcpServers": {
    "google-search": {
      "command": "uvx",
      "args": ["hasdata-google-search-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

OAuth 対応クライアントの場合は、代わりに URL をカスタムコネクタとして追加すれば、ランチャーを介さずに済みます。

.cursor/mcp.json:

{
  "mcpServers": {
    "google-search": {
      "url": "https://mcp.hasdata.com/api/mcp?apis=google_serp",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "google-search": {
      "serverUrl": "https://mcp.hasdata.com/api/mcp?apis=google_serp",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "google-search": {
      "url": "https://mcp.hasdata.com/api/mcp?apis=google_serp",
      "type": "streamableHttp",
      "headers": { "x-api-key": "HASDATA_API_KEY" },
      "disabled": false
    }
  }
}

.vscode/mcp.json:

{
  "servers": {
    "google-search": {
      "type": "http",
      "url": "https://mcp.hasdata.com/api/mcp?apis=google_serp",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

~/.gemini/settings.json:

{
  "mcpServers": {
    "google-search": {
      "httpUrl": "https://mcp.hasdata.com/api/mcp?apis=google_serp",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

プロンプト例

Google で best running shoes を検索して、オーガニック検索の上位10件と AI Overview をまとめてください。

1回の呼び出しで10クレジットです。SERP レスポンスには、オーガニック結果と並んで AI Overview がインラインで含まれます。

同じクエリについて、People Also Ask の各質問を取得し、その AI Overview の回答をソース付きで取得してください。

質問ごとに1回の呼び出しで、それぞれ5クレジットです。各 relatedQuestions エントリには aiOverview.pageToken が含まれ、AI Overview ツールがそのトークンを回答ブロックと参照に展開します。

Google AI Mode に what is the Model Context Protocol と質問して、引用付きの回答を教えてください。

1回の呼び出しで10クレジットです。AI Mode は、生成された回答を参照リスト付きのテキストブロックとして返します。

Google ショッピングで nike air max を検索し、トップ結果の完全な商品カード（販売ストア、価格帯、レビュー内訳）を取得してください。

2回の呼び出しです。ショッピングは10クレジットで商品ごとのトークンを返し、イマーシブ商品ツールが5クレジットでそのトークンをストア、バリエーション、レビューに展開します。

artificial intelligence に関する最新の Google News と、cooking pasta のショート動画結果をそれぞれ取得してください。

2回の呼び出しで、それぞれ10クレジットです。

このワークフローは、主に2つのチェーンで成り立っています。SERP レスポンスは aiOverview をインラインで、People Also Ask の各質問には pageToken を付けて返すため、Google の生成回答を取り出すのは、検索結果に含まれている場合は無料、質問ごとの 5クレジット のフォローアップであれば1回で済みます。ショッピング結果にも商品ごとのトークンが付いてくるため、リストから複数ストアの商品カードへ移動するのも、1回の呼び出しで済みます。

ツール

読み取り専用のツールが8つあります。以下のサンプルは実際の呼び出し結果を抜粋したもので、中身は Google の変更に応じて変わります。あくまで形の参考として見てください。各ツール名はエンドポイントのリファレンスへのリンクです。

サンプルはレスポンス全体ではなく、ペイロードです。tools/call の結果は1つのテキストブロックを持ち、そのテキスト自体が url、status、text、json を含む JSON で、スクレイプしたデータは json に入ります。生の JSON-RPC レスポンスから取得する場合は、result.content[0].text をパースした後の .json にたどり着停です。チャットクライアントは内部でそれを自動的に開きますが、エンドポイントに直接接続するコードでは自分で行う必要があります。

Google SERP

hasdata_google_serp_serp_getSearchResults

クエリに対する検索結果ページ全体を返します。

戻り値は、Google がそのクエリに表示するブロックに応じで、searchInformation、organicResults、aiOverview、relatedQuestions、relatedSearches、perspectives、immersiveProducts、pagination です。オーガニック検索結果の各項目には、position、title、link、displayedLink、source、snippet、snippetHighlitedWords、date、images が含まれます。

AI Overview の取得方法は2つあります。通常は aiOverview がインラインで返り、textBlocks と references を直接読めます。Google がトークンの後ろに置くこともあり、その場合は aiOverview にブロックではなく pageToken と hasdataLink が含まれます。relatedQuestions の各項目も、後者のケースで、各エントリに question と、同じ pageToken と hasdataLink を持つ aiOverview が入り、後述の AI Overview ツールで展開します。つまり People Also Ask の回答は、トークンを1つずつ取得する AI Overview です。トップレベルの aiOverview は、ほとんどのクエリでインライン、一部ではトークンになるため、両方の形で読めることを想定してください。

{
  "organicResults": [
    {
      "position": 1,
      "title": "The 15 Best Running Shoes of 2026",
      "link": "https://www.runnersworld.com/gear/a19663621/best-running-shoes/",
      "source": "Runner's World",
      "snippet": "The Brooks Ghost is our No. 1 shoe when we recommend new trainers…"
    }
  ],
  "aiOverview": {
    "textBlocks": [ { "type": "paragraph", "snippet": "The best running shoes depend on your goal…" } ],
    "references": [ { "index": 0, "title": "7 Best Running Shoes in 2026 - RunRepeat", "link": "https://runrepeat.com/guides/best-running-shoes" } ]
  },
  "relatedQuestions": [
    { "question": "What are the top 5 best running shoes?", "aiOverview": { "pageToken": "eyJpZCI6…", "hasdataLink": "https://api.hasdata.com/scrape/google/ai-overview?pageToken=eyJpZCI6…" } }
  ],
  "pagination": { "next": "…" }
}

Google AI Overview

hasdata_google_serp_ai_overview_getAiOverviewResponse

AI Overview のトークンを、その回答へ展開します。

textBlocks と references を含む aiを返します。SERP がブロックではなくトークンを使う場合の AI Overview を読む方法がこれで、People Also Ask の各質問を引用付き回答に変換するのもこのツールです。

トークンの有効期限は約4分です。無効期限が切れたトークンが返されることはなく、ツールエラーとして失敗します。isError: true と、テキスト HasData API error: 400 Bad Request が返ります。キー違いと同様に処理して、SERP を再実行して新しいトークンを取得してください。

{
  "aiOverview": {
    "textBlocks": [ { "type": "paragraph", "snippet": "The top five running shoes feature versatile options for daily training and racing…" } ],
    "references": [ { "index": 0, "title": "…", "link": "https://…" } ]
  }
}

Google AI Mode

hasdata_google_serp_ai_mode_getAiModeResponse

クエリに対する Google 検索の AI モードの回答、つまり会話形式の検索結果です。

textBlocks と references が返ります。生成された回答と、その回答が引用する出典です。

Google SERP Light

hasdata_google_serp_serp_light_getSearchResults

ページの主要部分を返す、より低コストな検索です。

organicResults、aiOverview、relatedSearches、filters、appliedLocation、searchInformation、pagination を返します。オーガニック検索結果とAI Overviewだけを追加ブロックなしで取得したい場合に利用でき、フルSERPの半分のクレジットで済みます。

Google News

hasdata_google_serp_news_getGoogleNews

クエリまたはニュースセクションに対するGoogle Newsの結果です。

newsResults、menuLinks、relatedTopics、relatedPublications を返します。各ニュース項目には position、title、link、name と icon を持つ source、thumbnail、date が含まれます。

Google Shopping

hasdata_google_serp_shopping_getSearchResults

クエリに対するショッピング結果です。

shoppingResults、filters、refineSearchFilters、searchInformation、pagination を返します。各結果には position、title、productId、price、extractedPrice、rating、rews、source、category、thumbnail、immersiveProductPageToken が含まれます。

immersiveProductPageToken は、以下のイマーシブ商品ツールへの入力です。一時的なトークンなので、商品データを取得したい場合は有効である間に展開してください。また、古いトークンが失敗した場合はショッピングを呼び直して新しいトークンを取得してください。

{
  "shoppingResults": [
    {
      "position": 1,
      "title": "Men's Nike Alphafly 3",
      "productId": "13366226642799457284",
      "price": "$285.00",
      "extractedPrice": 285,
      "rating": 4.5,
      "reviews": 120,
      "source": "Nike",
      "immersiveProductPageToken": "eyJyZHMiOiJQQ18…"
    }
  ]
}

イマーシブ商品

hasdata_google_serp_immersive_product_getImmersive_e29f691177

ショッピング結果の背後にある完全な商品カードです。

productResults オブジェクトを返します。それには title、brand、rating、reviews、priceRange、各販売者とその価格・リンクを含む stores 配列に加えて、variants、reviewsImages、userRews、topInsights、aboutTheProduct、discussionsAndForums が含まれます。この1回の呼び出しで、単一の商品一覧から全ストア横断の全体像を取得できます。

{
  "productResults": {
    "title": "Men's Nike Alphafly 3",
    "brand": "Nike",
    "rating": 4.4,
    "reviews": 1077,
    "priceRange": "$221-$295",
    "stores": [ { "name": "eBay", "link": "https://www.ebay.com/itm/…", "price": "$221" } ],
    "storesNextPageToken": "Mw=="
  }
}

storesNextPageToken を nextPageToken パラメータとして再入力すると、店舗一覧をページ送りできます。

短い動画

hasdata_google_serp_short_videos_getShortVideosSearchResults

クエリに対してGoogleが表示するショート動画の結果です。

Returns shortVideos.CassandVideos を返します。各動画は position、title、link、source、sourceLogo、profileName、duration、clip、thumbnail を含みます。

エラーと失敗パターン

クライアントがツール呼び出しで HTTP エラーコードを目にすることはほとんどありません。MCP レイヤーは 200 で応答し、失敗を結果の中に isError: true と理由のテキストとして混入します。ステータス行を期待した場所に、エージェントはメッセージを読み取ることになります。

**キーの間違いは接続失敗ではなくツール出力に現れます。**ツール一覧の取得は空でないキーをすべて受け入れるため、クライアントはハンドシェイクを成功と表示します。その後、最初のツール呼び出しが hasError: true と HasData API error: 401 Unauthorized を返して初めて問題が現れます。というのも、フックの中ではそれよりも早く問題を報告する場所がないため、この文字列を見つけてください。

本物の HTTP エラーが発生するのは、キーが存在しない場合だけです。認可はあらゆるツールよりまえに実行され、接続そのものが 401 で失敗します。

スキーマに反するホールでは、検索になる前に拒否されます。q のない検索は、isError: true とフィールド名を示す MCP error -32602: Input validation error を返します。何もフェッチされず、課金もされません。

**期限切れのAI Overviewトークンはエラーとして失敗します。**SERP レスポンスのトークンには約4分の有効期間があります。保存してあった古いトークンを展開しようとすると、isError: true と、キー違いの場合と同じ形の HasData API error: 400 Bad Request が返ります。問題をキャッチしたら SERP を再実行して新しいトークンを得てください。

**Google が表示しなかったブロックは、空のキーではなく、キー自体がありません。**AI Overview、ショッピングパネル、People Also Ask がないクエリでは、レスポンスはこれらのキーを含まずに返ります。読み出す前にキーがあるかを確認してください。

データを含む結果には、サポートで引用する価値のある requestMetadata.id に加えて、その呼び出しそのものを保存したアーティファクトへの html と json のリンクも含まれます。

料金・無料枠・制限

クレジットはツールごとに使います。フルSERP、AI Mode、ニュース、ショッピング、ショート動画は、1回の呼び出しにつき 10クレジット です。SERP Light、イマーシブ商品、AI Overviewツールは 5クレジット です。SERPのレスポンスにインラインで含まれるAI Overviewは、その10クレジットの呼び出しに含まれ、無料です。一方、AI Overviewツールでトークン展開する呼び出しは、すべてのPeople Also Askのトークも、別枠の5クレジットとして消費されます。レスポンスのサイズによって価格は変わりません。

無料トライアルは カード不要で30日間・1,000クレジット です。これはフルSERPなら100回、5クレジットのツールなら200回分です。有効なアカウントは、残高が100を下回ると毎日100クレジットが補充されるため、量の少ないエージェントは無周期で無料枠に乗り続けられます。

有料プランは 月額$49（200,000クレジット） からです。クレジット単価は利用量に応じて下がります。最新の数字は Pricingページにあります。

プランは同時接続数も決定します。無料トライアルは同時1 リクエスト、Startup は15、Growth は50 と、Businessは30、高容量プランでは200〜1,500まで実行できます。レート制限には同時接続数のみで、1分あたりのリクエスト数のキャップはありません。無人実行のワークフローではオーバーフローのケースを防御的に処理してください。クエリを指数関数的にファンアウトするエージェントは、あなたが手を打つ前に上限に到達するからです。

ツール選択

?ていis=google_serp はこの8つのツールを公開します。パラメータはリストを受け付けます。?addの google_serp,google_maps では、Googleマップのツールを検索と並行して使えます。パラメータを省略すると、HasDataが現在公開している全ツール（数57個）が使えます。

リストは絞り込む方が通常は優れています。8つのツールの中から選ぶモデムのつぎに、五十七すでです方から選ぶモデルよりも正しい選択率が上がり、ツールの説明文自体も毎ターンコンテキストを消費します。

その他公式制限点

Google にはもはや汎用検索API はありません。公式ルートは Custom Search JSON API ですが、これはこのサーバの検索問いとは異なるものです。

Custom Search JSON API は、あなたが設定する「 Programmable Search Engine 」を対象に、指定したサイトや、全ウェブインデックスを使うとその全体を検索します。無料の 1 日 100 クエリに制限され、それを超えると 1,000 クエリごとに課金されます。また、帰ってくる結果セットは削り取っています。そして、AI Overview、People Also Ask、ローカルパック、ニュース、ショッピング、そのほかのso-calledはAPIではなくライブ検索結果ページの機能であり、APIはそれらを返しません。自分のサイトや固定したサイト集合だけを、Google公式の条件の範囲内で検索したい場合は、こちらが適切です。

このサーバーは、訪問者の目に見えるGoogleの結果ページを取得し、構造化に分割します。設定の必要なものはなく、クエリはカスタムエンジンではなくGoogle全体に対して実行されます。またAI Overview、People Also Ask、ショッピングなどを構文化して返します。

これは2行で判断できます。自分自身のサイトだけを検索したい、Google公式APIが必要という場合は Custom Search JSON API が合います。一方、本物のSERP、そのAI Overview、Googleが検索者に表示するくくりそのものが必要ならやそれらは公式APIにはなく、このサーバーで取得できます。

**このサーバーが提供しないもの。**結果ページの背後にあるページのクロール、順位履歴、何かの書き込み。は一切ありません。解析済みの結果ページだけを返します。

FAQ

Google Search MCPサーバーとは?

Google の検索結果を、AI クライアントが呼び出せるツールとして公開するサーバーです。クライアントは Model Context Protocol 経由でツール呼び出しを送信し、サーバーは結果ページを取得して構造化 JSON を返します。モデルは結果を扱うだけで、HTML ページを見ることはありません。このサーバーは読み取り専用ツールを 8 つ公開し、リモートで実行されます。クライアントは URL に接続するだけでよく、ローカルプロセスを起動する必要はありません。

ここで言う「SERP」は Google Search と同じ意味ですか？

はい、同じです。SERP とは検索エンジンの結果ページ（Search Engine Results Page）の略です。これらのツールは Google の結果ページを返すため、このリポジトリでは「SERP API」と「Google Search API」は同じものを指します。

公式の Google Search MCP サーバーはありますか？

Google は MCP サーバーも一般的な検索 API も公開していません。最も公式に近いのは Custom Search JSON API で、これは自分で設定した Programmable Search Engine を検索します。このサーバーを含むいくつかのコミュニティ MCP サーバーは、代わりに実際のライブな結果ページを返します。

AI Overview を取得するにはどうすればよいですか？

SERP 呼び出しを実行してください。aiOverview は通常、textBlocks と references とともにインラインで返されます。それが pageToken として返される場合や、People Also Ask の各質問では、そのトークンを AI Overview ツールに渡すと回答が得られます。トークンはすぐに失効するため、新しい呼び出しから取得したトークンを展開してください。

Google Cloud プロジェクトや Programmable Search Engine は必要ですか？

いいえ、必要ありません。認証情報は HasData のキーだけです。Google Cloud で作成するものはなく、API ごとのクォータを管理する必要もありません。

API キーは有効期限が切れますか？

いいえ、キーは失効しません。必要になったらダッシュボードでいつでもローテーションできます。

データはライブですか、キャッシュですか？

ライブです。各呼び出しはリクエスト時に結果ページを取得し、それぞれ独自の requestMetadata.id を持ちます。同一の呼び出しを 2 回しても、それは 2 回の別々の取得であり、保存済みコピーの再生ではありません。

これは Google と提携していますか？

いいえ。HasData は独立したサービスであり、Google との提携も、承認も、スポンサーも受けていません。Google はそれぞれの権利者の商標です。ツールが扱うのは公開データのみであり、結果の利用が Google の規約とあなたに適用される法令に沿うようにするのは、あなたの責任です。

HasData リンク

開発

このリポジトリは、リモートサーバーの設定とドキュメントです。ビルドステップはなく、コンテナ化するものもありません。

ただし、契約テストは含まれています。README には特定のパラメータを持つ 8 つのツールが記載されていますが、上流のツール一覧はこのリポジトリへのコミットなしに変更され得るため、このファイルが知らぬ間に間違った情報を伝えることになる可能性があります。テストは、文書化されたツールが宣言されたパラメータで存在することを検証し、毎週の CI とすべてのプッシュの両方で実行されます。

HASDATA_API_KEY=your_key_here npm test

PowerShell の場合:

$env:HASDATA_API_KEY = "your_key_here"; npm test

最後のチェックは実際の検索を実行し、10 クレジットを消費します。これは、正当な理由で失敗しうるカナリアのためのコストです。ツールの一覧取得は、キーが空でなければ成功します。そのため、一覧を取得するだけのテストは、失効したキーでもグリーンのままです。

コントリビューション

ツールの表とレスポンスサンプルの修正が最も役立つ貢献です。これらの部分が実態とずれやすいからです。実行した呼び出しと受け取ったレスポンスを含めてください。フォークからの Pull Request はキーなしでスイートが実行され、ライブチェックは失敗（赤）になる代わりにスキップされます。

ライセンス

MIT です。LICENSE を参照してください。