news-shopping

使用 Serper 搜索新闻和购物信息

通过受 x402 保护的端点访问 Google News、Google Shopping、Google Images 和 Google Lens。

设置

安装和钱包设置请参阅 rules/getting-started.md。

快速参考

任务	端点	价格	描述
新闻搜索	https://stableenrich.dev/api/serper/news	$0.04	Google News 搜索
购物搜索	https://stableenrich.dev/api/serper/shopping	$0.04	Google Shopping 搜索
图片搜索	https://stableenrich.dev/api/serper/images	$0.04	Google Images 搜索
人物图片搜索	https://stableenrich.dev/api/serper/people-image-search	$0.04	针对人物／头像优化的 Google Images 搜索
反向图片搜索	https://stableenrich.dev/api/serper/lens	$0.20	Google Lens 反向图片搜索

新闻搜索

搜索 Google News 中的文章：

npx agentcash@latest fetch https://stableenrich.dev/api/serper/news -m POST -b '{"q": "artificial intelligence regulation"}'

参数：

• q - 搜索查询（必填）
• num - 结果数量（1-100，默认：10）
• gl - 国家代码（例如，“us”、“uk”、“de”）
• hl - 语言（例如，“en”、“es”、“fr”）
• location - 地点（例如，“New York, NY”）
• tbs - 时间筛选条件（qdr:h、qdr:d、qdr:w、qdr:m、qdr:y）

时间筛选条件

筛选条件	含义
qdr:h	过去一小时
qdr:d	过去 24 小时
qdr:w	过去一周
qdr:m	过去一个月
qdr:y	过去一年

示例——搜索过去一周的新闻：

npx agentcash@latest fetch https://stableenrich.dev/api/serper/news -m POST -b '{"q": "AI startups funding", "tbs": "qdr:w"}'

国家／语言筛选

npx agentcash@latest fetch https://stableenrich.dev/api/serper/news -m POST -b '{"q": "technology news", "gl": "uk", "hl": "en"}'

返回内容：

• 文章标题和摘要
• 来源／出版物名称
• 发布日期
• 文章 URL
• 缩略图（如有）

购物搜索

搜索 Google Shopping 中的商品：

npx agentcash@latest fetch https://stableenrich.dev/api/serper/shopping -m POST -b '{"q": "wireless noise cancelling headphones"}'

参数：

• q - 搜索查询（必填）
• num - 结果数量（1-100，默认：10）
• gl - 用于价格／供货情况的国家代码
• hl - 语言
• location - 地点（例如，“New York, NY”）

返回内容：

• 商品标题
• 价格和货币
• 商家／店铺名称
• 商品 URL
• 评分（如有）
• 缩略图

按地点搜索商品

获取本地价格和供货情况：

npx agentcash@latest fetch https://stableenrich.dev/api/serper/shopping -m POST -b '{"q": "MacBook Pro M3", "gl": "us"}'

图片搜索

搜索 Google Images：

npx agentcash@latest fetch https://stableenrich.dev/api/serper/images -m POST -b '{"q": "aurora borealis over mountains"}'

参数：

• q - 搜索查询（必填）
• num - 结果数量（1-100，默认：10）
• gl - 国家代码
• hl - 语言
• location - 地点（例如，“New York, NY”）

返回内容：

• 图片标题
• 完整图片 URL 及宽度／高度
• 缩略图 URL 及宽度／高度
• 来源页面名称、域名和链接

人物图片搜索

针对查找人物／头像优化的 Google Images 搜索：

npx agentcash@latest fetch https://stableenrich.dev/api/serper/people-image-search -m POST -b '{"q": "\"Jane Doe\" \"Acme\" LinkedIn headshot"}'

**参数：**与图片搜索相同。请使用精确姓名加公司／上下文进行查询。

提示：

• 如果人物身份不明确，请先确认个人资料 slug／公司／职位
• LinkedIn 照片可能不是公开内容；如果首次搜索失败，请重试并使用公开的非 LinkedIn 来源词

反向图片搜索（Lens）

使用 Google Lens 对公开图片 URL 进行反向搜索（每次调用 $0.20）：

npx agentcash@latest fetch https://stableenrich.dev/api/serper/lens -m POST -b '{"url": "https://example.com/photo.jpg"}'

参数：

• url - 要进行反向搜索的图片公开 URL（必填）
• gl - 国家代码
• hl - 语言

返回内容：organic 匹配结果，包含标题、链接、来源、图片／缩略图 URL、价格／价格范围（如有）和摘要。

工作流

新闻监测

• （可选）检查余额：npx agentcash@latest balance
• 使用适当的时间筛选条件进行搜索
• 查看并总结重要新闻

npx agentcash@latest fetch https://stableenrich.dev/api/serper/news -m POST -b '{"q": "company name OR competitor name", "tbs": "qdr:d", "num": 20}'

突发新闻调查

• 使用 qdr:h 搜索过去一小时的内容
• 找出主要来源和事实
• 留意持续发展的情况

npx agentcash@latest fetch https://stableenrich.dev/api/serper/news -m POST -b '{"q": "breaking news topic", "tbs": "qdr:h"}'

商品调查

• 确定搜索条件（类别、价格范围）
• 搜索 Google Shopping
• 比较不同商家的价格
• 列出优缺点并展示首选商品

npx agentcash@latest fetch https://stableenrich.dev/api/serper/shopping -m POST -b '{"q": "ergonomic office chair under $500", "num": 20}'

价格比较

• 使用准确的商品名称／型号
• 比较商家报价
• 留意运费和供货情况

npx agentcash@latest fetch https://stableenrich.dev/api/serper/shopping -m POST -b '{"q": "exact product name model number"}'

响应数据

新闻文章字段

• title - 文章标题
• snippet - 文章摘要
• source - 出版物名称
• date - 发布日期
• link - 文章 URL
• imageUrl - 缩略图（如果有）

购物商品字段

• title - 商品名称
• price - 含货币单位的价格
• source - 商家/店铺
• link - 商品 URL
• rating - 星级评分（如果有）
• reviews - 评论数量
• imageUrl - 商品图片
• delivery - 配送信息（如果有）

提示

新闻搜索

• 使用引号搜索精确短语："climate change"
• 使用 OR 搜索备选项：AI OR "artificial intelligence"
• 使用具体关键词以获取相关结果
• 使用时间筛选条件，避免出现旧新闻

购物搜索

• 指定品牌/型号以搜索特定商品
• 添加 "under $X" 或 "best" 以筛选结果
• 检查 gl 参数，确保本地价格准确
• 结果越多，价格比较越方便

费用估算

新闻、购物、图片和人物图片搜索每次调用收费 $0.04；Lens 收费 $0.20。

任务	调用次数	费用
快速查看新闻	1	$0.04
每日新闻摘要	2-3	$0.08-0.12
商品调研	1-2	$0.04-0.08
全面市场调研	3-5	$0.12-0.20
搜索图片或头像	1	$0.04
反向图片搜索（Lens）	1	$0.20