{ "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": { "downloadMode": "redirect", "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", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "SKILL.md", "scripts/google_maps_reviews_api.py" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "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." ], "prompts": [ { "label": "New install", "body": "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." }, { "label": "Upgrade existing", "body": "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." } ] }, "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "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." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/google-maps-reviews-api-skill", "agentPageUrl": "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" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "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." ], "prompts": [ { "label": "New install", "body": "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." }, { "label": "Upgrade existing", "body": "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." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "šŸ“– Introduction", "body": "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." }, { "title": "āœØ Capability Features", "body": "No Hallucination, Precision Data Extraction: Uses preset workflows to avoid AI-generated hallucinations.\nNo CAPTCHA Issues: Built-in mechanisms to bypass reCAPTCHA or other verification challenges.\nNo IP Restrictions or Geo-fencing: Breaks through regional IP limits to ensure stable access worldwide.\nAgile Execution: Faster task execution compared to pure AI-driven browser automation solutions.\nHigh Cost-Effectiveness: Significantly reduces data acquisition costs compared to high-token-consumption AI solutions." }, { "title": "šŸ”‘ API Key Guidance", "body": "Before running, check the BROWSERACT_API_KEY environment variable. If not set, do not take other measures; instead, request the user to provide it.\nAgent must inform the user:\n\n\"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.\"" }, { "title": "šŸ› ļø Input Parameters Details", "body": "The Agent should flexibly configure the following parameters when calling the script:\n\nKeyWords (Search Keywords)\n\nType: string\nDescription: The query used to find places on Google Maps (e.g., business names, categories).\nExample: coffee shop, dental clinic, Tesla showroom\n\n\n\nlanguage (Language)\n\nType: string\nDescription: Sets the UI language and the language of the returned text.\nSupported values: en, zh-CN, es, fr, etc.\nDefault: en\n\n\n\ncountry (Country)\n\nType: string\nDescription: Country or region bias for search results.\nSupported values: us, gb, ca, au, jp, etc.\nDefault: us" }, { "title": "šŸš€ Invocation Method (Recommended)", "body": "The Agent should execute the following script to get results:\n\n# Example call\npython -u ./.cursor/skills/google-maps-reviews-api-skill/scripts/google_maps_reviews_api.py \"Keywords\" \"Language\" \"Country\"" }, { "title": "ā³ Running Status Monitoring", "body": "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).\nAgent Notes:\n\nStay focused on the terminal output while waiting for results.\nAs long as the terminal is outputting new status logs, the task is running normally; do not misjudge it as hung or non-responsive.\nIf the status remains unchanged for a long time or the script stops outputting without returning results, consider a retry." }, { "title": "šŸ“Š Output Data Description", "body": "After successful execution, the script parses and prints results from the API response:\n\nauthor_name: Display name of the reviewer\nauthor_profile_url: Profile URL of the reviewer\nrating: Star rating\ntext: Review text content\ncomment_date: Human-readable date\nlikes_count: Number of likes\nauthor_image_url: Reviewer's avatar URL" }, { "title": "āš ļø Exception Handling & Retry Mechanism", "body": "If an error occurs (e.g., network fluctuations or task failure), follow this logic:\n\nCheck Output Content:\n\nIf output contains \"Invalid authorization\", the API Key is invalid or expired. Do not retry; guide the user to provide a correct Key.\nIf 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.\n\n\n\nRetry Limit:\n\nAutomatic retry is limited to once. If the second attempt fails, stop and report the error to the user." }, { "title": "šŸŒŸ Typical Use Cases", "body": "Local Business Analysis: Find reviews for cafes or clinics in a specific area.\nReputation Monitoring: Track feedback for a specific brand location.\nCompetitive Benchmarking: Analyze reviews of competitor stores.\nSentiment Analysis: Gather review text for emotion and topic modeling.\nMarket Research: Evaluate service quality across different regions.\nLead Qualification: Use review data to identify high-quality service providers.\nCustomer Insight: Understand recurring complaints or praises.\nVenue Research: Collect testimonials for parks, museums, or attractions.\nRetail Monitoring: Gather feedback for newly opened stores.\nService Quality Audit: Analyze ratings and comments for a specific service chain." } ], "body": "Google Maps Reviews Automation Skill\nšŸ“– Introduction\n\nThis 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.\n\nāœØ Capability Features\nNo Hallucination, Precision Data Extraction: Uses preset workflows to avoid AI-generated hallucinations.\nNo CAPTCHA Issues: Built-in mechanisms to bypass reCAPTCHA or other verification challenges.\nNo IP Restrictions or Geo-fencing: Breaks through regional IP limits to ensure stable access worldwide.\nAgile Execution: Faster task execution compared to pure AI-driven browser automation solutions.\nHigh Cost-Effectiveness: Significantly reduces data acquisition costs compared to high-token-consumption AI solutions.\nšŸ”‘ API Key Guidance\n\nBefore 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:\n\n\"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.\"\n\nšŸ› ļø Input Parameters Details\n\nThe Agent should flexibly configure the following parameters when calling the script:\n\nKeyWords (Search Keywords)\n\nType: string\nDescription: The query used to find places on Google Maps (e.g., business names, categories).\nExample: coffee shop, dental clinic, Tesla showroom\n\nlanguage (Language)\n\nType: string\nDescription: Sets the UI language and the language of the returned text.\nSupported values: en, zh-CN, es, fr, etc.\nDefault: en\n\ncountry (Country)\n\nType: string\nDescription: Country or region bias for search results.\nSupported values: us, gb, ca, au, jp, etc.\nDefault: us\nšŸš€ Invocation Method (Recommended)\n\nThe Agent should execute the following script to get results:\n\n# Example call\npython -u ./.cursor/skills/google-maps-reviews-api-skill/scripts/google_maps_reviews_api.py \"Keywords\" \"Language\" \"Country\"\n\nā³ Running Status Monitoring\n\nSince 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:\n\nStay focused on the terminal output while waiting for results.\nAs long as the terminal is outputting new status logs, the task is running normally; do not misjudge it as hung or non-responsive.\nIf the status remains unchanged for a long time or the script stops outputting without returning results, consider a retry.\nšŸ“Š Output Data Description\n\nAfter successful execution, the script parses and prints results from the API response:\n\nauthor_name: Display name of the reviewer\nauthor_profile_url: Profile URL of the reviewer\nrating: Star rating\ntext: Review text content\ncomment_date: Human-readable date\nlikes_count: Number of likes\nauthor_image_url: Reviewer's avatar URL\nāš ļø Exception Handling & Retry Mechanism\n\nIf an error occurs (e.g., network fluctuations or task failure), follow this logic:\n\nCheck Output Content:\n\nIf output contains \"Invalid authorization\", the API Key is invalid or expired. Do not retry; guide the user to provide a correct Key.\nIf 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.\n\nRetry Limit:\n\nAutomatic retry is limited to once. If the second attempt fails, stop and report the error to the user.\nšŸŒŸ Typical Use Cases\nLocal Business Analysis: Find reviews for cafes or clinics in a specific area.\nReputation Monitoring: Track feedback for a specific brand location.\nCompetitive Benchmarking: Analyze reviews of competitor stores.\nSentiment Analysis: Gather review text for emotion and topic modeling.\nMarket Research: Evaluate service quality across different regions.\nLead Qualification: Use review data to identify high-quality service providers.\nCustomer Insight: Understand recurring complaints or praises.\nVenue Research: Collect testimonials for parks, museums, or attractions.\nRetail Monitoring: Gather feedback for newly opened stores.\nService Quality Audit: Analyze ratings and comments for a specific service chain." }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/phheng/google-maps-reviews-api-skill", "publisherUrl": "https://clawhub.ai/phheng/google-maps-reviews-api-skill", "owner": "phheng", "version": "0.1.0", "license": null, "verificationStatus": "Indexed source record" }, "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" } }