google-maps-reviews-api-skill

Google Maps Reviews 自動化スキル

📖 はじめに

このスキルは、BrowserAct の Google Maps Reviews API テンプレートを使用した、レビュー収集のワンストップサービスを提供します。Google マップの検索結果から、構造化されたレビュー データを直接抽出できます。検索キーワード、言語、国を指定するだけで、整理された使いやすいレビュー データを取得できます。

✨ 特長

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

🔑 API キーの設定

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

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

🛠️ 入力パラメーター

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

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

   • 型：string
   • 説明：Google マップで場所を検索する際に使用するクエリ（例：店舗名、カテゴリ）。
   • 例：coffee shop、dental clinic、Tesla showroom

2. language（言語）

   • 型：string
   • 説明：UI の言語と、返されるテキストの言語を設定します。
   • 対応する値：en、zh-CN、es、fr など。
   • デフォルト：en

3. country（国）

   • 型：string
   • 説明：検索結果に適用する国または地域の優先設定です。
   • 対応する値：us、gb、ca、au、jp など。
   • デフォルト：us

🚀 使用方法

「ワンラインコマンドで結果を取得」するには、次の独立したスクリプトを使用してください。

# Example call
python -u ./scripts/google_maps_reviews_api.py "Keywords" "Language" "Country"

⏳ 実行状況の監視

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

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

📊 データ出力

実行が成功すると、スクリプトは API レスポンスを解析し、次の結果を出力します：

• author_name：レビュー投稿者の表示名
• author_profile_url：レビュー投稿者のプロフィール URL
• rating：星評価
• text：レビュー本文
• comment_date：人が読みやすい形式の日付
• likes_count：いいねの数
• author_image_url：レビュー投稿者のアバター URL

⚠️ エラー処理と再試行

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

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

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

2. 再試行の上限：

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

🌟 代表的なユースケース

1. 地域ビジネスの分析：特定の地域にあるカフェやクリニックの口コミを検索します。
2. 評判のモニタリング：特定ブランドの店舗へのフィードバックを追跡します。
3. 競合他社との比較：競合店舗の口コミを分析します。
4. 感情分析：感情やトピックのモデル化に使用する口コミの文章を収集します。
5. 市場調査：さまざまな地域のサービス品質を評価します。
6. 見込み客の評価：口コミデータを使って、質の高いサービス提供者を特定します。
7. 顧客インサイト：繰り返し寄せられる苦情や称賛を把握します。
8. 施設の調査：公園、博物館、観光名所の体験談を収集します。
9. 小売店のモニタリング：新規開店した店舗へのフィードバックを収集します。
10. サービス品質の監査：特定のサービスチェーンの評価やコメントを分析します。