Google Maps Reviews Automation Skill

"Since you haven't configured the BrowserAct API Key, please visit the BrowserAct Console to get your Key."

🛠️ Input Parameters

The Agent should flexibly configure the following parameters when calling the script:

1. KeyWords (Search Keywords)

   • Type: string
   • Description: The query used to find places on Google Maps (e.g., business names, categories).
   • Example: coffee shop, dental clinic, Tesla showroom

2. language (Language)

   • Type: string
   • Description: Sets the UI language and the language of the returned text.
   • Supported values: en, zh-CN, es, fr, etc.
   • Default: en

3. country (Country)

   • Type: string
   • Description: Country or region bias for search results.
   • Supported values: us, gb, ca, au, jp, etc.
   • Default: us

🚀 Usage

Agent should use the following independent script to achieve "one-line command result":

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

⏳ Execution Monitoring

Since this task involves automated browser operations, it may take some time (several minutes). The script will continuously output status logs with timestamps (e.g., [14:30:05] Task Status: running). Agent Instructions:

• While waiting for the script result, keep monitoring the terminal output.
• As long as the terminal is outputting new status logs, the task is running normally; do not mistake it for a deadlock or unresponsiveness.
• Only if the status remains unchanged for a long time or the script stops outputting without returning a result should you consider triggering the retry mechanism.

📊 Data Output

After successful execution, the script parses and prints results from the API response:

• author_name: Display name of the reviewer
• author_profile_url: Profile URL of the reviewer
• rating: Star rating
• text: Review text content
• comment_date: Human-readable date
• likes_count: Number of likes
• author_image_url: Reviewer's avatar URL

⚠️ Error Handling & Retry

If an error occurs during script execution (e.g., network fluctuations or task failure), the Agent should follow this logic:

1. Check Output Content:

   • If the output contains "Invalid authorization", it means the API Key is invalid or expired. Do not retry; guide the user to re-check and provide the correct API Key.
   • If the output does not contain "Invalid authorization" but the task failed (e.g., output starts with Error: or returns empty results), the Agent should automatically try to re-execute the script once.

2. Retry Limit:

   • Automatic retry is limited to one time. If the second attempt fails, stop retrying and report the specific error information to the user.

🌟 Typical Use Cases

1. Local Business Analysis: Find reviews for cafes or clinics in a specific area.
2. Reputation Monitoring: Track feedback for a specific brand location.
3. Competitive Benchmarking: Analyze reviews of competitor stores.
4. Sentiment Analysis: Gather review text for emotion and topic modeling.
5. Market Research: Evaluate service quality across different regions.
6. Lead Qualification: Use review data to identify high-quality service providers.
7. Customer Insight: Understand recurring complaints or praises.
8. Venue Research: Collect testimonials for parks, museums, or attractions.
9. Retail Monitoring: Gather feedback for newly opened stores.
10. Service Quality Audit: Analyze ratings and comments for a specific service chain.