SuperAPI AI 工具集

serpapi

通用与其它

查看项目

更新于 10-16 06:40

技能介绍

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 旅行/景点 酒店、餐厅、活动

使用方式

设置

  1. 从 https://serpapi.com 获取 API 密钥(免费层:每月 100 次搜索)。
  2. 设置环境变量:export SERPAPI_API_KEY=your-key-here
  3. 可选:在工作区的 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 坐标,购物结果包含提取的价格,知识图谱在可用时提供实体信息。
  • 其他限制暂未提供。