你在网上开店、开发调价或选品寻源工具,或在研究某个品类,需要可以随时刷新的商品数据来做电商竞品价格监控:今天的价格、卖家、销售排名,以及同一件商品上个月卖出了什么价格。Lovely Router 以 JSON 返回来自 Amazon、eBay、AliExpress、Shopee、TikTok Shop 和 Facebook Marketplace 的数据,按商品或商品信息条数从预付费余额中计费。用一个 API 密钥,就能从定时任务、你的后端或 AI 智能体中调用。
交给你的 AI 智能体
把这段提示词复制到 Claude Code、Cursor、Codex 或任何编程智能体中。它会告诉智能体文档在哪里,以及如何使用你的 API 密钥。
Pull product, price, review and best-seller data from Amazon, eBay (including sold prices), AliExpress, Shopee, TikTok Shop and Facebook Marketplace. Use the Lovely Router data tools: each returns JSON and is billed per result.
- Docs (read first): https://lovelyrouter.com/docs/tools/find.md and https://lovelyrouter.com/docs/tools/run.md
- Plan first: POST https://lovelyrouter.com/v1/tools/suggest with `{"task": "<my task in plain words>"}` (free). It returns the tools to run in order, each with an example `input`, the `input_required` fields, an estimated cost and a ready-made `run` request. Replace the example values with my task's; if a field is unclear, read the tool with GET https://lovelyrouter.com/v1/tools/<id>. To browse instead, POST https://lovelyrouter.com/v1/tools/discover searches the catalog.
- Show me the plan and its estimated cost (`total_est_cost_usd`) before running anything large.
- Run: POST https://lovelyrouter.com/v1/tools/<id>/run with `{"input": {...}, "max_results": N}`. A 200 has the finished run with `items`; a 202 means it is still running, so poll the `poll` path until `status` is `succeeded`, `failed`, `timed_out` or `stopped`.
- Only delivered results are billed. Keep max_results small on the first run, check the output, then scale up.
- If you support MCP, connect https://lovelyrouter.com/mcp instead (Streamable HTTP, same key; https://lovelyrouter.com/docs/tools/mcp.md) and use suggest_tools, get_tool and run_tool.
- Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys.
- Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large.
- Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt.
My task: <the products, keywords or ASINs, the marketplaces and countries, and what to track>工作原理
列出要追踪的对象
ASIN 或 Amazon 商品 URL、畅销榜品类 URL、eBay 关键词、Shopee 或 TikTok Shop 商品链接、Marketplace 搜索 URL。
设置上限后运行工具
把输入连同
max_results发送到POST /v1/tools/{id}/run。运行会从你的余额中预留它的最高费用,并以 JSON 返回商品。存储并对比
把每次运行得到的价格连同时间戳保存下来。与上一次运行对比,就能发现价格变化、新卖家和排名变动。
一次请求获取 Amazon 商品数据
Amazon 商品详情在 Params 中接受 ASIN 或商品 URL。单独的 ASIN 会从 website 指定的 Amazon 站点读取;完整的 URL 则始终使用它自己的域名,因此一次运行可以覆盖多个站点:
curl https://lovelyrouter.com/v1/tools/amazon-product/run \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{
"input": {
"Params": ["B00091S3K4", "https://www.amazon.de/dp/B00091S3K4"],
"website": "amazon.com",
"zipCode": "10010"
},
"max_results": 2
}'items 中的每个商品都包含价格、评分、卖点、图片、卖家和排名。在 amazon.com 上,deliverTo 和 zipCode 用于设置配送地址,这会影响 Amazon 展示的商品、价格和库存情况;currency 会让 Amazon 在支持的情况下换算价格。运行超过 60 秒仍未结束时会返回 202;轮询方法见运行工具。
Tip
同一个 ASIN 在不同国家的 Amazon 站点上可能是不同的商品。请选择你的 ASIN 所属的 website,或者直接传入完整的商品 URL。
工具一览
按 ASIN 获取完整的 Amazon 商品页:价格、评分、特点、图片、卖家、排名。
某个 Amazon ASIN 的买家评论:星级、标题、内容、日期、是否认证购买。评论以每页 10 条返回(输入中的 maxPages)。
某品类的 Amazon 畅销榜:排名、标题、价格、评分、ASIN。
按关键词获取 eBay 商品:价格、成色、卖家、运费。
商品在 eBay 上的实际成交情况:成交价、运费、成色、结束日期。适合价格调研与估值。
AliExpress 搜索结果中的商品:价格、订单数、评分、店铺。
某国家/地区按关键词获取的 Shopee 商品。
按 URL 获取 TikTok Shop 商品页:价格、销量、评分、店铺、规格。
Facebook Marketplace 搜索或分类页的商品:标题、价格、位置、图片。
| 工具 | 你发送的内容 | 每条结果包含 |
|---|---|---|
amazon-product | Params(ASIN 或 URL)、website、deliverTo、zipCode、currency | 价格、评分、卖点、图片、卖家、排名 |
amazon-reviews | input:每个商品一个 {asin, domainCode, sortBy, maxPages} | 星级、标题、正文、日期、是否为认证购买 |
amazon-bestsellers | 畅销榜、新品榜或愿望清单榜品类的 urls | 排名、标题、价格、评分、ASIN |
ebay-listings | keywords、ebaySite、minPrice、maxPrice、condition | 价格、成色、卖家、运费(第一页结果) |
ebay-sold | keywords、ebaySite、daysToScrape(最多 90)、itemCondition | 成交价、运费、成色、结束日期 |
aliexpress-products | searchQueries 或 productUrls、sortBy | 价格、订单数、评分、店铺 |
shopee-products | searchTerms 或 startUrls、country、sortBy | 标题、价格、折扣、评分、发货地、店铺 |
tiktok-shop-product | productUrls、region | 价格、销量、评分、店铺、规格 |
facebook-marketplace | Marketplace 搜索或品类的 urls | 标题、价格、所在地、照片 |
实用配方
每天早上用你自己的调度程序对 ASIN 列表运行 amazon-product,每批不超过该工具单次运行的上限。按 ASIN 保存价格、卖家和排名,当价格跌破你的底线或出现新卖家时发出提醒。
用 "keywords": ["rtx 4080"]、"daysToScrape": 30 和 "itemCondition": "used" 运行 ebay-sold,查看这件商品的实际成交价,再与 ebay-listings 中今天的挂牌价进行对比。
用品类 URL 拉取 amazon-bestsellers,再为每个排名靠前的 ASIN 添加一条 {"asin": "…", "domainCode": "com", "sortBy": "recent", "maxPages": 1} 运行 amazon-reviews,然后问模型买家都在抱怨什么。这些抱怨就是你的产品需求。
在 aliexpress-products 上用 "sortBy": "orders" 搜索同一件商品,把它的价格与它在 Amazon 和 eBay 上的售价进行对比。
shopee-products 可以搜索印度尼西亚、新加坡、马来西亚、菲律宾、泰国、越南、台湾、巴西、墨西哥、哥伦比亚和智利的 Shopee;按 sales 排序,看看哪些商品卖得好。tiktok-shop-product 可以读取十个国家站点的 TikTok Shop 商品页。
把城市搜索 URL,例如 https://www.facebook.com/marketplace/nyc/search?query=bike,传给 facebook-marketplace。
更想直接用自然语言提问?连接 MCP 服务器,然后对 Claude Code 或 Cursor 说:"获取 asins.txt 中 30 个 ASIN 在 amazon.com 上的当前价格、卖家和排名,与 prices.csv 中昨天的价格进行对比,列出有变化的项目。每次运行都设置 max_results。"
费用说明
按结果付费:一个商品、一条评论或一条商品信息,设有每次调用费的工具另收该费用。启动运行时会预留它的最高费用,即每次调用费加上每条结果费乘以 max_results,结束后按实际返回的结果结算,预留的剩余部分退回你的余额。失败或超时的运行只为已交付的结果付费,在开始时就被拒绝的运行不收费。
每天检查 200 个 ASIN,就按每天 200 条商品结果计费。没有订阅,也没有每月最低消费:最低充值 $5,工具和模型共用一个余额。上方卡片显示的是当前价格;价格页面列出了所有工具。
常见问题
能监控美国以外的 Amazon 价格吗?+
可以。做亚马逊价格监控时,amazon-product 工具支持 20 个国家的 Amazon 站点,包括 amazon.de、amazon.co.uk、amazon.co.jp 和 amazon.com.br。单独的 ASIN 可以在 website 中选择站点,也可以直接传入完整的商品 URL,它们始终使用自己的域名。
多久可以检查一次价格?+
你启动运行的频率有多高,就能检查多频繁。每次检查都是一次按商品计费的运行,所以用你自己的定时任务或后台任务来调度即可。你的账户最多可以同时进行 10 次运行。
能看到商品的实际成交价吗?+
可以,在 eBay 上。ebay-sold 工具会返回最近 90 天内的已成交商品,包含成交价、运费、成色和结束日期,这些正是估价和制定转售价格所需的数据。
TikTok Shop 的价格会换算成统一币种吗?+
不会。TikTok Shop 的价格从不换算,每个国家站点的价格都以该站点自己的币种返回。英国站点会隐藏价格数字,这些条目会标注 priceStatus=masked_by_storefront。
除了商品详情,还能获取 Amazon 评论吗?+
可以。亚马逊评论抓取用的是 amazon-reviews 工具,它会返回星级、标题、正文、日期以及是否为认证购买。评论每页 10 条,可以为每个 ASIN 用 maxPages 设置页数。
需要订阅吗?+
不需要。你向预付费余额充值,每次运行从中扣费。失败的运行只为已交付的结果付费,不会自动续费。