SerpAPI技能使用说明

2026-03-28 新闻来源：网淘吧围观:17

电脑广告

手机广告

SerpAPI - 统一搜索

SerpAPI 通过单一 API 提供来自 Google、Amazon、Yelp、OpenTable 以及其他 20 多个搜索引擎的结构化数据。

设置

从以下网址获取 API 密钥：https://serpapi.com（免费套餐：每月 100 次搜索）
设置环境变量：export SERPAPI_API_KEY=your-key-here
可选地在以下文件中设置默认位置：<workspace>/TOOLS.md：
```
## SerpAPI
Default location: Pittsburgh, PA
```

用法

# 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`	商品搜索	价格、商家、评论
`谷歌图片`	图片搜索	缩略图、来源
`谷歌新闻`	新闻文章	标题、来源、日期
`亚马逊`	亚马逊商品	价格、评分、评论、Prime会员状态
`Yelp`	本地商家	评论、评分、类别
`OpenTable`	餐厅评论	用餐评论、评分
`沃尔玛`	沃尔玛商品	价格、库存情况
`eBay`	eBay商品列表	价格、出价、商品状况
`TripAdvisor`	旅行/景点	酒店、餐厅、可做之事

选项

选项	描述
`--location`,`-l`	本地结果的位置（城市、邮编、地址）
`--num`,`-n`	结果数量（默认：10）
`--format`,`-f`	输出格式：`json`（默认）或`文本`
`--type`,`-t`	Google搜索类型：`购物`,`图片`,`nws`,`vid`
`--page`,`-p`	用于分页的页码
`--gl`	国家代码（例如：`us`,`uk`,`de`）
`--hl`	语言代码（例如：`en`,`es`,`fr`）

何时使用哪个引擎

查找本地企业/餐厅：

google_maps— 最适合发现地点、营业时间和评价
yelp——针对餐厅/服务的深度评价与评分
opentable——餐厅专属，用餐评价

购物/产品：

google_shopping——比较不同商家的价格
amazon——亚马逊专属搜索，包含Prime会员信息
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

查看亚马逊评论和价格

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）：人类可读的摘要。最适合快速获取答案。

集成说明

结果是结构化的JSON——解析并提取你需要的内容
本地结果包含用于地图定位的GPS坐标
购物结果包含用于比较的提取价格
知识图谱在可用时提供实体信息
速率限制：免费套餐每月100次，请在serpapi.com/dashboard查看您的计划详情

免责申明

部分文章来自各大搜索引擎，如有侵权，请与我联系删除。

打赏

文章底部电脑广告

手机广告位-内容正文底部

标签

上一篇：Onchain CLI技能使用说明下一篇：Youtube Api技能使用说明