google-maps-search-api-skill

Google Maps 検索自動化スキル

📖 概要

このスキルは、BrowserAct Google Maps Search API テンプレートを活用し、ビジネスデータをワンストップで収集します。Google Maps の検索リストから、構造化されたビジネス情報を直接抽出します。検索キーワード、言語、国のフィルターを指定するだけで、整理された使いやすいビジネスデータを取得できます。

✨ 特長

1. ハルシネーションなし：あらかじめ設定されたワークフローにより、AI 生成によるハルシネーションを防ぎ、安定して正確なデータを抽出します。
2. CAPTCHA の問題なし：reCAPTCHA やその他の認証チャレンジに対応する必要はありません。
3. IP 制限なし：地域ごとの IP 制限やジオフェンシングに対応する必要はありません。
4. 高速な実行：AI 主導のブラウザー自動化のみを利用するソリューションと比べて、タスクをより速く実行できます。
5. 費用対効果が高い：大量のトークンを消費する AI ソリューションと比べて、データ取得コストを大幅に削減できます。

🔑 API キーの設定

実行前に、BROWSERACT_API_KEY 環境変数を確認してください。設定されていない場合は、ほかの対応は行わず、ユーザーに確認して設定を待ってください。 エージェントはユーザーに次のように伝えてください：

「BrowserAct API Key が設定されていません。BrowserAct Console にアクセスして、Key を取得してください。」

🛠️ 入力パラメーター

スクリプトを呼び出す際、エージェントはユーザーのニーズに応じて次のパラメーターを柔軟に設定してください。

1. KeyWords

   • 型：string
   • 説明：Google Maps で検索する内容です。ビジネス名、カテゴリ、特定のキーワードを指定できます。
   • 例：coffee shop、dental clinic、coworking space

2. language

   • 型：string
   • 説明：UI の言語と、返されるテキストフィールドの言語を設定します。
   • 一般的な値：en、de、fr、it、es、ja、zh-CN、zh-TW
   • デフォルト：en

3. country

   • 型：string
   • 説明：検索結果に適用する国または地域の優先条件を設定します。
   • 例：us、gb、ca、au、de、fr、jp
   • デフォルト：us

4. max_dates

   • 型：number
   • 説明：検索結果リストから抽出する場所の最大数です。
   • デフォルト：100

🚀 使用方法

「コマンドを 1 行実行して結果を取得」するため、エージェントは次の独立したスクリプトを実行してください。

# Example call
python -u ./scripts/google_maps_search_api.py "search keywords" "language" "country" count

⏳ 実行状況の監視

このタスクではブラウザーの自動操作を行うため、完了までに数分かかる場合があります。スクリプトはタイムスタンプ付きのステータスログ（例：[14:30:05] Task Status: running）を継続的に出力します。 エージェントへの指示：

• スクリプトの結果を待つ間、ターミナルの出力を監視し続けてください。
• ターミナルに新しいステータスログが出力されている限り、タスクは正常に実行中です。デッドロックや応答停止と誤認しないでください。
• ステータスが長時間変わらない場合、またはスクリプトが結果を返さずに出力を停止した場合にのみ、再試行の仕組みを起動してください。

📊 データ出力

実行が成功すると、スクリプトは API レスポンスから結果を解析し、直接出力します。フィールドは次のとおりです。

• name：ビジネス名
• full address：住所
• rating：星評価
• review count：レビュー数
• price range：価格帯
• cuisine type：ビジネスのカテゴリ
• amenity tags：Wi-Fi などの設備情報
• review snippet：レビューの短い抜粋
• service options：サービスの案内（例：「オンラインで注文」）

⚠️ エラー処理と再試行

スクリプトの実行中にエラーが発生した場合（ネットワークの変動やタスクの失敗など）、エージェントは次のロジックに従います。

1. 出力内容を確認する：

   • 出力に "Invalid authorization" が含まれている場合、API Key が無効か期限切れであることを意味します。再試行せず、API Key を再確認し、正しいものを提示するようユーザーに案内してください。
   • 出力に "Invalid authorization" が含まれていないものの、タスクが失敗した場合（出力が Error: で始まる、または結果が空であるなど）、エージェントはスクリプトの再実行を自動的に1回試行します。

2. 再試行の上限：

   • 自動再試行は1回のみです。2回目の試行も失敗した場合は、再試行を中止し、具体的なエラー情報をユーザーに報告してください。

🌟 代表的な使用例

1. 地域の店舗検索：マンハッタンにある「イタリア料理店」をすべて検索します。
2. 営業リードの獲得：見込み顧客の開拓に向けて、ロンドンにある「不動産会社」の一覧を抽出します。
3. 競合マッピング：特定の都市にある「Starbucks」の店舗をすべて特定し、競合状況をマッピングします。
4. 市場調査：パリの「ブティックホテル」を、評価や価格帯も含めて分析します。
5. 連絡先の収集：シドニーにある「歯科クリニック」の住所と名称を収集します。
6. サービス検索：特定の地域で「24時間営業の薬局」や「緊急対応の配管工」を検索します。
7. 地域の動向調査：地域に新しくオープンする「ジム」や「ヨガスタジオ」を追跡します。
8. 構造化データのエクスポート：CRM との連携に向けて、「自動車販売店」の構造化データをエクスポートします。
9. センチメント分析の準備：「人気の観光名所」のレビューの抜粋と評価を取得します。
10. グローバル検索のローカライズ：言語や国の設定を変えて、世界各地の「テックハブ」を調査します。