用途:SerpAPI 通过单一 API 聚合 Google、Amazon、Yelp、OpenTable、Walmart 等 20 多个搜索引擎的结构化数据,适合产品比价、本地商家与餐厅查找、购物、图片和新闻检索等场景。
主要能力:支持多种引擎,包括 google(网页搜索、知识图谱、本地包)、google_maps(评分、评论、营业时间、GPS 坐标)、google_shopping(价格、商家、评论)、google_images、google_news、amazon(价格、评分、评论、Prime 状态)、yelp、opentable、walmart、ebay、tripadvisor 等。
使用方式:先从 https://serpapi.com 获取 API key(免费层 100 次搜索/月),设置环境变量 export SERPAPI_API_KEY=your-key-here。可选在 <workspace>/TOOLS.md 中设置默认位置。命令格式为 <skill>/scripts/serp.py <engine> "<query>" [options],例如 serp.py google "best coffee shops"、serp.py google_maps "restaurants near me" --location "15238"、serp.py amazon "mechanical keyboard" --num 10。
选项:--location/-l 指定本地结果位置;--num/-n 结果数量(默认 10);--format/-f 输出格式 json(默认)或 text;--type/-t 指定 Google 搜索类型 shop、isch、nws、vid;--page/-p 分页;--gl 国家代码;--hl 语言代码。
限制:免费层每月 100 次搜索,具体配额以 serpapi.com/dashboard 为准;其余平台、价格或效果信息暂未提供。