mcpField
G
google-search

google-search

github.com/fetcher-shデータ・データベース24.0k 回インストール8 週間前に更新
リポジトリ

google-search について

Google SearchはHTTP APIを通じて、開発者やエージェントにGoogleウェブ検索結果を提供します。検索演算子、ページ指定、地域設定に対応し、前払いクレジットまたはx402の従量払いを利用できます。MCPエンドポイントも公開されています。

主な機能

  1. 01Googleウェブ検索結果をJSONで返却
  2. 02Google検索演算子の利用
  3. 03ページ、言語、地域の指定
  4. 04前払いクレジットまたはx402決済
  5. 05Google Search MCPツールの提供

活用シーン

  1. 01特定サイト内のページ検索
  2. 02PDFや完全一致フレーズの検索
  3. 03ローカライズされた結果の取得
  4. 04検索機能のMCPクライアント接続

MCP 対応

https://google.fetcher.sh/mcpにMCPエンドポイントがあります。クライアントは無料の探索・残高ツール、有料のデータ取得ツール、google_searchショートカットを利用でき、Bearerキーまたはx402で認証・決済できます。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/fetcher-sh/fetcher-skills --skill google-search

インストール後、Claude Code で/google-searchを入力して読み込まれたか確認します。

詳細

Google Search API

Google 独自の検索結果をクリーンな JSON で取得できます。呼び出しごとにプレーンな HTTP GET を 1 回行い、使った分だけお支払いいただけます。Google の検索演算子はそのまま利用でき、site:、filetype:、intitle:、引用符で囲んだ完全一致フレーズは、ブラウザーとまったく同じように機能します。Custom Search Engine の設定も、1 日あたりのクエリ上限も、請求先アカウントも不要です。

ベース URL：https://google.fetcher.sh

認証

同じデータを利用できる 2 種類の支払い方法については、fetcher スキルで仕組みをご確認ください。

# 1. Prepaid credits (recommended — get a key at https://fetcher.sh/topup
#    or via POST /api/credits/topup, see the fetcher skill)
export FETCHER_API_KEY="bby_live_xxxxxxxxxxxx"
curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://google.fetcher.sh/api/search?query=hello"

# 2. x402 pay-per-call — omit the header; a GET with no payment returns 402
#    with machine-readable payment requirements (USDC on Base, Polygon,
#    Arbitrum, Monad, or Solana). @x402/fetch signs and retries automatically.

すべてのレスポンスは { "status": number, "message": string, "data": ... } 形式です。HTTP ステータスは status と同じ値になります。

エンドポイント（1 回あたり $0.005）

エンドポイント返される内容
/api/searchクエリに対する Google ウェブ検索結果

必須：query。任意：safe（セーフサーチ）、page（ページネーション）、hl（UI 言語。例：en）、country（地域の指定）、count（1 ページあたりの検索結果数。現在は 10）、noEncode（形式が整った演算子文字列のクエリの再エンコードをスキップ）。

使用例

1 つのサイトに絞り込む：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=site:github.com x402 payments" -G \
  "https://google.fetcher.sh/api/search"

PDF のみ：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=agentic commerce filetype:pdf" -G \
  "https://google.fetcher.sh/api/search"

完全一致フレーズ：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode 'query="pay per call api"' -G \
  "https://google.fetcher.sh/api/search"

地域と言語を指定した検索結果（英国、フランス語 UI）とページネーション：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=agentic commerce" -G \
  --data-urlencode "country=GB" \
  --data-urlencode "hl=fr" \
  --data-urlencode "page=2" \
  "https://google.fetcher.sh/api/search"

演算子を組み合わせる — タイトル一致とサイトの絞り込み：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=intitle:pricing site:x402.org" -G \
  "https://google.fetcher.sh/api/search"

MCP

{
  "mcpServers": {
    "google-search": {
      "url": "https://google.fetcher.sh/mcp",
      "headers": { "Authorization": "Bearer bby_live_..." }
    }
  }
}

無料：search_endpoints、describe_endpoint、check_balance。有料：fetch_data（上記のすべてのエンドポイント）、topup_credits、および名前付きショートカットの google_search。代わりに x402 で呼び出しごとに支払うには、headers ブロックを削除してください。詳しい手順はfetcher スキルをご覧ください。

エラー

  • 400 — パラメーターがない、または無効です（メッセージに該当するパラメーターが示されます）
  • 401 — キーが不明、またはローテーション済みです
  • 402 — 支払いが必要です（x402 チャレンジ）、または topup_required（クレジットを使い切っています）
  • 404 — 料金設定のないパスです
  • レート制限はありません。上流で障害が発生した場合の返金はありません（配信より先に決済が行われます）

リファレンス

コメント

Markdown 対応