Serp MCP

🚀 SERP MCP Server

Google SERP抓取器，作為具有指紋輪換功能的模型上下文協議（MCP）服務器，能有效提升數據抓取的效率與安全性。

🌟 贊助方

Quercle - 停止在無用信息上浪費令牌。精準獲取大語言模型所需內容。
網頁抓取與搜索API，可去除導航欄、廣告和頁腳。支持處理JS網站，返回乾淨、有引用的內容。

✨ 主要特性

• 自動指紋輪換：每個請求自動輪換瀏覽器指紋，增強數據抓取的安全性。
• 請求攔截：僅允許訪問www.google.com/search，提高效率。
• 精簡模式：流量減少50%，僅提取自然搜索結果（默認模式）。
• 完整模式：可提取自然搜索結果、站點鏈接、常見問題解答、相關搜索、知識圖譜等信息。
• 位置編碼：通過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"
在紐約搜索 "restaurants" 並設置7天時間過濾器

🔍 代碼說明

國家代碼

有效的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：過去一小時
• day：過去24小時
• week：過去一週
• month：過去一個月
• year：過去一年

🔧 技術細節

• 指紋輪換：每個請求自動輪換瀏覽器指紋，增強數據抓取的安全性。
• MCP協議：基於標準輸入輸出傳輸的模型上下文協議服務器。
• 請求攔截：為提高效率，攔截所有非Google的請求。

👨‍💻 開發相關

運行測試

uv run pytest

重新生成Protobuf

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

📄 許可證

本項目採用MIT許可證。