名称： serpapi
描述： 统一搜索 API，覆盖 Google、Amazon、Yelp、OpenTable、Walmart 等多个平台。适用于搜索产品、本地商家、餐厅、购物、图片、新闻或任何网络搜索。一个 API 密钥，多种搜索引擎。
主页： https://serpapi.com
元数据： {"clawdbot":{"emoji":"🔍","requires":{"env":["SERPAPI_API_KEY"]}}}
SerpAPI 通过单一 API 提供来自 Google、Amazon、Yelp、OpenTable 以及 20 多个其他搜索引擎的结构化数据。
export SERPAPI_API_KEY=your-key-here<workspace>/TOOLS.md 中设置默认位置：markdown
## SerpAPI
默认位置：宾夕法尼亚州匹兹堡# 通用语法
<skill>/scripts/serp.py <engine> "<query>" [options]
# 示例
serp.py google "最佳咖啡店"
serp.py google_maps "附近的餐厅" --location "15238"
serp.py amazon "机械键盘" --num 10
serp.py yelp "披萨" --location "纽约，纽约州"
serp.py google_shopping "站立式办公桌"
| 引擎 | 用途 | 关键特性 |
|---|---|---|
google |
通用网页搜索 | 自然搜索结果、知识图谱、本地商家包 |
google_maps |
本地地点/商家 | 评分、评论、营业时间、GPS 坐标 |
google_shopping |
商品搜索 | 价格、商家、评论 |
google_images |
图片搜索 | 缩略图、来源 |
google_news |
新闻文章 | 标题、来源、日期 |
amazon |
Amazon 商品 | 价格、评分、评论、Prime 状态 |
yelp |
本地商家 | 评论、评分、分类 |
opentable |
餐厅评论 | 餐饮评论、评分 |
walmart |
Walmart 商品 | 价格、库存状态 |
ebay |
eBay 商品列表 | 价格、竞价、商品状况 |
tripadvisor |
旅行/景点 | 酒店、餐厅、活动 |
| 选项 | 描述 |
|---|---|
--location, -l |
用于本地化结果的位置（城市、邮编、地址） |
--num, -n |
返回结果数量（默认：10） |
--format, -f |
输出格式：json（默认）或 text |
--type, -t |
Google 搜索类型：shop（购物）、isch（图片）、nws（新闻）、vid（视频） |
--page, -p |
分页页码 |
--gl |
国家代码（例如：us、uk、de） |
--hl |
语言代码（例如：en、es、fr） |
查找本地商家/餐厅：
- google_maps — 最适合发现地点、营业时间、评论
- yelp — 提供餐厅/服务的深度评论和评分
- opentable — 专注于餐厅的餐饮评论
购物/商品搜索：
- google_shopping — 跨商家比价
- amazon — 针对 Amazon 的搜索，包含 Prime 信息
- walmart — Walmart 库存和价格
- ebay — 二手商品、拍卖、收藏品
一般信息研究：
- google — 网页、文章、通用信息
- google_news — 时事、新闻文章
- google_images — 查找图片
serp.py google_maps "意大利餐厅" --location "宾夕法尼亚州匹兹堡" --num 5
serp.py google_shopping "sony wh-1000xm5" --num 10
serp.py amazon "站立式办公桌" --num 10
serp.py yelp "水管工" --location "15238"
serp.py google_news "AI 监管" --num 5
JSON（默认）： 来自 SerpAPI 的完整结构化数据。最适合编程使用或需要所有详细信息时。
文本（--format text）： 人类可读的摘要。最适合快速获取答案。