Ebay Agent

eBay research agent. Search for deals, value items, and compare prices using eBay REST APIs. No eBay account required — just a free developer API key.

Security Scan

The skill's code, runtime instructions, and required credentials align with its stated purpose (querying eBay APIs for search and valuation); nothing requests unrelated secrets or performs unexpected actions.

Purpose & Capability

Name/description (eBay research/valuation) match the code and declared env vars. The skill only asks for EBAY_APP_ID and EBAY_CERT_ID (app-level credentials) which are necessary for the client-credentials OAuth flow it uses.

Instruction Scope

SKILL.md instructs running the CLI via 'uv run' and documents commands (search, value, prefs). The runtime code only uses eBay APIs, environment variables (EBAY_APP_ID, EBAY_CERT_ID, optional EBAY_ENVIRONMENT/EBAY_USER_TOKEN), and standard HTTP calls. It does not read or transmit unrelated local files or other credentials.

Install Mechanism

Installation uses common package managers (brew or pip) to install a binary named 'uv' (the runner referenced in the README/SKILL.md). Providing both brew and pip install options is reasonable, but the 'uv' runner requirement is an additional dependency that users should understand (it's not inherent to eBay API access). There are no downloads from unknown personal URLs or extract-from-URL steps.

Credentials

Only EBAY_APP_ID and EBAY_CERT_ID are required (primaryEnv set appropriately). The skill also references EBAY_ENVIRONMENT and optionally EBAY_USER_TOKEN in documentation — these are relevant and reasonable for sandbox/production selection or user-level tokens. No unrelated tokens or secrets are requested.

Persistence & Privilege

Skill is not always-enabled and does not request persistent elevated privileges or modify other skills. It does call out potential future preferences persistence, but current code uses in-memory defaults and does not write system-wide config.

Assessment

This skill appears coherent: it legitimately needs your eBay App ID and Cert ID to fetch app-level OAuth tokens and call eBay Browse/Insights endpoints. Before installing, verify you are comfortable installing the 'uv' runner (the skill expects running via 'uv run') and prefer testing in EBAY_ENVIRONMENT=sandbox first. Only provide EBAY_APP_ID/EBAY_CERT_ID from accounts you control; if you need user-level operations (create listings, manage orders) you would instead supply an EBAY_USER_TOKEN — this skill does not require that for basic search/valuation. If you want extra caution, inspect network traffic or run in a sandboxed environment to confirm behavior.

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

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

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

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

# 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