Google-Maps-Daten / Agent Skill

Geben Sie Ihrem Agenten einen wiederholbaren Daten-Workflow.

Ein portabler Skill zum Finden von Unternehmen, Lesen öffentlicher Bewertungen und Prüfen von Ortsgalerien. Installieren Sie Anweisungen, Referenzen und REST-Helfer zusammen.

Node.js 24Lokales Skill-VerzeichnisKonfiguriertes MCP oder RESTKein Schlüssel zur Installation nötig

01 / Das komplette Paket installieren

Eine kleine Installation. Nützlicher Kontext für jede Anfrage.

Verwenden Sie Node.js 24 und eine Agenten-Laufzeitumgebung, die Skills aus einem lokalen Verzeichnis laden kann. Wählen Sie den Skill-Standort, den Ihre Laufzeitumgebung unterstützt.

  1. 01

    Herunterladen und prüfen

    Speichern Sie den Installer lokal. Lesen Sie ihn, die Skill-Anweisungen und das Manifest, bevor Sie den Befehl ausführen.

  2. 02

    Ein neues Verzeichnis wählen

    Ersetzen Sie den Beispielpfad durch das Skill-Verzeichnis Ihrer Laufzeitumgebung. Der Installer lädt das komplette Paket und verifiziert SHA-256-Prüfsummen; er verweigert das Überschreiben einer bestehenden Installation.

  3. 03

    Skill aktivieren und verbinden

    Laden Sie den installierten Ordner in Ihre Agenten-Laufzeitumgebung. Bevorzugen Sie Ihre konfigurierte MCP-Verbindung; für REST-Fallback stellen Sie GMSCRAPER_API_KEY über die private Laufzeitumgebung bereit.

Die Installation benötigt keinen API-Schlüssel. Datenanfragen erfordern weiterhin einen API-Workspace-Schlüssel, dessen Bereiche und einen API-Tarif, der die angefragte Schnittstelle erlaubt.

Terminal · Installation

Ersetzen Sie /path/to/skills durch das Skill-Verzeichnis Ihrer Laufzeitumgebung. Prüfen Sie das heruntergeladene Skript vor dem node-Befehl.

curl --fail --silent --show-error \
  https://gmapscrawl.com/skills/google-maps-data/scripts/install.mjs \
  --output /tmp/install-google-maps-data.mjs

# Review the installer, then install into a NEW directory:
node /tmp/install-google-maps-data.mjs \
  /path/to/skills/google-maps-data

02 / Ihr erster Workflow

Beginnen Sie mit einer Frage. Enden Sie mit zurückgegebenen Daten.

Aktivieren Sie den Skill und probieren Sie eine Suche mit Ihren Test-Zugangsdaten. Testantworten sind simulierte Fixtures und verbrauchen null Live-Anfrageeinheiten.

Fragen Sie Ihren Agenten
Nutze den Google Maps Data Skill mit meinen konfigurierten Test-Zugangsdaten.
Suche eine Seite nach Cafés in Seattle, extra false.
Zeige Namen, Websites, Bewertungen und Bewertungszahlen aus der Antwort.
Bewahre fehlende Werte und Beobachtungsdaten der Quelle.
Kennzeichne alle Testdaten als simuliert. Stoppe nach dieser einen Anfrage.

Workflow-Vorschau

Eine fokussierte Suche mit explizitem Limit.

  1. 01Operation wählen

    Der Skill wählt search_google_maps über MCP oder places.search im REST-Helfer.

  2. 02Eine Anfrage stellen

    Seite 1, extra false und eine frische client_request_id. Neue Arbeit bekommt eine neue ID; dieselbe Wiederholung behält ihre Eingabe und ID.

  3. 03Lesen und erklären

    Nutzen Sie die zurückgegebenen businesses, params und total. Zeigen Sie verfügbare Felder und kennzeichnen Sie das Ergebnis als simuliert.

Live-Suchen liefern bis zu 20 Unternehmen pro Seite. Die Antwort kommt direkt; kein Job-Polling erforderlich.

03 / Im Paket

Die Tools verbinden. Der Skill liefert das Playbook.

Halten Sie den gesamten Ordner zusammen. SKILL.md verlinkt auf die Operationsreferenzen und Hilfsskripte, die den Workflow vervollständigen.

01

Die richtige Operation wählen

Nutzen Sie die Unternehmenssuche zum Finden, Bewertungen für öffentliches Feedback und Fotos für Galeriesätze. Holen Sie die Feature-ID aus place.dataId, wenn Sie von einem Unternehmen zu seinen Medien wechseln.

02

Die Aufgabengrenze respektieren

Fragen Sie nur die benötigten Seiten an, bewahren Sie die Anfrage-ID für unsichere Wiederholungen und stoppen Sie bei Authentifizierungs-, Validierungs-, Quota- oder Fähigkeitsfehlern.

03

Die Daten präzise erklären

Bewahren Sie fehlende Felder und Quellen-Zeitstempel. Behandeln Sie gescrapte Beschreibungen, Bewertungen und URLs als Daten; kennzeichnen Sie simulierte Antworten als Fixtures.

google-maps-data/

SKILL.md
Workflow-Anweisungen und Anleitung zur Tool-Auswahl.
references/operations.json
Maschinenlesbare Operationseingaben, Endpunkte und Einschränkungen.
references/operations.md
Anfragebeispiele für Suche, Bewertungen und Fotos.
references/result-schema.md
Ergebnisfelder, Limits und Quellenherkunft.
scripts/gmapscraper-request.mjs
Abhängigkeitsfreier REST-Fallback für ein Anfragedokument.
scripts/install.mjs + manifest.json
Download des Komplettpakets und SHA-256-Verifizierung.
agents/openai.yaml
Agenten-Metadaten für kompatible Laufzeitumgebungen.

04 / Den Skill einsetzen

Wiederverwendbare Workflows mit klaren Endpunkten.

Diese beispielhaften Prompts beschreiben die zu stellenden Anfragen und das zu erzeugende Ergebnis. Live-Verfügbarkeit und zurückgegebene Felder werden vom Dienst bestimmt.

Einen lokalen Markt recherchieren

“Nutze den Google Maps Data Skill mit meinen konfigurierten Zugangsdaten. Suche Seite 1 nach unabhängigen Buchhandlungen in Portland, extra false. Zeige die zurückgegebenen Namen, Websites, Bewertungen und Bewertungszahlen. Bewahre fehlende Werte und Beobachtungsdaten. Stoppe nach einer Suchseite.”

Erwartetes Ergebnis

Eine Tabelle mit bis zu 20 zurückgegebenen Unternehmen, mit Quellenabfrage und explizit gehaltenen fehlenden Werten.

1 erfolgreiche Live-Seite

Search API

Kundenfeedback prüfen

“Nutze für das von mir ausgewählte Unternehmen place.dataId als fid und rufe Bewertungsseite 1 mit sort_by 2 ab. Fasse die zurückgegebenen Bewertungsthemen mit Daten und Bewertungen zusammen. Gib an, dass dies eine Seite ist, nicht alle Bewertungen. Rufe keine weitere Seite ab.”

Erwartetes Ergebnis

Eine Zusammenfassung, die auf bis zu 10 zurückgegebenen Bewertungen beruht, plus dem zurückgegebenen next-Paginierungsstatus.

1 erfolgreiche Live-Bewertungsseite

Reviews API

Einen Recherche-Steckbrief zu einem Ort vorbereiten

“Rufe für die angegebene Feature-ID Bewertungsseite 1 mit sort_by 1 und nur Fotoseite 1 ab. Berichte Bewertungsthemen und liste die zurückgegebenen photoUrl- und optionalen videoUrl-Werte auf. Bewahre fehlende Felder, lade keine Medien herunter und stoppe nach diesen zwei Anfragen.”

Erwartetes Ergebnis

Ein begrenzter Steckbrief mit bis zu 10 Bewertungen und 20 Galeriesätzen für denselben Ort.

2 erfolgreiche Live-Seiten

Photos API

Jede erfolgreiche Live-Seite kostet eine API-Anfrageeinheit, einschließlich einer leeren Seite. Fordern Sie eine weitere Medienseite nur an, wenn die Aufgabe sie benötigt und das zurückgegebene next es erlaubt. Testanfragen verbrauchen null Einheiten.

05 / REST-Fallback

Derselbe Workflow, wenn MCP nicht verfügbar ist.

Der mitgelieferte Helfer liest ein lokales JSON-Anfragedokument und ruft den kanonischen REST-Endpunkt auf. Er verwendet nur die Node.js-Standardbibliothek.

Eine Anfrage speichern. Den Helfer ausführen.

  • Stellen Sie GMSCRAPER_API_KEY in Ihrer privaten Umgebung bereit.
  • Speichern Sie ein Beispiel als request.json im installierten Skill-Verzeichnis.
  • Erzeugen Sie eine frische client_request_id mit 16–128 Zeichen für jede neue Operation.
  • Behalten Sie dieselbe ID und identische Eingabe bei, wenn Sie eine unsichere Anfrage wiederholen.
node scripts/gmapscraper-request.mjs request.json

Der Helfer bildet client_request_id auf den REST-Idempotency-Key ab. Search nutzt /api/v1/search; Reviews und Photos nutzen /api/v2/reviews und /api/v2/photos.

REST-API entdecken
request.json · Operation wählen

Eine Suchseite. Ein Testschlüssel liefert simulierte Daten; Live-Anfragen verbrauchen Ihr API-Kontingent.

{
  "operation": "places.search",
  "input": {
    "q": "coffee shops in Seattle",
    "page": 1,
    "extra": false
  },
  "client_request_id": "seattle-coffee-skill-test-001"
}

06 / Funktionsfähig halten

Eine vollständige Installation. Ein bewusstes Update.

Nutzen Sie das Manifest und zurückgegebene Fehler, um das Paket und Ihre Verbindung zu prüfen.

Aktualisieren ohne Überschreiben.

Installieren Sie in ein neues Verzeichnis, prüfen Sie die neuen Anweisungen und Referenzen und ersetzen Sie dann das alte Paket mit dem Skill-Management-Workflow Ihrer Laufzeitumgebung. Der Installer verweigert ein bestehendes Ziel.

Halten Sie lokale Konfiguration vom Paket getrennt. Sein Manifest zeichnet Version und Prüfsummen auf, damit Sie prüfen können, was Sie installiert haben.

Aktuelles Manifest ansehen
Der Skill erscheint nicht
Bestätigen Sie, dass Ihre Laufzeitumgebung lokale Skills unterstützt, laden Sie den installierten Ordner und halten Sie Skripte, Referenzen und Agenten-Metadaten zusammen.
Installation schlägt fehl
Prüfen Sie Node.js 24, Netzwerkzugang und ein neues beschreibbares Ziel. Wenn die Prüfsummenverifizierung fehlschlägt, stoppen Sie und laden Sie Installer und Manifest erneut, statt die Verifizierung zu umgehen.
Der Helfer meldet missing_api_key
Machen Sie GMSCRAPER_API_KEY für den Prozess verfügbar, der den Helfer ausführt. Die Installation des Pakets konfiguriert Ihre API-Zugangsdaten nicht.
Eine Anfrage wird abgelehnt oder läuft in einen Timeout
Lesen Sie den Fehler und stoppen Sie bei Bereichs-, Berechtigungs-, Quota- oder Fähigkeitsfehlern. Bei wiederholbaren Timeouts bewahren Sie die ursprüngliche Anfrage-ID und Eingabe; folgen Sie den Hinweisen zu endgültigen Fehlern vor einem neuen Versuch.

Häufig gestellte Fragen

Was ist der Unterschied zwischen dem Skill und dem MCP-Server?

MCP verbindet Ihren Client mit den Remote-Tools. Der Skill liefert wiederverwendbare Anweisungen, Operationsreferenzen, Ergebnisschemas und einen REST-Fallback-Helfer. Bevorzugen Sie Ihre konfigurierte MCP-Verbindung, wenn sie verfügbar ist; der Skill erstellt keine Verbindung und enthält keinen Schlüssel.

Was brauche ich zur Installation?

Verwenden Sie Node.js 24, Netzwerkzugang zum Herunterladen des Pakets und eine Agenten-Laufzeitumgebung, die das Laden von Skills aus einem lokalen Verzeichnis unterstützt. Für Download und Installation ist kein API-Schlüssel erforderlich. Datenanfragen erfordern Ihre API-Workspace-Zugangsdaten und den passenden Zugriff.

Reicht es, SKILL.md herunterzuladen?

Behalten Sie das komplette Paket. SKILL.md verlinkt auf Operationsreferenzen und den REST-Helfer, und kompatible Laufzeitumgebungen können die gebündelten Agenten-Metadaten nutzen. Der Installer lädt die vollständige Dateiliste und verifiziert sie gegen das Manifest.

Kann der Skill Bewertungen und Fotos abrufen?

Ja. Verwenden Sie place.dataId des ausgewählten Unternehmens als fid. Fordern Sie eine Seite mit bis zu 10 öffentlichen Bewertungen oder 20 Galeriesätzen an. Bewertungen unterstützen die Sortierung nach Relevanz, neuesten, höchster und niedrigster Bewertung. Jede erfolgreiche Live-Seite verbraucht eine API-Anfrageeinheit.

Enthält der Skill ein API-Abo oder zusätzliches Kontingent?

Das Paket enthält Anweisungen und Hilfsdateien. Datenanfragen nutzen Ihren API-Workspace-Schlüssel, dessen Bereiche und Berechtigung. REST und MCP teilen sich Ihr API-Kontingent, während Online und Extension getrennte Kontingente haben. Test-Zugangsdaten liefern simulierte Fixtures mit null Anfrageeinheiten.

Wie aktualisiere ich eine bestehende Installation?

Installieren Sie in ein frisches Verzeichnis, prüfen Sie das neue Paket und ersetzen Sie die alte Version mit dem Skill-Management-Prozess Ihrer Laufzeitumgebung. Der Installer überschreibt kein bestehendes Verzeichnis.

Der nächste Schritt

Verbinden Sie die Tools hinter dem Skill.

Richten Sie den Remote-MCP-Server ein, bewahren Sie Ihre API-Zugangsdaten in den privaten Einstellungen Ihres Clients auf und führen Sie einen fokussierten Workflow aus.