SerpAPI 是一个统一搜索 API,通过单一接口从 Google、Amazon、Yelp、OpenTable 以及 20 多个其他搜索引擎获取结构化数据。
用途
SerpAPI 用于跨多个搜索引擎和平台执行搜索,并将结果以结构化形式返回。它适合需要程序化获取搜索结果、本地商家信息、商品价格、评论、新闻或图片的场景。
主要能力
支持的引擎包括:
| 引擎 | 用途 | 主要特性 |
|---|---|---|
google |
通用网页搜索 | 自然结果、知识图谱、本地包 |
google_maps |
本地地点/商家 | 评分、评论、营业时间、GPS 坐标 |
google_shopping |
商品搜索 | 价格、商家、评论 |
google_images |
图片搜索 | 缩略图、来源 |
google_news |
新闻文章 | 标题、来源、日期 |
amazon |
Amazon 商品 | 价格、评分、评论、Prime 状态 |
yelp |
本地商家 | 评论、评分、分类 |
opentable |
餐厅评论 | 用餐评论、评分 |
walmart |
Walmart 商品 | 价格、库存 |
ebay |
eBay 商品 | 价格、出价、成色 |
tripadvisor |
旅行/景点 | 酒店、餐厅、活动 |
使用方式
设置
- 从 https://serpapi.com 获取 API 密钥(免费层:每月 100 次搜索)。
- 设置环境变量:
export SERPAPI_API_KEY=your-key-here - 可选:在工作区的
TOOLS.md中设置默认位置,例如:
## SerpAPI
Default location: Pittsburgh, PA
命令语法
<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
serp.py yelp "pizza" --location "New York, NY"
serp.py google_shopping "standing desk"
选项
| 选项 | 说明 |
|---|---|
--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 "italian restaurants" --location "Pittsburgh, PA" --num 5
比较商品价格:
serp.py google_shopping "sony wh-1000xm5" --num 10
查看 Amazon 评论和定价:
serp.py amazon "standing desk" --num 10
获取本地服务的 Yelp 评论:
serp.py yelp "plumber" --location "15238"
搜索某主题的新闻:
serp.py google_news "AI regulation" --num 5
输出格式
- JSON(默认):来自 SerpAPI 的完整结构化数据。适合程序化使用或需要全部细节时。
- 文本(
--format text):人类可读的摘要。适合快速获取答案。
适用场景
- 查找本地商家、餐厅、服务提供商及其评分、评论、营业时间和位置。
- 跨商家比较商品价格,或查询 Amazon、Walmart、eBay 上的商品信息。
- 获取新闻头条、图片或通用网页搜索结果。
- 需要将搜索结果以结构化 JSON 形式集成到程序或工作流中。
限制
- 需要 API 密钥,免费层每月 100 次搜索;具体配额和付费方案请查看 https://serpapi.com/dashboard。
- 结果依赖 SerpAPI 服务及其支持的引擎,各引擎返回字段可能不同。
- 本地结果包含 GPS 坐标,购物结果包含提取的价格,知识图谱在可用时提供实体信息。
- 其他限制暂未提供。