Come collegare SerpApi a Gemini via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → SerpApi, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

SerpApi + Gemini

Dai alla tua AI i risultati dei motori di ricerca in tempo reale con SerpApi: ricerca web di Google, News, Images, Maps, Shopping, Scholar e Trends, più YouTube e Bing, come risultati strutturati e puliti. E controlla quante ricerche restano nel tuo piano.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

SERPAPI_API_KEY

Step 1 — Ottieni le credenziali

1. Registrati su https://serpapi.com (il piano gratuito non richiede carta) e conferma il tuo indirizzo email.
2. Apri https://serpapi.com/manage-api-key e copia la tua chiave API privata.
3. Incollala in SERPAPI_API_KEY e installa il connettore. La chiave viene salvata cifrata, il connettore la aggiunge a ogni richiesta e la invia solo a serpapi.com.
4. Inizia con serpapi_get_account: è gratuito e mostra il tuo piano, le ricerche usate e rimaste questo mese e il limite orario.

Addebitato sul tuo piano SerpApi: ogni ricerca riuscita consuma una ricerca del tuo piano SerpApi; il piano gratuito ne include 250 al mese. Una ricerca identica ripetuta entro un'ora arriva gratis dalla cache di SerpApi, le ricerche fallite sono gratuite, e controllare l'account o cercare le località non costa nulla.

Cosa fa: ricerca web di Google con answer box, knowledge graph, panoramica AI, People also ask, notizie principali e risultati locali quando Google li mostra; Google News, Images, Maps (luoghi con valutazione, indirizzo, telefono, sito web e orari di apertura), Shopping (offerte con venditore e prezzo), Scholar (articoli con numero di citazioni) e Trends (interesse nel tempo, per regione, argomenti e query correlati); più YouTube e Bing. I risultati tornano come dati strutturati, ridotti alle parti utili.

Localizzazione: una ricerca può partire da una città specifica e usare l'edizione di Google di un paese e di una lingua. serpapi_search_locations trova i nomi esatti delle località accettati da SerpApi.

Contenuti non affidabili: titoli e snippet arrivano dal web aperto. L'AI tratta le istruzioni che contengono come dati, non come ordini.

Errori comuni: 401 significa che la chiave è sbagliata o è stata rigenerata. 429: le ricerche del piano per il mese sono esaurite, oppure è stato raggiunto il limite orario; serpapi_get_account mostra quale dei due. 400: manca un parametro obbligatorio o un valore non è valido, per esempio un paese o una località sconosciuti. 403: l'account non può eseguire la richiesta, per esempio perché è sospeso.

Il connettore non copre gli altri motori di SerpApi (come voli, hotel, offerte di lavoro o recensioni di prodotti), le ricerche asincrone, l'archivio delle ricerche né l'HTML grezzo.

Step 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Aggiungi il connettore in Gemini

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di SerpApi.

Tool disponibili

Esempi di prompt

• "In che posizione si trova il nostro sito su google.de per 'custom claude connector', e cosa dice la panoramica AI?"
• "Trova torrefazioni di caffè ad Amburgo su Google Maps con una valutazione superiore a 4,5, con telefono e sito web."
• "Confronta su Google Trends l'interesse per 'pompa di calore' e 'pannelli solari' in Italia negli ultimi 12 mesi."
• "Quante ricerche restano nel nostro piano SerpApi questo mese?"

FAQ

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT