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

# Guida all'integrazione di Google Search MCP

> serp MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) è un protocollo di contesto del modello lanciato da Anthropic, che consente ai modelli AI (come Claude, GPT, ecc.) di chiamare strumenti esterni tramite interfacce standardizzate. Attraverso il SERP MCP Server fornito da XHuoAPI, puoi effettuare ricerche su Google direttamente nei client AI come Claude Desktop, VS Code, Cursor, ottenendo risultati di ricerca per pagine web, immagini, notizie, video, luoghi, ecc.

## Panoramica delle funzionalità

Il SERP MCP Server offre le seguenti funzionalità principali:

* **Ricerca web** — Cerca risultati web su Google
* **Ricerca immagini** — Cerca immagini su Google
* **Ricerca notizie** — Cerca notizie su Google
* **Ricerca video** — Cerca video su Google
* **Ricerca luoghi** — Cerca informazioni sui luoghi su Google
* **Ricerca mappe** — Cerca mappe su Google
* **Multilingue e multiregione** — Supporta parametri di paese e lingua personalizzati
* **Filtraggio per intervallo di tempo** — Filtra i risultati per giorno, settimana, mese, anno

## Preparazione preliminare

Prima di utilizzare, devi ottenere il Token API di XHuoAPI:

1. Registrati o accedi alla [piattaforma XHuoAPI](https://api.xhuoapi.ai)
2. Vai alla pagina [Google SERP API](https://api.xhuoapi.ai/documents/serp-google)
3. Clicca su "Acquire" per ottenere il Token API (il primo acquisto include un credito gratuito)

## Installazione e configurazione

### Metodo 1: installazione con pip (consigliato)

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

### Metodo 2: installazione da sorgente

```bash theme={null}
git clone https://github.com/XHuoAPI/SerpMCP.git
cd SerpMCP
pip install -e .
```

Dopo aver completato l'installazione, puoi avviare il servizio utilizzando il comando `mcp-serp`.

## Utilizzo in Claude Desktop

Modifica il file di configurazione di Claude Desktop:

* **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
* **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

Aggiungi la seguente configurazione:

```json theme={null}
{
  "mcpServers": {
    "serp": {
      "command": "mcp-serp",
      "env": {
        "XHuoAPI_API_TOKEN": "il tuo Token API"
      }
    }
  }
}
```

Se utilizzi `uvx` (senza necessità di installare pacchetti in anticipo):

```json theme={null}
{
  "mcpServers": {
    "serp": {
      "command": "uvx",
      "args": ["mcp-serp"],
      "env": {
        "XHuoAPI_API_TOKEN": "il tuo Token API"
      }
    }
  }
}
```

Dopo aver salvato la configurazione, riavvia Claude Desktop per poter utilizzare gli strumenti di ricerca Google nelle conversazioni.

## Utilizzo in VS Code / Cursor

Crea un file `.vscode/mcp.json` nella directory principale del progetto:

```json theme={null}
{
  "servers": {
    "serp": {
      "command": "mcp-serp",
      "env": {
        "XHuoAPI_API_TOKEN": "il tuo Token API"
      }
    }
  }
}
```

Oppure utilizza `uvx`:

```json theme={null}
{
  "servers": {
    "serp": {
      "command": "uvx",
      "args": ["mcp-serp"],
      "env": {
        "XHuoAPI_API_TOKEN": "il tuo Token API"
      }
    }
  }
}
```

## Elenco degli strumenti disponibili

| Nome strumento       | Descrizione             |
| -------------------- | ----------------------- |
| `serp_google_search` | Ricerca web Google      |
| `serp_google_images` | Ricerca immagini Google |
| `serp_google_news`   | Ricerca notizie Google  |
| `serp_google_videos` | Ricerca video Google    |
| `serp_google_places` | Ricerca luoghi Google   |
| `serp_google_maps`   | Ricerca mappe Google    |

## Esempi di utilizzo

Dopo aver completato la configurazione, puoi chiamare queste funzionalità direttamente nel client AI utilizzando un linguaggio naturale, ad esempio:

* "Aiutami a cercare gli ultimi articoli sull'AI"
* "Cerca ristoranti di hot pot buoni a Pechino"
* "Trova immagini sulla programmazione asincrona in Python"
* "Cerca le notizie tecnologiche di oggi"
* "Cerca caffè nelle vicinanze sulla mappa"

## Maggiori informazioni

* Repository GitHub: [XHuoAPI/SerpMCP](https://github.com/XHuoAPI/SerpMCP)
* Pacchetto PyPI: [mcp-serp](https://pypi.org/project/mcp-serp/)
* Documentazione API: [API del motore di ricerca](https://api.xhuoapi.ai/documents/serp)