search_amazon
Search Amazon by keyword to retrieve a list of ASINs with details including title, price, rating, and sales. Use results for competitor analysis or further product research.
Instructions
[Amazon SERP 抓取] 用关键词在 Amazon 上跑一次真实搜索，拿回搜索结果首屏 ASIN 列表。 Use when: 用户说"在 Amazon 上搜 X""谁在卖 X""X 关键词下排名前几""做 X 的竞品有哪些"；或要拿到某个关键词的搜索结果页 ASIN 列表作为下游分析输入。 Don't use: 想拿单个 ASIN 的详情（用 get_amazon_product）；想要类目热销榜（用 list_bestsellers）；想看 Google/外部对该词的需求（用 google_ai_search 或 google_trends）。 Returns (format='json', 默认): data.json[0].data.{ pageIndex, nextPage, keyword, results[{ asin, title, price, star, rating, sales, badge, rank, sponsored, image, delivery }] } — 约 22 行/页。翻页: 用 page 参数（默认 1，从 1 开始）；响应里 nextPage 给下一页页码，nextPage=null 表示到底。 Pair with: ↓ 把 results[].asin 喂给 get_amazon_product / get_amazon_reviews 做单品深拆；↓ 同一 keyword 喂给 google_trends 做"内部搜索热度 vs 外部 Google 热度"对比。 Cost: ~1 积点/页, ~5s。翻页只在用户明确要"更多/Top-N(N>22)/全部"时才做，否则首页够用。
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| keyword | Yes | 搜索关键词。Examples: '蓝牙耳机' / 'wireless earbuds' / 'stanley quencher' / 'iphone 16 case'。 | |
| site | No | Amazon 站点。默认 amz_us（美国站）。 | amz_us |
| zipcode | No | 邮编，必须匹配 site 站点所在国家（amz_us → 美国邮编，amz_jp → 日本邮编 …）。可选；不传时后端会从对应国家邮编池随机挑一个。跨国邮编（如 amz_us + 日本邮编）会被后端拒绝。Examples: 10001 (NY) / 90001 (LA) / 100-0001 (Tokyo). | |
| format | No | 返回格式。默认 'json'——结构化搜索结果（每条含 asin/title/price/star/rating/sales/badge/rank 等），适合程序处理。需要原始页面阅读时切 'markdown'。 | json |
| page | No | 页码，从 1 开始。每页约 22 条 ASIN。结合响应里的 pageIndex/nextPage 决定是否继续翻：nextPage 为下一页页码，nextPage=null（或缺失）表示已到最后一页。**只在用户明确要更多/Top-N（N>单页量）/全部时才翻**，否则首页够用。 |