# Send Google Maps Reviews Api Skill to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "google-maps-reviews-api-skill",
    "name": "Google Maps Reviews Api Skill",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/phheng/google-maps-reviews-api-skill",
    "canonicalUrl": "https://clawhub.ai/phheng/google-maps-reviews-api-skill",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/google-maps-reviews-api-skill",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=google-maps-reviews-api-skill",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/google_maps_reviews_api.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "google-maps-reviews-api-skill",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-03T21:58:41.349Z",
      "expiresAt": "2026-05-10T21:58:41.349Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=google-maps-reviews-api-skill",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=google-maps-reviews-api-skill",
        "contentDisposition": "attachment; filename=\"google-maps-reviews-api-skill-0.1.2.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "google-maps-reviews-api-skill"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/google-maps-reviews-api-skill"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/google-maps-reviews-api-skill",
    "downloadUrl": "https://openagent3.xyz/downloads/google-maps-reviews-api-skill",
    "agentUrl": "https://openagent3.xyz/skills/google-maps-reviews-api-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/google-maps-reviews-api-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/google-maps-reviews-api-skill/agent.md"
  }
}
```
## Documentation

### 📖 Introduction

This skill provides a one-stop review collection service using BrowserAct's Google Maps Reviews API template. It can extract structured review data directly from Google Maps search results. Simply provide the search keywords, language, and country to get clean, usable review data.

### ✨ Capability Features

No Hallucination, Precision Data Extraction: Uses preset workflows to avoid AI-generated hallucinations.
No CAPTCHA Issues: Built-in mechanisms to bypass reCAPTCHA or other verification challenges.
No IP Restrictions or Geo-fencing: Breaks through regional IP limits to ensure stable access worldwide.
Agile Execution: Faster task execution compared to pure AI-driven browser automation solutions.
High Cost-Effectiveness: Significantly reduces data acquisition costs compared to high-token-consumption AI solutions.

### 🔑 API Key Guidance

Before running, check the BROWSERACT_API_KEY environment variable. If not set, do not take other measures; instead, request the user to provide it.
Agent must inform the user:

"Since you haven't configured the BrowserAct API Key, please go to the BrowserAct Console to get your Key and provide it to me in this chat."

### 🛠️ Input Parameters Details

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

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



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



country (Country)

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

### 🚀 Invocation Method (Recommended)

The Agent should execute the following script to get results:

# Example call
python -u ./.cursor/skills/google-maps-reviews-api-skill/scripts/google_maps_reviews_api.py "Keywords" "Language" "Country"

### ⏳ Running Status Monitoring

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

Stay focused on the terminal output while waiting for results.
As long as the terminal is outputting new status logs, the task is running normally; do not misjudge it as hung or non-responsive.
If the status remains unchanged for a long time or the script stops outputting without returning results, consider a retry.

### 📊 Output Data Description

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

### ⚠️ Exception Handling & Retry Mechanism

If an error occurs (e.g., network fluctuations or task failure), follow this logic:

Check Output Content:

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



Retry Limit:

Automatic retry is limited to once. If the second attempt fails, stop and report the error to the user.

### 🌟 Typical Use Cases

Local Business Analysis: Find reviews for cafes or clinics in a specific area.
Reputation Monitoring: Track feedback for a specific brand location.
Competitive Benchmarking: Analyze reviews of competitor stores.
Sentiment Analysis: Gather review text for emotion and topic modeling.
Market Research: Evaluate service quality across different regions.
Lead Qualification: Use review data to identify high-quality service providers.
Customer Insight: Understand recurring complaints or praises.
Venue Research: Collect testimonials for parks, museums, or attractions.
Retail Monitoring: Gather feedback for newly opened stores.
Service Quality Audit: Analyze ratings and comments for a specific service chain.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: phheng
- Version: 0.1.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-03T21:58:41.349Z
- Expires at: 2026-05-10T21:58:41.349Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/google-maps-reviews-api-skill)
- [Send to Agent page](https://openagent3.xyz/skills/google-maps-reviews-api-skill/agent)
- [JSON manifest](https://openagent3.xyz/skills/google-maps-reviews-api-skill/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/google-maps-reviews-api-skill/agent.md)
- [Download page](https://openagent3.xyz/downloads/google-maps-reviews-api-skill)