google-maps-api-skill

Google Maps 自動スクレイピングスキル

📖 はじめに

このスキルは、BrowserAct の Google Maps API テンプレートを活用し、ビジネスデータを一括で収集できるサービスを提供します。Google Maps からビジネス名、カテゴリ、連絡先、評価などの構造化された詳細情報を直接抽出します。検索キーワードと場所の条件を指定するだけで、すぐに活用できるクリーンなデータを取得できます。

✨ 特長

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

🔑 API キーの設定

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

「BrowserAct API キーが設定されていないため、BrowserAct Console にアクセスしてキーを取得してください。」

🛠️ 入力パラメーター

ユーザーの要件に応じて、次のパラメーターを設定します。

1. keywords（検索キーワード）

   • タイプ：string
   • 説明：Google Maps で検索するクエリです。
   • 例：coffee shop、dental clinic、Turkish-style restaurant

2. language（UI 言語）

   • タイプ：string
   • 説明：UI の言語と、返されるテキストの言語を指定します（例：en、zh-CN）。
   • デフォルト：en

3. country（国の条件）

   • タイプ：string
   • 説明：国または地域の条件を指定します（例：us、gb、ca）。
   • デフォルト：us

🚀 使用方法

次のスクリプトを実行すると、1 つのコマンドで結果を取得できます。

# Example call
python -u ./scripts/google_maps_api.py "keywords" "language" "country"

⏳ 実行状況の監視

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

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

📊 データ出力

成功すると、スクリプトは API から次のフィールドを解析して出力します。

• Title Name：ビジネスの正式名称
• Category_primary：ビジネスの主要カテゴリ
• Address：住所（番地まで）
• Phone number：連絡先の電話番号
• Website link：公式 URL
• Rating：星評価の平均
• reviews_count：レビューの総数
• business_status：営業状況（例：営業中）

⚠️ エラー処理と再試行

スクリプトの実行中にエラーが発生した場合（ネットワークの不安定やタスクの失敗など）、エージェントは次の手順に従ってください。

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

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

2. 再試行の上限：

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

🌟 代表的なユースケース

1. リードの獲得：「us」の「SaaS企業」を検索して、営業活動に活用します。
2. 競合調査：特定の地域の「コーヒーショップ」のデータを抽出します。
3. 市場分析：地域内の「歯科クリニック」の密度を特定します。
4. 連絡先情報の取得：「不動産会社」の電話番号とウェブサイトを取得します。
5. 地域のサービス検索：評価の高い「トルコ風レストラン」を検索します。
6. 事業状況の監視：特定の店舗が「営業中」かどうかを確認します。
7. ディレクトリの作成：地域のビジネスディレクトリ用に、住所とカテゴリを収集します。
8. 評価のベンチマーク：さまざまな「高級ホテル」の評価を比較します。
9. グローバルな企業調査：「gb」や「au」など、さまざまな国の「テック系スタートアップ」を調査します。
10. データ同期の自動化：地域のビジネスデータを定期的にCRMに取り込みます。