Trovi attività
search_google_mapsCerchi una categoria e una località. Riceva fino a 20 attività con i campi disponibili di scheda, contatto, valutazione e conteggio delle recensioni.
q · page · extra
Esplori l'API SearchDati di Google Maps / Server MCP
Trovi attività, legga recensioni pubbliche ed esplori le gallerie dei luoghi con Claude Code, Cursor, VS Code o Codex. Tre strumenti remoti. La stessa chiave API.
Funziona con il Suo client MCP
HTTP Streamable remoto · Chiave API privata · Piani API gratuiti e a pagamento
Tre strumenti / Una connessione
Ogni strumento restituisce il suo risultato direttamente. Scelga l'operazione di cui la Sua attività ha bisogno e mantenga esplicite le pagine richieste.
search_google_mapsCerchi una categoria e una località. Riceva fino a 20 attività con i campi disponibili di scheda, contatto, valutazione e conteggio delle recensioni.
q · page · extra
Esplori l'API Searchget_google_maps_reviewsUsi il feature ID di un luogo per richiedere fino a 10 recensioni. Scelga rilevanza, più recenti, valutazione più alta o valutazione più bassa.
fid · page · sort_by
Esplori l'API Reviewsget_google_maps_photosRecuperi fino a 20 record di metadati di foto e video per un luogo. Legga gli URL dei media restituiti e il flag di paginazione.
fid · page
Esplori l'API PhotosReviews e Photos accettano il feature ID di Maps dal place.dataId di un risultato di ricerca. Search usa le pagine 1–10; gli strumenti media restituiscono next così il Suo agente può decidere se serve un'altra pagina.
Connessione MCP
Il Suo client gestisce l'inizializzazione e la scoperta degli strumenti, poi invia la Sua chiave API con ogni richiesta.
POST https://gmapscrawl.com/api/mcp
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json
Accept: application/json, text/event-streamConfigurazione del client
Crei una chiave API, poi copi la configurazione per il Suo client. Conservi la chiave nel suo ambiente o nell'impostazione di input protetta.
Aggiunga questo server a .mcp.json. Renda GMSCRAPER_API_KEY disponibile nell'ambiente che avvia Claude Code.
{
"mcpServers": {
"google-maps-data": {
"type": "http",
"url": "https://gmapscrawl.com/api/mcp",
"headers": {
"Authorization": "Bearer ${GMSCRAPER_API_KEY}"
}
}
}
}Dopo aver salvato la configurazione, riconnetta e confermi che i tre strumenti appaiono. Segua la guida di configurazione passo passo.
Il Suo primo workflow
Inizi con una chiave di test e dati simulati. Passi a una chiave live quando è pronto a usare la Sua quota API.
Selezioni il prodotto API e crei una chiave di test con scrapes:write. Il Suo piano API deve consentire MCP; Online ed Estensione hanno quote separate.
Crei una chiaveCollegi il Suo client, ispezioni search_google_maps e chieda una pagina. Generi un ID di richiesta nuovo per nuovo lavoro e lo conservi quando riprova la stessa richiesta.
Veda la configurazione del clientLegga structuredContent.businesses e total. Etichetti i risultati di test come simulati, conservi i valori mancanti e si fermi dopo la pagina richiesta.
Comprenda i campiSostituisca l'ID di richiesta per ogni nuova ricerca. Questo esempio non esegue una richiesta dalla pagina.
{
"q": "coffee shops in Seattle",
"page": 1,
"hl": "en",
"extra": false,
"client_request_id": "replace-with-a-fresh-uuid"
}Cosa torna
I risultati tornano direttamente; non serve polling di job. Conservi le date di osservazione della sorgente quando trasforma il JSON in una tabella o un report.
Prompt di esempio
Usi questi prompt dopo la connessione. Fornisca un feature ID reale dove necessario e chieda al Suo agente di etichettare i risultati di test come simulati.
“Usi search_google_maps una volta per caffetterie a Seattle, pagina 1, extra false. Restituisca nomi, siti web, numeri di telefono, valutazioni e conteggi delle recensioni delle attività restituite. Lasci vuoti i campi mancanti e mostri le date di osservazione. Si fermi dopo questa pagina.”
Risultato atteso
Una tabella di fino a 20 attività restituite, con timestamp di origine e valori mancanti conservati.
“Per l'attività che ho selezionato, usi il suo place.dataId come fid. Richieda la pagina 1 di get_google_maps_reviews con sort_by 2. Riassuma i temi solo di queste recensioni restituite e citi le loro date. Non recuperi pagine aggiuntive.”
Risultato atteso
Un riepilogo delimitato di fino a 10 recensioni, senza trattare una pagina come l'esperienza di tutti i clienti.
“Usi get_google_maps_photos per questo feature ID fornito, solo pagina 1. Elenco i campi photoUrl restituiti e i videoUrl opzionali e segnali se next è true. Non scarichi file né recuperi la pagina successiva.”
Risultato atteso
Fino a 20 record di galleria e lo stato di paginazione restituito, pronti per l'ispezione della Sua applicazione.
REST + MCP
MCP è disponibile sui piani API gratuiti e a pagamento. Ogni pagina di origine live riuscita usa un'unità di richiesta API, inclusa una pagina vuota.
Le chiavi di test restituiscono fixture simulati con zero unità di richiesta. Verificano la Sua integrazione invece di produrre lead di attività reali.
Gestisca le chiavi APIChieda solo le pagine e le località di cui la Sua attività ha bisogno. Usi un nuovo ID di richiesta per nuovo lavoro; riprovi le richieste incerte con lo stesso input e ID.
Legga la guida all'usoL'Agent Skill di Google Maps Data aggiunge guida di workflow, riferimenti delle operazioni e un fallback REST agli stessi strumenti.
Esplori l'Agent SkillEsplori l'hub API → I piani Online ed Estensione hanno le proprie quote.
Aiuto per la connessione
Usi lo stato della connessione e l'errore restituito per scegliere il passo successivo.
Espone search_google_maps, get_google_maps_reviews e get_google_maps_photos. La ricerca restituisce fino a 20 attività; le recensioni restituiscono fino a 10 record e le foto fino a 20 record di galleria per pagina. Gli strumenti restituiscono dati strutturati direttamente.
Usi una versione di Claude Code, Cursor, VS Code, Codex o un altro client MCP che supporti HTTP Streamable remoto e un header Authorization privato. Le quattro configurazioni client sopra usano lo stesso endpoint e la chiave dell'area di lavoro API.
Crei una chiave API con scrapes:write nella Sua area di lavoro API e la configuri privatamente come header Bearer. I cookie del browser non autenticano MCP. Tenga le chiavi fuori da prompt, URL e codice sorgente committato.
Passi il feature ID di Maps come fid. Può usare place.dataId di un'attività restituita. Reviews accetta anche sort_by: 1 per rilevanza, 2 per più recenti, 3 per valutazione più alta o 4 per valutazione più bassa. Legga next prima di considerare un'altra pagina di media.
MCP condivide la quota dell'API REST ed è disponibile sui piani API gratuiti e a pagamento. Una pagina live riuscita usa un'unità di richiesta, inclusa una pagina vuota. Le credenziali di test restituiscono dati simulati con zero unità. Le quote Online ed Estensione sono separate.
Il server MCP funziona da solo. L'Agent Skill di Google Maps Data opzionale aggiunge istruzioni riutilizzabili, riferimenti delle operazioni e un helper di fallback REST per quando la Sua connessione MCP configurata non è disponibile.
Faccia il passo successivo
Crei una chiave API, colleghi il Suo client preferito e testi una ricerca di attività mirata.