使用场景

用 eBay 成交记录给二手商品估值并确定转售价

以 JSON 获取 eBay 商品的实际成交价,含成交价、运费、成色和结束日期,用来为库存估值并确定转售价格。

预付费,无订阅REST 或 MCP一个密钥搞定模型、数据和智能体
eBaylovelyjsonitems[0]"title": "NVIDIA GeForce RTX 40…"sold_price": "689.00""shipping": "Free""condition": "Pre-owned""ended": "2026-10-23"

挂牌价只是愿望。如果你转售电子产品、倒卖遗产拍品,或者要为藏品投保,你需要的是买家最近几周实际付了多少钱。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>
01

工作原理

010203
  1. 列出要估值的商品

    每件商品一个关键词:型号效果最好。加上 itemCondition 以匹配你的库存,搜索结果杂乱时再加价格区间。

  2. 设置上限后运行工具

    发送到 POST /v1/tools/ebay-sold/run,用 count 指定成交记录数量,用 daysToScrape 指定回溯多少天,并用 max_results 作为运行上限。运行会从你的余额中预留它的最高费用,并以 JSON 返回成交记录。

  3. 取中位数

    剔除异常值,例如仅出售零件的交易,然后用成交价中位数(如果你要发货,再加上运费)作为参照价。带上日期保存。

02

一次请求获取成交价

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 条成交记录。

03

每条成交记录包含什么

Field groupWhat you get
价格成交价格
运费运费
成色全新、二手或按挂牌所示
时间交易结束日期
04

使用方案

库存估值。

对库存中的每个型号运行,itemCondition 设为 used,取 30 天内成交价的中位数,写在你的标价旁边。

决定买什么。

批量采购之前,把整批货的挂牌价与其中每件商品的成交价中位数做对比。

追踪价格趋势。

每周用同一关键词运行,daysToScrape 设为 30,存储中位数,看某个产品的转售价是否在下跌。

投保或评估。

为一批藏品建立一张带日期的可比成交表,作为价值主张的依据。

比较各国市场。

在 ebay.co.uk 和 ebay.com 上对同一关键词运行并比较中位数,再决定是否把库存发往国外。

更想用自然语言?连接 MCP 服务器,然后告诉 Claude Code 或 Cursor:"对 gpus.txt 中的各个型号,从 eBay 各获取 30 条二手成交记录,给出每个型号的成交价中位数和成交笔数。把 max_results 设为总数。"

06

费用说明

按记录计费:开始运行时会预留最高费用,即单次调用费加上单条记录费乘以 max_results,运行结束后按实际返回的数量结算,其余预留金额退回你的余额。失败或超时的运行只为已交付的记录付费,开始时就被拒绝的运行不收费。

为 100 件商品估值、每件 20 笔成交,按 2,000 条记录计费。没有订阅,也没有每月最低消费:从 $5 起充值,一份余额同时支付工具和模型。上方卡片显示今日价格;价格页列出了每个工具。

07

常见问题

?
成交记录能回溯多久?+

由 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。

需要订阅吗?+

不需要。你向预付费余额充值,每次运行从中扣费。失败的运行只为已交付的结果付费,也不会自动续费。

给整个商品目录定价?请参阅电商情报、研究智能体和工具目录。

一个预付费密钥,搞定模型、数据和智能体

无需订阅。充值后按需使用,每笔费用都能在日志中查看。