> ## 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.

# Przewodnik po integracji Google Search MCP

> serp MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) 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](https://api.xhuoapi.ai)
2. Przejdź do strony [Google SERP API](https://api.xhuoapi.ai/documents/serp-google)
3. Kliknij „Acquire”, aby uzyskać token API (pierwsze zgłoszenie daje darmowy limit)

## Instalacja i konfiguracja

### Metoda 1: instalacja pip (zalecana)

```bash theme={null}
pip install mcp-serp
```

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

```bash theme={null}
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ę:

```json theme={null}
{
  "mcpServers": {
    "serp": {
      "command": "mcp-serp",
      "env": {
        "XHuoAPI_API_TOKEN": "Twój token API"
      }
    }
  }
}
```

Jeśli używasz `uvx` (nie wymaga wcześniejszej instalacji pakietu):

```json theme={null}
{
  "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:

```json theme={null}
{
  "servers": {
    "serp": {
      "command": "mcp-serp",
      "env": {
        "XHuoAPI_API_TOKEN": "Twój token API"
      }
    }
  }
}
```

Lub użyj `uvx`:

```json theme={null}
{
  "servers": {
    "serp": {
      "command": "uvx",
      "args": ["mcp-serp"],
      "env": {
        "XHuoAPI_API_TOKEN": "Twój token API"
      }
    }
  }
}
```

## Lista dostępnych narzędzi

| Nazwa narzędzia      | Opis                           |
| -------------------- | ------------------------------ |
| `serp_google_search` | Wyszukiwanie stron Google      |
| `serp_google_images` | Wyszukiwanie obrazów Google    |
| `serp_google_news`   | Wyszukiwanie wiadomości Google |
| `serp_google_videos` | Wyszukiwanie filmów Google     |
| `serp_google_places` | Wyszukiwanie miejsc Google     |
| `serp_google_maps`   | Wyszukiwanie 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

* Repozytorium GitHub: [XHuoAPI/SerpMCP](https://github.com/XHuoAPI/SerpMCP)
* Pakiet PyPI: [mcp-serp](https://pypi.org/project/mcp-serp/)
* Dokumentacja API: [API wyszukiwarek](https://api.xhuoapi.ai/documents/serp)