{"id":"google-maps-search-api-skill","name":"google-maps-search-api-skill","summary":"このスキルは、ユーザーがGoogleマップの検索結果からビジネスデータを自動抽出するのに役立つように設計されています。","body":"# Google Maps Search Automation Skill\n\n## 📖 Introduction\nThis skill utilizes the BrowserAct Google Maps Search API template to provide a one-stop business data collection service. It extracts structured business results directly from Google Maps search lists. Simply provide search keywords, language, and country filters to get clean, usable business data.\n\n## ✨ Features\n1. **No Hallucinations**: Pre-set workflows avoid AI generative hallucinations, ensuring stable and precise data extraction.\n2. **No Captcha Issues**: No need to handle reCAPTCHA or other verification challenges.\n3. **No IP Restrictions**: No need to handle regional IP restrictions or geofencing.\n4. **Faster Execution**: Tasks execute faster compared to pure AI-driven browser automation solutions.\n5. **Cost-Effective**: Significantly lowers data acquisition costs compared to high-token-consuming AI solutions.\n\n## 🔑 API Key Setup\nBefore running, check the `BROWSERACT_API_KEY` environment variable. If not set, do not take other measures; ask and wait for the user to provide it.\n**Agent must inform the user**:\n> \"Since you haven't configured the BrowserAct API Key, please visit the [BrowserAct Console](https://www.browseract.com/reception/integrations) to get your Key.\"\n\n## 🛠️ Input Parameters\nWhen calling the script, the Agent should flexibly configure the following parameters based on user needs:\n\n1. **KeyWords**\n   - **Type**: `string`\n   - **Description**: The content you want to search on Google Maps. Can be business names, categories, or specific keywords.\n   - **Example**: `coffee shop`, `dental clinic`, `coworking space`\n\n2. **language**\n   - **Type**: `string`\n   - **Description**: Sets the UI language and the language of returned text fields.\n   - **Common Values**: `en`, `de`, `fr`, `it`, `es`, `ja`, `zh-CN`, `zh-TW`\n   - **Default**: `en`\n\n3. **country**\n   - **Type**: `string`\n   - **Description**: Sets the country or region bias for search results.\n   - **Example**: `us`, `gb`, `ca`, `au`, `de`, `fr`, `jp`\n   - **Default**: `us`\n\n4. **max_dates**\n   - **Type**: `number`\n   - **Description**: The maximum number of places to extract from the search results list.\n   - **Default**: `100`\n\n## 🚀 Usage\nThe Agent should execute the following independent script to achieve \"one-line command result\":\n\n```bash\n# Example call\npython -u ./scripts/google_maps_search_api.py \"search keywords\" \"language\" \"country\" count\n```\n\n### ⏳ Execution Monitoring\nSince 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`).\n**Agent Instructions**:\n- While waiting for the script result, keep monitoring the terminal output.\n- As long as the terminal is outputting new status logs, the task is running normally; do not mistake it for a deadlock or unresponsiveness.\n- 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.\n\n## 📊 Data Output\nAfter successful execution, the script parses and prints results directly from the API response. Fields include:\n- `name`: Business name\n- `full address`: Full address\n- `rating`: Star rating\n- `review count`: Number of reviews\n- `price range`: Price level\n- `cuisine type`: Business category\n- `amenity tags`: Features like Wi-Fi\n- `review snippet`: Short review text\n- `service options`: Service indicators (e.g., \"Order online\")\n\n## ⚠️ Error Handling & Retry\nIf an error occurs during script execution (e.g., network fluctuations or task failure), the Agent should follow this logic:\n\n1. **Check Output Content**:\n   - 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.\n   - 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**.\n\n2. **Retry Limit**:\n   - Automatic retry is limited to **one time**. If the second attempt fails, stop retrying and report the specific error information to the user.\n\n## 🌟 Typical Use Cases\n1. **Local Business Discovery**: Find all \"Italian restaurants\" in Manhattan.\n2. **Sales Lead Generation**: Extract a list of \"real estate agencies\" in London for prospecting.\n3. **Competitor Mapping**: Locate all \"Starbucks\" branches in a specific city to map competition.\n4. **Market Research**: Analyze \"boutique hotels\" in Paris, including their ratings and price ranges.\n5. **Contact Collection**: Gather addresses and names of \"dental clinics\" in Sydney.\n6. **Service Search**: Find \"24-hour pharmacies\" or \"emergency plumbers\" in a certain area.\n7. **Neighborhood Monitoring**: Track new \"gyms\" or \"yoga studios\" opening in a community.\n8. **Structured Data Export**: Export structured data of \"car dealerships\" for CRM integration.\n9. **Sentiment Analysis Prep**: Get review snippets and ratings for \"popular tourist attractions\".\n10. **Global Search Localization**: Use different language and country settings to research \"tech hubs\" globally.","author":"@browser-act","ownerProfile":null,"authorContacts":null,"sourceUrl":"https://github.com/browser-act/skills/tree/main/solutions/lead-generation/google-maps-search-api-skill","license":"MIT","category":"review","lang":"en","tokens":1228,"stars":0,"calls30d":1,"claimed":false,"visibility":"public","origin":"crawler","version":"0.1.0","createdAt":"2026-08-22","updatedAt":"2026-08-22","files":[{"path":"scripts/google_maps_search_api.py","size":4296,"sha256":"5aa25ec49227856bb8e930eb48a70c81fc1d8de65c4d6dbaff4cba899bf9d7ff"}],"requires":{"mcp":[],"tools":[]},"safety":{"flags":[{"code":"net.endpoints","kind":"exfiltration","excerpt":"api.browseract.com, www.browseract.com","message":"bundled scripts reach 2 external host(s)","severity":"warn"}],"scannedAt":"2026-08-22","hasScripts":true,"networkEndpoints":["api.browseract.com","www.browseract.com"]}}