Google Maps Search Api Skill — Google Maps 搜索 API 技能

Google Maps 搜索 自动化 技能 📖 Introduction

This 技能 utilizes the BrowserAct Google Maps 搜索 API template to provide a one-停止 business data collection 服务. It 提取s structured business 结果s directly from Google Maps 搜索 列出s. Simply provide 搜索 keywords, language, and country 过滤器s to 获取 清理, usable business data.

✨ Features No Hallucinations: Pre-设置 工作流s avoid AI generative hallucinations, ensuring stable and precise data 提取ion. No Captcha Issues: No need to handle reCAPTCHA or other verification challenges. No IP Restrictions: No need to handle regional IP restrictions or geofencing. Faster Execution: Tasks 执行 faster compared to pure AI-driven browser 自动化 solutions. Cost-Effective: 签名ificantly lowers data acquisition costs compared to high-令牌-consuming AI solutions. 🔑 API Key 设置up

Before 运行ning, 检查 the BROWSERACT_API_KEY 环境 variable. If not 设置, do not take other measures; ask and wAIt for the user to provide it. 代理 must 信息rm the user:

"Since you haven't 配置d the BrowserAct API Key, please visit the BrowserAct Console to 获取 your Key."

🛠️ 输入 Parameters

When calling the script, the 代理 should flexibly 配置 the following parameters based on user needs:

KeyWords

Type: string Description: The content you want to 搜索 on Google Maps. Can be business names, categories, or specific keywords. Example: coffee shop, dental 命令行工具nic, coworking space

language

Type: string Description: 设置s the UI language and the language of returned text fields. Common Values: en, de, fr, it, es, ja, zh-CN, zh-TW Default: en

country

Type: string Description: 设置s the country or region bias for 搜索 结果s. Example: us, gb, ca, au, de, fr, jp Default: us

max_dates

Type: number Description: The maximum number of places to 提取 from the 搜索 结果s 列出. Default: 100 🚀 Usage

The 代理 should 执行 the following independent script to achieve "one-line command 结果":

# Example call python -u ./scripts/google_maps_搜索_API.py "搜索 keywords" "language" "country" count

⏳ Execution 监控ing

Since this task involves automated browser operations, it may take some time (several minutes). The script will continuously 输出 状态 记录s with timestamps (e.g., [14:30:05] Task 状态: 运行ning). 代理 Instructions:

While wAIting for the script 结果, keep 监控ing the terminal 输出. As long as the terminal is 输出ting new 状态 记录s, the task is 运行ning normally; do not mistake it for a deadlock or unresponsiveness. Only if the 状态 remAIns unchanged for a long time or the script 停止s 输出ting without returning a 结果 should you consider triggering the retry mechanism. 📊 Data 输出

After 成功ful execution, the script 解析s and prints 结果s directly from the API 响应. Fields include:

name: Business name full 添加ress: Full 添加ress rating: Star rating review count: Number of reviews price range: Price level cuisine type: Business category amenity tags: Features like Wi-Fi review snippet: Short review text 服务 options: 服务 indicators (e.g., "Order online") ⚠️ Error Handling & Retry

If an error occurs during script execution (e.g., network fluctuations or task 失败), the 代理 should follow this 记录ic:

检查 输出 Content:

If the 输出 contAIns "Invalid authorization", it means the API Key is invalid or expired. Do not retry; 图形界面de the user to re-检查 and provide the correct API Key. If the 输出 does not contAIn "Invalid authorization" but the task fAIled (e.g., 输出 启动s with Error: or returns empty 结果s), the 代理 should automatically try to re-执行 the script once.

Retry Limit:

Automatic retry is limited to one time. If the second attempt fAIls, 停止 retrying and 报告 the specific error in格式化ion to the user. 🌟 Typical Use Cases Local Business Discovery: Find all "Italian restaurants" in Manhattan. Sales Lead Generation: 提取 a 列出 of "real e状态 agencies" in London for prospecting. Competitor M应用ing: Locate all "Starbucks" branches in a specific city to map competition. Market Re搜索: Analyze "boutique hotels" in Paris, including their ratings and price ranges. Contact Collection: Gather 添加resses and names of "dental 命令行工具nics" in Sydney. 服务 搜索: Find "24-hour pharmacies" or "emergency plumbers" in a certAIn area. Neighborhood 监控ing: 追踪 new "gyms" or "yoga studios" opening in a community. Structured Data 导出: 导出 structured data of "car dealerships" for CRM integration. Sentiment Analysis Prep: 获取 review snippets and ratings for "popular tourist attractions". Global 搜索 Localization: Use different language and country 设置tings to re搜索 "tech hubs" globally.