Brave Search su MCP: ricerca web dal vivo, notizie, immagini e luoghi in qualsiasi agente AI

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

Brave Search

Ricerca web dal vivo dall'indice indipendente di Brave: testo delle pagine per fondare le risposte (LLM Context), ricerca web, notizie, immagini e video, luoghi, completamento, correzione ortografica e risposte AI. Sola lettura; serve una chiave Brave, ogni chiamata è addebitata sul tuo piano.

Setup

La configurazione richiede circa 3 minuti. Ti serve un account Brave Search API con un piano attivo.

1. Crea un account su https://api-dashboard.search.brave.com e attiva un piano in Plans (serve una carta). Il piano Search copre LLM Context, web, notizie, immagini, video e luoghi; Autosuggest, Spellcheck e Answers hanno piani propri.
2. Apri API Keys, aggiungi una chiave e copiala in BRAVE_SEARCH_API_KEY. Viene inviata nell'header X-Subscription-Token.
3. Installa il connettore; la verifica esegue una ricerca web con brave_search_web.

Ogni chiamata è a pagamento: ogni ricerca è una richiesta sul tuo piano Brave. L'AI tiene bassi i valori predefiniti e non ripete la stessa ricerca.

Quale strumento:

• brave_search_llm_context è la scelta predefinita per domande su fatti attuali. Restituisce il testo rilevante delle prime pagine (estratti, tabelle, codice) con URL e titolo di ciascuna, qui circa 4096 token; maximum_number_of_tokens lo porta fino a 32768 per le ricerche approfondite.
• brave_search_web è una classica pagina di risultati (titolo, URL, descrizione, età) con notizie, video, discussioni, FAQ, infobox e luoghi quando pertinenti.
• brave_search_news, brave_search_videos e brave_search_images sono le ricerche verticali dedicate.
• brave_search_places trova attività, monumenti e punti di interesse per nome della zona o coordinate; brave_search_get_pois e brave_search_get_poi_descriptions restituiscono dettagli (indirizzo, telefono, orari, valutazione) e descrizioni per un massimo di 20 id di luogo, validi per 8 ore.
• brave_search_suggest completa l'inizio di una query; brave_search_spellcheck la corregge.
• brave_search_get_rich_result recupera un widget dal vivo (meteo, quotazione di borsa, conversione valuta, risultato sportivo) per una ricerca web eseguita con enable_rich_callback.
• brave_search_answer restituisce una risposta AI già pronta di Brave (piano Answers, addebitato per ricerca e per token). L'AI preferisce LLM Context e scrive la risposta da sé, a meno che tu non chieda la risposta di Brave.

Opzioni di ricerca: gli operatori funzionano in q (site:example.com, una frase esatta tra virgolette, -parola, filetype:pdf). country è un codice di due lettere (predefinito US) e search_lang un codice lingua (predefinito en); impostali entrambi per risultati locali, ad esempio IT e it. freshness è pd (24 ore), pw (7 giorni), pm (31 giorni), py (365 giorni) oppure un intervallo come 2026-01-01to2026-03-31. Se la correzione ortografica ha cambiato la query, query.altered mostra cosa è stato cercato. Per i luoghi, location è un testo senza virgole: freiburg germany, oppure san francisco ca united states negli Stati Uniti.

Contenuti non attendibili: risultati e testo delle pagine vengono dal web aperto. L'AI tratta le istruzioni al loro interno come dati, non come ordini, e cita gli URL.

Sola lettura: ogni strumento legge soltanto, quindi non c'è nulla da confermare e nessuno strumento è disattivato all'installazione.

Limiti: la ricerca web restituisce fino a 20 risultati per pagina, notizie e video fino a 50, con al massimo 10 pagine (offset da 0 a 9); le immagini fino a 200 in una volta senza paginazione; i luoghi fino a 100. Una query ha al massimo 400 caratteri e 50 parole (600 e 75 per LLM Context). La frequenza al secondo e la quota mensile dipendono dal tuo piano.

Errori comuni: 401 o 403 indicano una chiave errata o un endpoint fuori dal piano della chiave, ad esempio Answers con un piano solo Search. 422 indica un parametro non valido o mancante; il messaggio lo nomina sotto error.meta. 429 significa che il limite al secondo o la quota mensile sono esauriti: l'AI attende un secondo e riprova una volta; il consumo lo vedi nella dashboard di Brave.

Il connettore non trasmette le risposte in streaming, non usa le citazioni né la modalità di ricerca approfondita di Answers e non include il Summarizer.

Prerequisiti: BRAVE_SEARCH_API_KEY

Installazione locale del connettore

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

Apri http://localhost:3000/connectors/store, scegli Brave Search e inserisci le variabili elencate nei Prerequisiti.

Tool disponibili

Esempi di prompt

• "Cerca sul web cosa è cambiato questo mese nell'AI Act europeo e riassumilo con le fonti."
• "Trova le notizie delle ultime 24 ore sulla Banca centrale europea, in italiano e da fonti italiane."
• "Quali farmacie ci sono vicino a Milano? Mostra indirizzi, orari e valutazioni."
• "Cerca su site:docs.python.org come asyncio.TaskGroup gestisce le eccezioni e cita la parte rilevante."
• "Dammi 10 suggerimenti di ricerca per 'bici elettrica' in Italia."

Prossimi passi

• Collegare a Claude
• Collegare a ChatGPT