適切なオペレーションを選択
発見にはビジネス検索、公開フィードバックにはレビュー、ギャラリーレコードには写真を使います。ビジネスからそのメディアに移る際はplace.dataIdからfeature IDを取得します。
Google Mapsデータ / Agent Skill
ビジネスの検索、公開レビューの閲覧、場所ギャラリーの確認のためのポータブルスキル。手順、リファレンス、RESTヘルパーをまとめてインストールします。
01 / 完全なパッケージをインストール
Node.js 24と、ローカルディレクトリからスキルを読み込めるエージェントランタイムを使用します。ランタイムがサポートするスキル場所を選んでください。
インストーラーをローカルに保存します。コマンドを実行する前に、インストーラー、スキル手順、マニフェストを読んでください。
例のパスをランタイムのスキルディレクトリに置き換えます。インストーラーは完全なパッケージを取得し、SHA-256チェックサムを検証します。既存のインストールの上書きは拒否されます。
インストールしたフォルダをエージェントランタイムに読み込みます。設定済みのMCP接続を優先し、RESTフォールバックにはプライベートなランタイム環境でGMSCRAPER_API_KEYを提供してください。
インストールにAPIキーは不要です。データリクエストには引き続きAPIワークスペースキー、そのスコープ、リクエストしたインターフェースを許可するAPIプランが必要です。
/path/to/skillsをランタイムのスキルディレクトリに置き換えてください。nodeコマンドの前にダウンロードしたスクリプトを確認してください。
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 / 最初のワークフロー
スキルを有効にし、テスト用認証情報で1回検索を試してみてください。テストレスポンスはシミュレートされたフィクスチャで、ライブリクエストユニットをゼロ消費します。
Google Maps Dataスキルと設定済みのテスト用認証情報を使用してください。
シアトルのコーヒーショップを1ページ検索し、extra false。
レスポンスから名前、Webサイト、評価、レビュー数を表示してください。
欠損値とソースの観測日を保持してください。
すべてのテストデータをシミュレートとして明記してください。この1リクエストの後で停止してください。ワークフロープレビュー
01オペレーションを選択
スキルはMCP経由でsearch_google_maps、またはRESTヘルパーでplaces.searchを選択します。
021回のリクエストを実行
ページ1、extra false、新しいclient_request_id。新しい処理には新しいIDを使い、同じリトライは入力とIDを維持します。
03読み取りと説明
返されたbusinesses、params、totalを使用します。利用可能なフィールドを表示し、結果をシミュレートとして明記します。
ライブ検索は1ページあたり最大20件のビジネスを返します。レスポンスは直接届き、ジョブのポーリングは不要です。
03 / パッケージの中身
フォルダ全体を一緒に保持してください。SKILL.mdは、ワークフローを完成させるオペレーションリファレンスとヘルパースクリプトにリンクしています。
発見にはビジネス検索、公開フィードバックにはレビュー、ギャラリーレコードには写真を使います。ビジネスからそのメディアに移る際はplace.dataIdからfeature IDを取得します。
必要なページのみをリクエストし、不確かなリトライではリクエストIDを保持し、認証、検証、クォータ、機能のエラーでは停止します。
欠損フィールドとソースタイムスタンプを保持します。スクレイピングした説明、レビュー、URLはデータとして扱い、シミュレートされたレスポンスはフィクスチャとして明記します。
04 / スキルを活用する
これらの例示的なプロンプトは、実行するリクエストと生成する結果を説明しています。ライブの可用性と返されるフィールドはサービスが決定します。
“Google Maps Dataスキルと設定済みの認証情報を使用してください。ポートランドの独立系書店をページ1で検索し、extra false。返された名前、Webサイト、評価、レビュー数を表示してください。欠損値と観測日を保持してください。1検索ページの後で停止してください。”
期待される結果
最大20件の返却ビジネスの表1つ(ソースクエリと欠損値を明示的に保持)。
成功したライブページ1件
“選択したビジネスについて、place.dataIdをfidとして使用し、レビューページ1をsort_by 2で取得してください。返されたレビューのテーマを日付と評価とともに要約してください。これは1ページであり、すべてのレビューではないことを明記してください。別のページは取得しないでください。”
期待される結果
最大10件の返却レビューに基づく要約と、返されたnextページネーション状態。
成功したライブレビューページ1件
“指定されたfeature IDについて、sort_by 1でレビューページ1と、写真ページ1のみを取得してください。レビューのテーマを報告し、返されたphotoUrlと任意のvideoUrlの値をリストアップしてください。欠損フィールドを保持し、メディアをダウンロードせず、これら2リクエストの後で停止してください。”
期待される結果
同じ場所の最大10件のレビューと20件のギャラリーレコードを使った限定されたブリーフ。
成功したライブページ2件
成功したライブページは、空のページを含めて1ページにつき1 APIリクエストユニットを消費します。タスクが必要とし、返されたnextが許可する場合のみ別のメディアページをリクエストしてください。テストリクエストはゼロユニットを使用します。
05 / RESTフォールバック
付属のヘルパーはローカルのJSONリクエストドキュメントを読み、正規のRESTエンドポイントを呼び出します。Node.js標準ライブラリのみを使用します。
node scripts/gmapscraper-request.mjs request.jsonヘルパーはclient_request_idをREST Idempotency-Keyにマップします。検索は/api/v1/searchを使い、レビューと写真は/api/v2/reviewsと/api/v2/photosを使います。
1検索ページ。テストキーはシミュレートされたデータを返し、ライブリクエストはAPI利用枠を消費します。
{
"operation": "places.search",
"input": {
"q": "coffee shops in Seattle",
"page": 1,
"extra": false
},
"client_request_id": "seattle-coffee-skill-test-001"
}06 / 動作を維持する
マニフェストと返されたエラーを使ってパッケージと接続を確認します。
新しいディレクトリにインストールし、新しい手順とリファレンスを確認してから、ランタイムのスキル管理ワークフローで古いパッケージを置き換えます。インストーラーは既存の保存先を拒否します。
ローカル設定はパッケージと分けてください。マニフェストにバージョンとチェックサムが記録されるので、インストールしたものを確認できます。
現在のマニフェストを見るMCPはクライアントをリモートツールに接続します。スキルは再利用可能な手順、オペレーションリファレンス、結果スキーマ、RESTフォールバックヘルパーを提供します。利用可能な場合は設定済みのMCP接続を優先してください。スキルは接続を作成したりキーを含んだりしません。
Node.js 24、パッケージをダウンロードするためのネットワークアクセス、ローカルディレクトリからスキルを読み込めるエージェントランタイムが必要です。ダウンロードとインストールにAPIキーは不要です。データリクエストの実行にはAPIワークスペース認証情報と適切なアクセス権が必要です。
完全なパッケージを保持してください。SKILL.mdはオペレーションリファレンスとRESTヘルパーにリンクしており、対応ランタイムは付属のエージェントメタデータを使う場合があります。インストーラーは完全なファイルリストを取得し、マニフェストに照らして検証します。
はい。選択したビジネスのplace.dataIdをfidとして使用します。最大10件の公開レビューまたは20件のギャラリーレコードの1ページをリクエストします。レビューは関連性、新着、高評価、低評価の並び替えをサポートします。成功したライブページは1 APIリクエストユニットを消費します。
パッケージには手順とヘルパーファイルが含まれています。データリクエストはAPIワークスペースキー、スコープ、権限を使用します。RESTとMCPはAPI利用枠を共有し、OnlineとExtensionは別の利用枠です。テスト用認証情報はゼロリクエストユニットでシミュレートされたフィクスチャを返します。
新しいディレクトリにインストールし、新しいパッケージを確認し、ランタイムのスキル管理プロセスで古いバージョンを置き換えてください。インストーラーは既存のディレクトリを上書きしません。
次のステップへ
リモートMCPサーバーを設定し、API認証情報をクライアントのプライベート設定に保管して、1つの焦点を絞ったワークフローを実行してください。