ebay-agent — eBay Research Agent
Search eBay for deals, estimate item values, and rank results by price, seller trust, and condition — all via eBay's official REST APIs.
Trigger Phrases
- - "Search eBay for [item]"
- "Find me a used [item] on eBay"
- "What's [item] worth on eBay?"
- "How much is [item] selling for?"
- "Is this a good deal on eBay?"
Commands
All commands are run via uv run --project <skill_dir> ebay-agent <command>.
search — Find items on eBay
CODEBLOCK0
Options: --max-price/-p, --condition/-c (new, used, very_good, good, acceptable), --limit/-n (default: 10), --sort/-s (score, price, seller), INLINECODE6
value — Estimate what an item is worth
CODEBLOCK1
Returns average, median, min, max, listing count, and a recommended price based on current market data. Tries eBay Marketplace Insights (sold data) first, falls back to Browse API (active listings).
Options: --condition/-c (default: used), --limit/-n (default: 20), INLINECODE10
prefs — View search preferences
CODEBLOCK2
Shows current scoring preferences: min condition, min seller score, budget, strategy (price/speed/balanced).
Required Environment Variables
| Variable | Required | Description |
|---|
| INLINECODE12 | Yes | eBay app client ID from developer.ebay.com |
| INLINECODE13 |
Yes | eBay app client secret from developer.ebay.com |
|
EBAY_ENVIRONMENT | No |
sandbox or
production (default: production) |
How to get eBay credentials
- 1. Go to developer.ebay.com and create a free account
- Create an application to get your App ID and Cert ID
- Set
EBAY_APP_ID and EBAY_CERT_ID in your environment
Example workflow
CODEBLOCK3
ebay-agent — eBay研究助手
通过eBay官方REST API搜索eBay上的商品、估算物品价值，并根据价格、卖家信誉和物品状况对结果进行排序。
触发短语
- - 在eBay上搜索[物品]
- 帮我在eBay上找个二手的[物品]
- [物品]在eBay上值多少钱？
- [物品]现在卖多少钱？
- 这个在eBay上划算吗？
命令
所有命令通过 uv run --project <技能目录> ebay-agent <命令> 运行。
search — 在eBay上查找物品
bash
ebay-agent search 索尼 85mm f/1.8 镜头
ebay-agent search iPad Air --max-price 300 --condition used
ebay-agent search 任天堂 Switch --sort price --limit 20
选项：--max-price/-p，--condition/-c（new、used、very_good、good、acceptable），--limit/-n（默认：10），--sort/-s（score、price、seller），--json
value — 估算物品价值
bash
ebay-agent value iPad Air 2 64GB
ebay-agent value 索尼 85mm f/1.8 镜头 --condition very_good --limit 30
返回平均值、中位数、最小值、最大值、列表数量以及基于当前市场数据的推荐价格。优先使用eBay Marketplace Insights（已售数据），失败时回退到Browse API（当前在售列表）。
选项：--condition/-c（默认：used），--limit/-n（默认：20），--json
prefs — 查看搜索偏好
bash
ebay-agent prefs
显示当前评分偏好：最低物品状况、最低卖家评分、预算、策略（价格/速度/平衡）。
必需的环境变量
| 变量 | 必需 | 描述 |
|---|
| EBAYAPPID | 是 | 来自 developer.ebay.com 的eBay应用客户端ID |
| EBAYCERTID |
是 | 来自 developer.ebay.com 的eBay应用客户端密钥 |
| EBAY_ENVIRONMENT | 否 | sandbox 或 production（默认：production） |
如何获取eBay凭证
- 1. 访问 developer.ebay.com 并创建免费账户
- 创建应用以获取App ID和Cert ID
- 在环境中设置 EBAYAPPID 和 EBAYCERT_ID
示例工作流程
bash
搜索优惠商品
ebay-agent search 索尼 85mm f/1.8 镜头 --max-price 400 --condition used
查看公平市场价值
ebay-agent value 索尼 85mm f/1.8 镜头
查看偏好设置
ebay-agent prefs
