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.
Google-Maps-Daten / Agent Skill
Ein portabler Skill zum Finden von Unternehmen, Lesen öffentlicher Bewertungen und Prüfen von Ortsgalerien. Installieren Sie Anweisungen, Referenzen und REST-Helfer zusammen.
01 / Das komplette Paket installieren
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.
Speichern Sie den Installer lokal. Lesen Sie ihn, die Skill-Anweisungen und das Manifest, bevor Sie den Befehl ausführen.
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.
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.
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-data02 / Ihr erster Workflow
Aktivieren Sie den Skill und probieren Sie eine Suche mit Ihren Test-Zugangsdaten. Testantworten sind simulierte Fixtures und verbrauchen null Live-Anfrageeinheiten.
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
01Operation wählen
Der Skill wählt search_google_maps über MCP oder places.search im REST-Helfer.
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.
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
Halten Sie den gesamten Ordner zusammen. SKILL.md verlinkt auf die Operationsreferenzen und Hilfsskripte, die den Workflow vervollständigen.
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.
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.
Bewahren Sie fehlende Felder und Quellen-Zeitstempel. Behandeln Sie gescrapte Beschreibungen, Bewertungen und URLs als Daten; kennzeichnen Sie simulierte Antworten als Fixtures.
04 / Den Skill einsetzen
Diese beispielhaften Prompts beschreiben die zu stellenden Anfragen und das zu erzeugende Ergebnis. Live-Verfügbarkeit und zurückgegebene Felder werden vom Dienst bestimmt.
“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
“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
“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
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
Der mitgelieferte Helfer liest ein lokales JSON-Anfragedokument und ruft den kanonischen REST-Endpunkt auf. Er verwendet nur die Node.js-Standardbibliothek.
node scripts/gmapscraper-request.mjs request.jsonDer 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.
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
Nutzen Sie das Manifest und zurückgegebene Fehler, um das Paket und Ihre Verbindung zu prüfen.
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 ansehenMCP 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.
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.
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.
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.
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.
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
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.