ebay-agent

# 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 ```bash ebay-agent search "Sony 85mm f/1.8 lens" ebay-agent search "iPad Air" --max-price 300 --condition used ebay-agent search "Nintendo Switch" --sort price --limit 20 ``` Options: `--max-price/-p`, `--condition/-c` (new, used, very_good, good, acceptable), `--limit/-n` (default: 10), `--sort/-s` (score, price, seller), `--json` ### `value` — Estimate what an item is worth ```bash ebay-agent value "iPad Air 2 64GB" ebay-agent value "Sony 85mm f/1.8 lens" --condition very_good --limit 30 ``` 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), `--json` ### `prefs` — View search preferences ```bash ebay-agent prefs ``` Shows current scoring preferences: min condition, min seller score, budget, strategy (price/speed/balanced). ## Required Environment Variables | Variable | Required | Description | |----------|----------|-------------| | `EBAY_APP_ID` | Yes | eBay app client ID from developer.ebay.com | | `EBAY_CERT_ID` | 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](https://developer.ebay.com) and create a free account 2. Create an application to get your App ID and Cert ID 3. Set `EBAY_APP_ID` and `EBAY_CERT_ID` in your environment ## Example workflow ```bash # Search for deals ebay-agent search "Sony 85mm f/1.8 lens" --max-price 400 --condition used # Check fair market value ebay-agent value "Sony 85mm f/1.8 lens" # View preferences ebay-agent prefs ```