Serp MCP

🚀 SERP MCP Server

Google SERPスクレイパーを、指紋ローテーション機能付きのModel Context Protocol (MCP)サーバーとして提供します。

スポンサー

Quercle - 無駄なトークンを使うことなく、LLMが必要とする正確な情報を取得しましょう。
ナビゲーション、広告、フッターを除外したWebフェッチと検索API。JSサイトに対応。クリーンで出典付きのコンテンツを返します。

✨ 主な機能

• リクエストごとに自動的に指紋をローテーション
• リクエストブロッキング（www.google.com/searchのみ許可）
• 軽量モードでトラフィックを50%削減（有機検索結果のみ、デフォルト）
• フルモードでは、有機検索結果、サイトリンク、PAA、関連検索、知識グラフを抽出
• Protobufを介した場所エンコーディング（UULE形式）
• 検証済みの国/言語コード

📦 インストール

Claude Code

claude mcp add serp-mcp -- uvx serp-mcp

opencode

~/.config/opencode/opencode.jsoncに以下を追加します。

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "serp-mcp": {
      "type": "local",
      "command": ["uvx", "serp-mcp"],
      "enabled": true
    }
  }
}

手動での使用

# uvxで実行（自動的に最新バージョンをインストールして実行）
uvx serp-mcp

開発用

git clone https://github.com/LiranYoffe/serp-mcp
cd serp-mcp
uv sync
uv run serp-mcp

💻 使用例

search

Googleを検索し、SERPデータを抽出します。

パラメータ:

• query (必須): 検索クエリ
• country (デフォルト: "us"): 国コード (us, uk, fr, de, など)
• language (デフォルト: "en"): 言語コード (en, fr, de, es, など)
• location (オプション): ローカル検索結果の場所 (例: "New York, NY")
• time_range (オプション): 時間フィルター (hour, day, week, month, year)
• autocorrect (デフォルト: true): クエリの自動修正を有効にする
• page (デフォルト: 1): ページ番号
• lite (デフォルト: true): 軽量モード（有機検索結果のみ、トラフィックを50%削減）

使用例:

デフォルト設定で "python tutorial" を検索
軽量モードでフランスで "python tutorial" を検索
7日間の時間フィルターでニューヨークで "restaurants" を検索

国コード

有効なISO 3166-1 alpha-2コード: us, uk, fr, de, es, it, jp, kr, cn, in, br, など (243コード)

言語コード

有効なGoogle言語コード: en, fr, de, es, it, pt, ru, ja, ko, zh-cn, zh-tw, ar, hi, など (78コード)

時間範囲

• hour: 過去1時間
• day: 過去24時間
• week: 過去1週間
• month: 過去1ヶ月
• year: 過去1年

🔧 技術詳細

• 指紋ローテーション: 各リクエストに対して自動的にブラウザ指紋をローテーション
• MCPプロトコル: 標準入出力トランスポートを持つModel Context Protocolサーバー
• ブロッキング: 効率化のため、すべての非Googleリクエストをブロック

開発

テストの実行

uv run pytest

Protobufの再生成

uv run python -m grpc_tools.protoc \
  --python_out=serp_mcp \
  -Iserp_mcp \
  serp_mcp/uule.proto

📄 ライセンス

MIT