介绍
# SerpAPI - Unified Search
SerpAPI 通过单一 API 提供来自 Google、Amazon、Yelp、OpenTable 和其他 20 多个搜索引擎的结构化数据。
## 设置
1. 从 https://serpapi.com 获取 API 密钥（免费套餐：每月 100 次搜索） 2. 设置环境变量：`export SERPAPI_API_KEY=your-key-here` 3. 可选：在 `<workspace>/TOOLS.md` 中设置默认位置： ```markdown ## SerpAPI Default location: Pittsburgh, PA ```
## 使用方法
```bash # General syntax <skill>/scripts/serp.py <engine> "<query>" [options]
# Examples 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" ```
## 引擎
| 引擎 | 用于 | 主要特性 | |--------|---------|--------------| | `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` — 查找图片
## 示例
### 查找某位置附近的餐厅 ```bash serp.py google_maps "italian restaurants" --location "Pittsburgh, PA" --num 5 ```
### 比较产品价格 ```bash serp.py google_shopping "sony wh-1000xm5" --num 10 ```
### 查看 Amazon 评论和价格 ```bash serp.py amazon "standing desk" --num 10 ```
### 获取本地服务的 Yelp 评论 ```bash serp.py yelp "plumber" --location "15238" ```
### 搜索关于某个主题的新闻 ```bash serp.py google_news "AI regulation" --num 5 ```
## 输出格式
**JSON（默认）：** 来自 SerpAPI 的完整结构化数据。最适合程序化使用或需要所有详细信息时。
**文本 (`--format text`)：** 人类可读的摘要。最适合快速获取答案。
## 集成说明
- 结果为结构化 JSON — 请解析并提取所需内容 - 本地结果包含用于映射的 GPS 坐标 - 购物结果包含提取的价格以便比较 - 知识图谱在可用时提供实体信息 - 速率限制：免费套餐每月 100 次，请在 serpapi.com/dashboard 检查您的套餐