ebay-research

eBay research

Search eBay, pull item details, and vet sellers — all as normalized JSON from the Crawlora API, with no HTML scraping.

When to use this skill

• "What does X cost on eBay?" or "find listings for X on eBay."
• "Get the details for this eBay item" (price, condition, specs).
• "Is this eBay seller trustworthy?" / "pull a seller's feedback and ratings."
• "What's in this eBay seller's shop / store?"
• Competitive pricing or listing research scoped to eBay.

Setup (one-time)

• Get a free Crawlora API key (2,000 credits/mo, no card) at https://crawlora.net.
• Set CRAWLORA_API_KEY in the environment before running the helper.
• The helper reads CRAWLORA_API_KEY from the environment and sends requests to https://api.crawlora.net/api/v1. Missing/invalid key → 401.

How it works

1. Search — POST /ebay/search with a flat JSON body containing keyword to find candidate listings by keyword.
2. Item detail — GET /ebay/item/{item_id} for a specific listing's

price, condition, and specs.

1. Seller profile — GET /ebay/seller/{seller} for the seller's

headline profile, and GET /ebay/seller/{seller}/about for stats, top-rated status, and store categories.

1. Seller feedback — GET /ebay/seller/{seller}/feedback (paginate

with page/per_page) for the feedback summary, detailed ratings, and recent review cards.

1. Seller shop — GET /ebay/seller/{seller}/shop (paginate with

page) to list everything a seller currently has for sale.

Full endpoint list, methods, and params: `reference/endpoints.md`.

Calling the API

# Search eBay (POST, JSON body):
scripts/crawlora.sh -X POST /ebay/search '{"keyword":"mechanical keyboard"}' | jq '.'

# Item detail:
scripts/crawlora.sh /ebay/item/1234567890 | jq '.data'

# Seller feedback (paginated):
scripts/crawlora.sh /ebay/seller/some-seller/feedback page=1 per_page=20 | jq '.'

Use scripts/crawlora.sh for all requests; it keeps the API key out of command-line arguments.

Endpoint reference

See `reference/endpoints.md` for every eBay endpoint this skill uses (method, path, params, description).

Examples

• Price check: POST /ebay/search with {"keyword":"..."} to

collect candidate listings and their prices for a keyword.

• Seller due diligence: /ebay/seller/{seller}/about +

/ebay/seller/{seller}/feedback to summarize a seller's top-rated status, ratings breakdown, and recent feedback before buying.

• Shop audit: /ebay/seller/{seller}/shop (paginate with page) to

list everything a seller currently has for sale.

Notes & limits

• Credits / pay-on-success: billed only on 2xx; free tier 2,000 credits/mo.

Key at https://crawlora.net.

• Public data only — public listing/seller pages; respect eBay's terms.
• Security: key lives in CRAWLORA_API_KEY only — never hardcode, query-param, or commit it.
• /ebay/search is a POST with flat fields such as keyword, page, and

limit; the MCP argument name option is not a REST JSON wrapper.

• Feedback and shop listings are paginated — pass page (and per_page

for feedback) to walk beyond the first page.