挂牌价只是愿望。如果你转售电子产品、倒卖遗产拍品,或者要为藏品投保,你需要的是买家最近几周实际付了多少钱。eBay 把这些保存为成交记录,但一次只能搜一个。Lovely Router 替你读取:传入关键词,每条成交记录返回一个 JSON 对象,按记录条数从预付费余额中计费。用一个 API 密钥,就能从脚本、表格任务或 AI 智能体中运行。
交给你的 AI 智能体
把这段提示词复制到 Claude Code、Cursor、Codex 或任何编程智能体中。它会告诉智能体文档在哪里,以及如何使用你的 API 密钥。
用 eBay 成交记录给二手商品估值并确定转售价. 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 inputs (links, keywords or accounts) and how many results you need>工作原理
列出要估值的商品
每件商品一个关键词:型号效果最好。加上
itemCondition以匹配你的库存,搜索结果杂乱时再加价格区间。设置上限后运行工具
发送到
POST /v1/tools/ebay-sold/run,用count指定成交记录数量,用daysToScrape指定回溯多少天,并用max_results作为运行上限。运行会从你的余额中预留它的最高费用,并以 JSON 返回成交记录。取中位数
剔除异常值,例如仅出售零件的交易,然后用成交价中位数(如果你要发货,再加上运费)作为参照价。带上日期保存。
一次请求获取成交价
eBay 成交记录在 keywords 中接受搜索词,每个词是使用相同筛选条件的独立搜索。ebaySite 选择国家站点,daysToScrape 设定回溯天数(默认 30),itemCondition 取 any、new 或 used,count 是记录数量:
curl https://lovelyrouter.com/v1/tools/ebay-sold/run \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{
"input": {
"keywords": ["rtx 4080"],
"count": 3
},
"max_results": 3
}'运行超过 60 秒仍未结束时会返回 202;轮询方法见运行工具。一次运行最多可返回 500 条成交记录。
每条成交记录包含什么
| Field group | What you get |
|---|---|
| 价格 | 成交价格 |
| 运费 | 运费 |
| 成色 | 全新、二手或按挂牌所示 |
| 时间 | 交易结束日期 |
使用方案
对库存中的每个型号运行,itemCondition 设为 used,取 30 天内成交价的中位数,写在你的标价旁边。
批量采购之前,把整批货的挂牌价与其中每件商品的成交价中位数做对比。
每周用同一关键词运行,daysToScrape 设为 30,存储中位数,看某个产品的转售价是否在下跌。
为一批藏品建立一张带日期的可比成交表,作为价值主张的依据。
在 ebay.co.uk 和 ebay.com 上对同一关键词运行并比较中位数,再决定是否把库存发往国外。
更想用自然语言?连接 MCP 服务器,然后告诉 Claude Code 或 Cursor:"对 gpus.txt 中的各个型号,从 eBay 各获取 30 条二手成交记录,给出每个型号的成交价中位数和成交笔数。把 max_results 设为总数。"
与其他数据源搭配
成交价是你决策的底线。围绕它还有:
商品在 eBay 上的实际成交情况:成交价、运费、成色、结束日期。适合价格调研与估值。
按关键词获取 eBay 商品:价格、成色、卖家、运费。
Facebook Marketplace 搜索或分类页的商品:标题、价格、位置、图片。
ebay-listings显示竞争卖家当前的要价。facebook-marketplace显示同一商品在本地的挂牌价。
更广泛的定价流程,请参阅电商情报。
费用说明
按记录计费:开始运行时会预留最高费用,即单次调用费加上单条记录费乘以 max_results,运行结束后按实际返回的数量结算,其余预留金额退回你的余额。失败或超时的运行只为已交付的记录付费,开始时就被拒绝的运行不收费。
为 100 件商品估值、每件 20 笔成交,按 2,000 条记录计费。没有订阅,也没有每月最低消费:从 $5 起充值,一份余额同时支付工具和模型。上方卡片显示今日价格;价格页列出了每个工具。
常见问题
成交记录能回溯多久?+
由 daysToScrape 设定,默认是 30 天。
可以使用哪些 eBay 站点?+
ebaySite 接受 ebay.com、ebay.co.uk、ebay.de、ebay.fr、ebay.it、ebay.es、ebay.ca 和 ebay.com.au。
可以按成色或价格筛选吗?+
可以。itemCondition 取 any、new 或 used,minPrice 和 maxPrice 按成交价筛选。sortOrder 改变结果页的排序。
运费算在价格里吗?+
该工具分别返回成交价和运费,你可以自行相加。
最多能获取多少条成交记录?+
count 设置每次运行的数量,运行上限 max_results 最高 500。
需要订阅吗?+
不需要。你向预付费余额充值,每次运行从中扣费。失败的运行只为已交付的结果付费,也不会自动续费。