Unternehmen finden
search_google_mapsSuchen Sie eine Kategorie und einen Standort. Erhalten Sie bis zu 20 Unternehmen mit verfügbaren Listing-, Kontakt-, Bewertungs- und Bewertungsanzahl-Feldern.
q · page · extra
Search API entdeckenGoogle-Maps-Daten / MCP-Server
Finden Sie Unternehmen, lesen Sie öffentliche Bewertungen und erkunden Sie Ortsgalerien mit Claude Code, Cursor, VS Code oder Codex. Drei Remote-Tools. Derselbe API-Schlüssel.
Funktioniert mit Ihrem MCP-Client
Remote Streamable HTTP · Privater API-Schlüssel · Kostenlose und kostenpflichtige API-Tarife
Drei Tools / Eine Verbindung
Jedes Tool liefert sein Ergebnis direkt. Wählen Sie die Operation, die Ihre Aufgabe benötigt, und halten Sie die angeforderten Seiten explizit.
search_google_mapsSuchen Sie eine Kategorie und einen Standort. Erhalten Sie bis zu 20 Unternehmen mit verfügbaren Listing-, Kontakt-, Bewertungs- und Bewertungsanzahl-Feldern.
q · page · extra
Search API entdeckenget_google_maps_reviewsNutzen Sie die Feature-ID eines Ortes, um bis zu 10 Bewertungen anzufordern. Wählen Sie Relevanz, neueste, höchste oder niedrigste Bewertung.
fid · page · sort_by
Reviews API entdeckenget_google_maps_photosRufen Sie bis zu 20 Foto- und Video-Metadatensätze für einen Ort ab. Lesen Sie die zurückgegebenen Medien-URLs und das Paginierungs-Flag.
fid · page
Photos API entdeckenReviews und Photos akzeptieren die Maps-Feature-ID aus place.dataId eines Suchergebnisses. Search nutzt die Seiten 1–10; Medientools geben next zurück, damit Ihr Agent entscheiden kann, ob eine weitere Seite nötig ist.
MCP-Verbindung
Ihr Client übernimmt Initialisierung und Tool-Erkennung und sendet dann Ihren API-Schlüssel mit jeder Anfrage.
POST https://gmapscrawl.com/api/mcp
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json
Accept: application/json, text/event-streamClient-Einrichtung
Erstellen Sie einen API-Schlüssel und kopieren Sie dann die Konfiguration für Ihren Client. Bewahren Sie den Schlüssel in seiner Umgebung oder einer geschützten Eingabeeinstellung auf.
Fügen Sie diesen Server zu .mcp.json hinzu. Machen Sie GMSCRAPER_API_KEY in der Umgebung verfügbar, die Claude Code startet.
{
"mcpServers": {
"google-maps-data": {
"type": "http",
"url": "https://gmapscrawl.com/api/mcp",
"headers": {
"Authorization": "Bearer ${GMSCRAPER_API_KEY}"
}
}
}
}Nach dem Speichern der Konfiguration verbinden Sie sich erneut und bestätigen, dass die drei Tools erscheinen. Folgen Sie der Schritt-für-Schritt-Einrichtungsanleitung.
Ihr erster Workflow
Beginnen Sie mit einem Testschlüssel und simulierten Daten. Wechseln Sie zu einem Live-Schlüssel, wenn Sie bereit sind, Ihr API-Kontingent zu nutzen.
Wählen Sie das API-Produkt und erstellen Sie einen Testschlüssel mit scrapes:write. Ihr API-Tarif muss MCP erlauben; Online und Extension haben getrennte Kontingente.
Schlüssel erstellenVerbinden Sie Ihren Client, prüfen Sie search_google_maps und fragen Sie eine Seite an. Erzeugen Sie eine neue Anfrage-ID für neue Arbeit und bewahren Sie sie beim Wiederholen derselben Anfrage auf.
Client-Einrichtung ansehenLesen Sie structuredContent.businesses und total. Kennzeichnen Sie Testergebnisse als simuliert, bewahren Sie fehlende Werte und stoppen Sie nach der angeforderten Seite.
Felder verstehenErsetzen Sie die Anfrage-ID für jede neue Suche. Dieses Beispiel führt keine Anfrage von der Seite aus.
{
"q": "coffee shops in Seattle",
"page": 1,
"hl": "en",
"extra": false,
"client_request_id": "replace-with-a-fresh-uuid"
}Was zurückkommt
Ergebnisse kommen direkt zurück; kein Job-Polling nötig. Behalten Sie die Beobachtungszeitpunkte der Quelle bei, wenn Sie das JSON in eine Tabelle oder einen Bericht umwandeln.
Beispiel-Prompts
Verwenden Sie diese Prompts nach dem Verbinden. Geben Sie wo nötig eine echte Feature-ID an und bitten Sie Ihren Agenten, Testergebnisse als simuliert zu kennzeichnen.
“Nutze search_google_maps einmal für Cafés in Seattle, Seite 1, extra false. Gib Namen, Websites, Telefonnummern, Bewertungen und Bewertungszahlen der zurückgegebenen Unternehmen zurück. Lass fehlende Felder leer und zeige Beobachtungsdaten. Stoppe nach dieser Seite.”
Erwartetes Ergebnis
Eine Tabelle mit bis zu 20 zurückgegebenen Unternehmen, mit Quellen-Zeitstempeln und bewahrten fehlenden Werten.
“Nutze für das von mir ausgewählte Unternehmen seine place.dataId als fid. Frage Seite 1 von get_google_maps_reviews mit sort_by 2 an. Fasse die Themen nur in diesen zurückgegebenen Bewertungen zusammen und zitiere ihre Daten. Rufe keine weiteren Seiten ab.”
Erwartetes Ergebnis
Eine begrenzte Zusammenfassung von bis zu 10 Bewertungen, ohne eine Seite als die Erfahrung aller Kunden zu behandeln.
“Nutze get_google_maps_photos für diese angegebene Feature-ID, nur Seite 1. Liste die zurückgegebenen photoUrl- und optionalen videoUrl-Felder auf und melde, ob next true ist. Lade keine Dateien herunter und rufe die nächste Seite nicht ab.”
Erwartetes Ergebnis
Bis zu 20 Galeriesätze und der zurückgegebene Paginierungsstatus, bereit zur Prüfung durch Ihre eigene Anwendung.
REST + MCP
MCP ist in kostenlosen und kostenpflichtigen API-Tarifen verfügbar. Jede erfolgreiche Live-Quellseite verbraucht eine API-Anfrageeinheit, einschließlich einer leeren Seite.
Testschlüssel liefern simulierte Fixtures mit null Anfrageeinheiten. Sie verifizieren Ihre Integration, statt echte Unternehmens-Leads zu erzeugen.
API-Schlüssel verwaltenFragen Sie nur die Seiten und Standorte an, die Ihre Aufgabe benötigt. Verwenden Sie eine neue Anfrage-ID für neue Arbeit; wiederholen Sie unsichere Anfragen mit derselben Eingabe und ID.
Nutzungshinweise lesenDer Google Maps Data Agent Skill ergänzt dieselben Tools um Workflow-Anleitungen, Operationsreferenzen und einen REST-Fallback.
Agent Skill entdeckenAPI-Hub entdecken → Online- und Extension-Tarife haben eigene Kontingente.
Verbindungshilfe
Nutzen Sie den Verbindungsstatus und den zurückgegebenen Fehler, um den nächsten Schritt zu wählen.
Er stellt search_google_maps, get_google_maps_reviews und get_google_maps_photos bereit. Search liefert bis zu 20 Unternehmen; Reviews bis zu 10 Datensätze und Photos bis zu 20 Galeriesätze pro Seite. Die Tools liefern strukturierte Daten direkt.
Verwenden Sie eine Version von Claude Code, Cursor, VS Code, Codex oder einen anderen MCP-Client, der Remote Streamable HTTP und einen privaten Authorization-Header unterstützt. Die vier Client-Konfigurationen oben nutzen denselben Endpunkt und API-Workspace-Schlüssel.
Erstellen Sie in Ihrem API-Workspace einen API-Schlüssel mit scrapes:write und konfigurieren Sie ihn privat als Bearer-Header. Browser-Cookies authentifizieren MCP nicht. Halten Sie Schlüssel aus Prompts, URLs und committetem Quellcode heraus.
Übergeben Sie die Maps-Feature-ID als fid. Sie können place.dataId aus einem zurückgegebenen Unternehmen verwenden. Reviews akzeptiert außerdem sort_by: 1 für Relevanz, 2 für neueste, 3 für höchste Bewertung oder 4 für niedrigste Bewertung. Lesen Sie next, bevor Sie eine weitere Medienseite in Betracht ziehen.
MCP teilt sich das REST-API-Kontingent und ist in kostenlosen und kostenpflichtigen API-Tarifen verfügbar. Eine erfolgreiche Live-Seite verbraucht eine Anfrageeinheit, einschließlich einer leeren Seite. Test-Zugangsdaten liefern simulierte Daten mit null Einheiten. Online- und Extension-Kontingente sind getrennt.
Der MCP-Server funktioniert allein. Der optionale Google Maps Data Agent Skill ergänzt wiederverwendbare Anweisungen, Operationsreferenzen und einen Helfer für REST-Fallback, wenn Ihre konfigurierte MCP-Verbindung nicht verfügbar ist.
Der nächste Schritt
Erstellen Sie einen API-Schlüssel, verbinden Sie Ihren bevorzugten Client und testen Sie eine fokussierte Unternehmenssuche.