Serper.live

Serper.live MCP サーバー

AI エージェント向けのリアルタイム Google 検索です。この Model Context Protocol サーバーを使うと、Claude、OpenAI Codex、Cursor、VS Code などの MCP クライアントが、Serper.live を通じて、選択した国、言語、デバイスで実際の Google 検索を実行し、ドメインの現在の検索順位を確認できます。

検索結果は毎回最新で、キャッシュされません。通常、10件の結果は2～3秒で返されます。順位にはオーガニック検索結果のみが含まれ、広告、サイトリンク、動画、画像のブロックは含まれません。そのため、エージェントが取得する数値は、順位追跡ツールが記録する数値と同じです。

ツール

ツール	機能	コスト
google_search	キーワードの最新オーガニック検索結果：position、title、url、domain、snippet。1回の呼び出しで最大100件	最大10件の結果ごとに課金
domain_position	国とデバイスを指定した場合の、キーワードに対するドメインの検索順位。複数回表示される場合はすべての順位、または「上位N件には表示されない」ことを返します	確認する件数に応じて、google_search と同額
list_countries	現在検索可能な市場と、それぞれのデフォルトの Google 言語	無料、トークン不要

引数：query（2～120文字）、country（US、GB、DE、FR、TR、UA などの2文字コード）、任意の language（Google のインターフェース言語。デフォルトはその国の言語）、device（desktop または mobile）、limit / depth（1～100、デフォルトは10）。

セットアップ

1. serper.live でアカウントを作成し、クレジットを追加します（USDT または USDC で5ドルから。サブスクリプションはなく、クレジットに有効期限はありません）。次に、API tokens で API トークンを作成します。
2. SERPER_LIVE_TOKEN にトークンを設定して、サーバーをクライアントに追加します。npx で実行するため、必要なのは Node.js 20 以降だけです。Claude Desktop では、Node.js を使わずにワンクリックでインストールすることもできます。

Claude Code

claude mcp add serper-live -e SERPER_LIVE_TOKEN=sl_live_YOUR_TOKEN -- npx -y @serper-live/mcp

Claude Desktop

ワンクリックでインストールするには、最新リリースから serper-live-mcp.mcpb をダウンロードして開きます。Claude Desktop にインストールダイアログが表示され、API トークンを一度入力すると、安全に保存され、内蔵の Node.js でサーバーが実行されます。

または、手動で claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "serper-live": {
      "command": "npx",
      "args": ["-y", "@serper-live/mcp"],
      "env": {
        "SERPER_LIVE_TOKEN": "sl_live_YOUR_TOKEN"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json またはプロジェクト内の .cursor/mcp.json：

{
  "mcpServers": {
    "serper-live": {
      "command": "npx",
      "args": ["-y", "@serper-live/mcp"],
      "env": {
        "SERPER_LIVE_TOKEN": "sl_live_YOUR_TOKEN"
      }
    }
  }
}

VS Code

.vscode/mcp.json — VS Code ではトークンを一度入力すると、ファイルに保存されずに保持されます。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "serper-live-token",
      "description": "Serper.live API token",
      "password": true
    }
  ],
  "servers": {
    "serper-live": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@serper-live/mcp"],
      "env": {
        "SERPER_LIVE_TOKEN": "${input:serper-live-token}"
      }
    }
  }
}

OpenAI Codex

codex mcp add serper-live --env SERPER_LIVE_TOKEN=sl_live_YOUR_TOKEN -- npx -y @serper-live/mcp

または、手動で ~/.codex/config.toml に追加します（Codex CLI、その IDE 拡張機能、ChatGPT デスクトップアプリはこのファイルを共有します）。

[mcp_servers.serper-live]
command = "npx"
args = ["-y", "@serper-live/mcp"]

[mcp_servers.serper-live.env]
SERPER_LIVE_TOKEN = "sl_live_YOUR_TOKEN"

その他の MCP クライアントでは、環境変数 SERPER_LIVE_TOKEN を設定し、stdio 経由で npx -y @serper-live/mcp を実行します。Cline など、リポジトリからサーバーをセットアップするエージェントは、llms-install.md に従ってください。

環境変数

変数	必須	説明
SERPER_LIVE_TOKEN	検索時に必要	API tokens で取得した API トークン。設定しなくても list_countries は引き続き使用できます
SERPER_LIVE_API_URL	いいえ	API のベース URL。デフォルトは https://api.serper.live

質問例

• 「ドイツでモバイルを使って project management software を検索したとき、example.com は Google で何位ですか？上位30件を確認してください。」
• 「米国と英国で best running shoes を検索したときの Google 検索上位10件を比較してください。」
• 「どの市場で検索できますか？」

請求と再試行

検索は、最大10件のオーガニック検索結果のページごとに、該当する市場の料金（料金表）で Serper.live の残高から差し引かれます。デスクトップとモバイルの料金は同じです。各呼び出しでは Idempotency-Key が送信されるため、同じ呼び出しが繰り返されても二重に請求されることはありません。

開発

npm install
npm run build
npx @modelcontextprotocol/inspector node dist/index.js
npm run bundle   # serper-live-mcp.mcpb: dist/, manifest.json, icon.png and the production dependencies

リリース

バージョンは、package.json の version、npm と照合する MCP Registry が確認する server.json の packages[0].version、および MCP Bundle の manifest.json に記載されています。npm version を実行すると、これらすべてが設定されます。その version スクリプト（scripts/sync-version.mjs）は、新しいバージョンを server.json と manifest.json にコピーします。

v* タグをプッシュすると .github/workflows/publish.yml が実行され、タグがすべてのバージョン項目と一致することを確認し、MCP Bundle をビルド、パッケージ化、検証します。さらに、トークン不要で来歴情報を付与した信頼されたパブリッシングを通じて npm に公開し、npm で新しいバージョンが提供されるまで最大 30 分待機し、serper-live-mcp.mcpb を GitHub リリースに添付して、GitHub OIDC を通じて MCP Registry を更新します。更新には、npm と SHA-256 を含むバンドルの 2 つのパッケージが含まれます。実行に失敗しても、そのまま再実行できます。すでに npm にあるバージョンは再公開されず、リリースアセットは置き換えられます。

npm version x.y.z --no-git-tag-version   # package.json, package-lock.json, server.json, manifest.json
git commit -am "Release x.y.z"
git tag vx.y.z
git push && git push origin vx.y.z

npm パッケージでは、このワークフローを信頼されたパブリッシャーとして登録しています（パッケージ設定 → Trusted Publisher → GitHub Actions：serper-live/serper-live-mcp、ワークフロー publish.yml。Allowed actions で Allow npm publish にチェックを入れてください）。

リンク

• Serper.live — リアルタイムの Google SERP API
• API ドキュメント
• プレイグラウンド — アカウントなしでブラウザーからリアルタイム検索を試せます
• お問い合わせ

ライセンス

MIT