Przejdź do głównej treści

Documentation Index

Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

MCP (Model Context Protocol) to protokół kontekstu modelu wprowadzony przez Anthropic, który pozwala modelom AI (takim jak Claude, GPT itp.) na wywoływanie zewnętrznych narzędzi za pomocą znormalizowanego interfejsu. Dzięki SERP MCP Server dostarczonemu przez XHuoAPI, możesz bezpośrednio przeprowadzać wyszukiwania w Google w klientach AI, takich jak Claude Desktop, VS Code, Cursor, uzyskując wyniki wyszukiwania stron internetowych, obrazów, wiadomości, filmów, miejsc itp.

​
Przegląd funkcji

SERP MCP Server oferuje następujące kluczowe funkcje:
  • wyszukiwanie stron internetowych — wyszukiwanie wyników stron Google
  • wyszukiwanie obrazów — wyszukiwanie obrazów Google
  • wyszukiwanie wiadomości — wyszukiwanie wiadomości Google
  • wyszukiwanie filmów — wyszukiwanie filmów Google
  • wyszukiwanie miejsc — wyszukiwanie informacji o miejscach Google
  • wyszukiwanie map — wyszukiwanie map Google
  • wielojęzyczność i wiele regionów — wsparcie dla niestandardowych parametrów kraju i języka
  • filtrowanie według zakresu czasowego — filtrowanie wyników według dni, tygodni, miesięcy, lat

​
Przygotowanie wstępne

Przed użyciem musisz uzyskać token API XHuoAPI:
  1. Zarejestruj się lub zaloguj na platformie XHuoAPI
  2. Przejdź do strony Google SERP API
  3. Kliknij „Acquire”, aby uzyskać token API (pierwsze zgłoszenie daje darmowy limit)

​
Instalacja i konfiguracja

​
Metoda 1: instalacja pip (zalecana)

pip install mcp-serp

​
Metoda 2: instalacja ze źródła

git clone https://github.com/XHuoAPI/SerpMCP.git
cd SerpMCP
pip install -e .
Po zakończeniu instalacji możesz użyć polecenia mcp-serp, aby uruchomić serwis.

​
Użycie w Claude Desktop

Edytuj plik konfiguracyjny Claude Desktop:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Dodaj następującą konfigurację: 
{
  "mcpServers": {
    "serp": {
      "command": "mcp-serp",
      "env": {
        "XHuoAPI_API_TOKEN": "Twój token API"
      }
    }
  }
}
Jeśli używasz uvx (nie wymaga wcześniejszej instalacji pakietu): 
{
  "mcpServers": {
    "serp": {
      "command": "uvx",
      "args": ["mcp-serp"],
      "env": {
        "XHuoAPI_API_TOKEN": "Twój token API"
      }
    }
  }
}
Po zapisaniu konfiguracji uruchom ponownie Claude Desktop, aby móc korzystać z narzędzi wyszukiwania Google w rozmowie.

​
Użycie w VS Code / Cursor

Utwórz plik .vscode/mcp.json w katalogu głównym projektu: 
{
  "servers": {
    "serp": {
      "command": "mcp-serp",
      "env": {
        "XHuoAPI_API_TOKEN": "Twój token API"
      }
    }
  }
}
Lub użyj uvx: 
{
  "servers": {
    "serp": {
      "command": "uvx",
      "args": ["mcp-serp"],
      "env": {
        "XHuoAPI_API_TOKEN": "Twój token API"
      }
    }
  }
}

​
Lista dostępnych narzędzi

Nazwa narzędziaOpis
serp_google_searchWyszukiwanie stron Google
serp_google_imagesWyszukiwanie obrazów Google
serp_google_newsWyszukiwanie wiadomości Google
serp_google_videosWyszukiwanie filmów Google
serp_google_placesWyszukiwanie miejsc Google
serp_google_mapsWyszukiwanie map Google

​
Przykłady użycia

Po skonfigurowaniu możesz bezpośrednio wywoływać te funkcje w kliencie AI za pomocą naturalnego języka, na przykład:
  • „Pomóż mi wyszukać najnowsze prace naukowe o AI”
  • „Wyszukaj dobre restauracje z hot pot w Pekinie”
  • „Znajdź obrazy dotyczące programowania asynchronicznego w Pythonie”
  • „Wyszukaj dzisiejsze wiadomości technologiczne”
  • „Znajdź pobliskie kawiarnie na mapie”

​
Więcej informacji