Google-Maps-Daten / MCP-Server

Google-Maps-Daten, direkt in Ihrem KI-Workflow.

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

Von der Unternehmensfindung zum Ortsdetail.

Jedes Tool liefert sein Ergebnis direkt. Wählen Sie die Operation, die Ihre Aufgabe benötigt, und halten Sie die angeforderten Seiten explizit.

Unternehmen finden

search_google_maps

Suchen 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 entdecken

Öffentliche Bewertungen lesen

get_google_maps_reviews

Nutzen 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 entdecken

Galeriemedien durchsuchen

get_google_maps_photos

Rufen 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 entdecken

Reviews 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

Ein Endpunkt. Ihr API-Workspace.

Ihr Client übernimmt Initialisierung und Tool-Erkennung und sendet dann Ihren API-Schlüssel mit jeder Anfrage.

Remote-MCP-Verbindung
POST https://gmapscrawl.com/api/mcp
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json
Accept: application/json, text/event-stream

Client-Einrichtung

Wählen Sie den Client, in dem Sie arbeiten.

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}"
      }
    }
  }
}
Dokumentation zu Claude Code ↗

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

Verbinden. Eine Seite testen. Das Ergebnis lesen.

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.

01

Workspace vorbereiten

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 erstellen
02

Ein Tool entdecken und aufrufen

Verbinden 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 ansehen
03

Die zurückgegebenen Unternehmen nutzen

Lesen Sie structuredContent.businesses und total. Kennzeichnen Sie Testergebnisse als simuliert, bewahren Sie fehlende Werte und stoppen Sie nach der angeforderten Seite.

Felder verstehen
search_google_maps aufrufen

Ersetzen 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

Strukturierte Datensätze, in derselben Tool-Antwort.

businesses
Bis zu 20 zurückgegebene Unternehmen; Felder können fehlen.
params + total
Die normalisierte Abfrage und die Anzahl auf dieser Seite.
simulated + usage metadata
Testantworten kennzeichnen Fixture-Daten und verbrauchen null Live-Anfrageeinheiten.
isError
Prüfen Sie den Fehler, bevor Sie melden, dass ein Tool erfolgreich war.

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

Eine nützliche Frage. Ein klarer Endpunkt.

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.

Eine fokussierte Unternehmensliste erstellen

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

Eine Bewertungsseite zusammenfassen

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

Eine Galerie prüfen

“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

Ein API-Kontingent über beide Schnittstellen.

MCP ist in kostenlosen und kostenpflichtigen API-Tarifen verfügbar. Jede erfolgreiche Live-Quellseite verbraucht eine API-Anfrageeinheit, einschließlich einer leeren Seite.

01

Ohne Live-Nutzung testen

Testschlüssel liefern simulierte Fixtures mit null Anfrageeinheiten. Sie verifizieren Ihre Integration, statt echte Unternehmens-Leads zu erzeugen.

API-Schlüssel verwalten
02

Anfragen begrenzt halten

Fragen 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 lesen
03

Wiederverwendbare Anweisungen hinzufügen

Der Google Maps Data Agent Skill ergänzt dieselben Tools um Workflow-Anleitungen, Operationsreferenzen und einen REST-Fallback.

Agent Skill entdecken

API-Hub entdecken → Online- und Extension-Tarife haben eigene Kontingente.

Verbindungshilfe

Zur nächsten erfolgreichen Anfrage.

Nutzen Sie den Verbindungsstatus und den zurückgegebenen Fehler, um den nächsten Schritt zu wählen.

Der Client verbindet sich, aber es erscheinen keine Tools
Bestätigen Sie, dass der Endpunkt /api/mcp ist und Ihr Client Remote Streamable HTTP mit einem privaten Authorization-Header unterstützt. Laden Sie die Verbindung neu und prüfen Sie, ob der Prozess den konfigurierten Schlüssel lesen kann.
401 oder 403
Prüfen Sie Schlüsselablauf, erlaubte IPs, aktiven Workspace-Zugang, den scrapes:write-Bereich und einen API-Tarif, der MCP erlaubt. Browser-Login-Cookies authentifizieren den Endpunkt nicht.
invalid_request
Lesen Sie das Schema des gewählten Tools. Geben Sie eine eindeutige client_request_id mit 16–128 Zeichen an; Reviews und Photos benötigen außerdem die FID aus place.dataId, nicht einen Unternehmensnamen oder eine andere Ortskennung.
rate_limited oder quota_exceeded
Beachten Sie retry_after bei Ratenlimits. Stoppen Sie, wenn das API-Kontingent erschöpft ist, und prüfen Sie Ihre API-Nutzung; ein weiterer Schlüssel erhöht das Kontingent nicht.
capability_unavailable oder ein Quellenfehler
Prüfen Sie den Dienststatus und den zurückgegebenen Fehler. Die Verfügbarkeit wird vom Server bestimmt. Halten Sie fehlende oder nicht verfügbare Daten in Ihrem Ergebnis explizit.
Timeout oder isError: true
Prüfen Sie den Tool-Fehler auch dann, wenn die HTTP-Verbindung erfolgreich war. Bei wiederholbaren Fehlern behalten Sie innerhalb Ihrer Aufgabenfrist dieselbe Eingabe und Anfrage-ID bei. Folgen Sie den Hinweisen zu endgültigen Fehlern, bevor Sie einen neuen Versuch starten.

Dienststatus Fehler- und Wiederholungshinweise

Häufig gestellte Fragen

Was kann der Google-Maps-MCP-Server?

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.

Welche Clients kann ich verbinden?

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.

Wie authentifiziere ich mich?

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.

Wie finden Reviews und Photos den richtigen Ort?

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

Hat MCP ein eigenes Kontingent?

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.

Brauche ich auch den Agent Skill?

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

Bringen Sie Google-Maps-Daten in Ihre nächste Konversation.

Erstellen Sie einen API-Schlüssel, verbinden Sie Ihren bevorzugten Client und testen Sie eine fokussierte Unternehmenssuche.