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
- Search —
POST /ebay/search with a flat JSON body containing keyword to find candidate listings by keyword.
- Item detail —
GET /ebay/item/{item_id} for a specific listing's
price, condition, and specs.
- 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.
- Seller feedback —
GET /ebay/seller/{seller}/feedback (paginate
with page/per_page) for the feedback summary, detailed ratings,
and recent review cards.
- 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.
1---2name: ebay-research3description: Researches eBay listings, items, and sellers using the Crawlora API, returning clean JSON. Use when the user asks to search eBay, look up an item's details, or vet a seller's reputation and shop listings — instead of scraping eBay pages.4---56# eBay research78Search eBay, pull item details, and vet sellers — all as normalized JSON9from the Crawlora API, with no HTML scraping.1011## When to use this skill1213- "What does X cost on eBay?" or "find listings for X on eBay."14- "Get the details for this eBay item" (price, condition, specs).15- "Is this eBay seller trustworthy?" / "pull a seller's feedback and ratings."16- "What's in this eBay seller's shop / store?"17- Competitive pricing or listing research scoped to eBay.1819## Setup (one-time)2021- Get a free Crawlora API key (2,000 credits/mo, no card) at [https://crawlora.net](https://crawlora.net?utm_source=github&utm_medium=referral&utm_campaign=crawlora-skills).22- Set `CRAWLORA_API_KEY` in the environment before running the helper.23- The helper reads `CRAWLORA_API_KEY` from the environment and sends requests to `https://api.crawlora.net/api/v1`. Missing/invalid key → `401`.2425## How it works26271. **Search** — `POST /ebay/search` with a flat JSON body containing `keyword` to find candidate listings by keyword.282. **Item detail** — `GET /ebay/item/{item_id}` for a specific listing's29 price, condition, and specs.303. **Seller profile** — `GET /ebay/seller/{seller}` for the seller's31 headline profile, and `GET /ebay/seller/{seller}/about` for stats,32 top-rated status, and store categories.334. **Seller feedback** — `GET /ebay/seller/{seller}/feedback` (paginate34 with `page`/`per_page`) for the feedback summary, detailed ratings,35 and recent review cards.365. **Seller shop** — `GET /ebay/seller/{seller}/shop` (paginate with37 `page`) to list everything a seller currently has for sale.3839Full endpoint list, methods, and params: [`reference/endpoints.md`](reference/endpoints.md).4041## Calling the API4243```sh44# Search eBay (POST, JSON body):45scripts/crawlora.sh -X POST /ebay/search '{"keyword":"mechanical keyboard"}' | jq '.'4647# Item detail:48scripts/crawlora.sh /ebay/item/1234567890 | jq '.data'4950# Seller feedback (paginated):51scripts/crawlora.sh /ebay/seller/some-seller/feedback page=1 per_page=20 | jq '.'52```5354Use `scripts/crawlora.sh` for all requests; it keeps the API key out of command-line arguments.555657## Endpoint reference5859See [`reference/endpoints.md`](reference/endpoints.md) for every eBay60endpoint this skill uses (method, path, params, description).6162## Examples6364- **Price check:** `POST /ebay/search` with `{"keyword":"..."}` to65 collect candidate listings and their prices for a keyword.66- **Seller due diligence:** `/ebay/seller/{seller}/about` +67 `/ebay/seller/{seller}/feedback` to summarize a seller's top-rated68 status, ratings breakdown, and recent feedback before buying.69- **Shop audit:** `/ebay/seller/{seller}/shop` (paginate with `page`) to70 list everything a seller currently has for sale.7172## Notes & limits7374- **Credits / pay-on-success:** billed only on `2xx`; free tier 2,000 credits/mo.75 Key at [https://crawlora.net](https://crawlora.net?utm_source=github&utm_medium=referral&utm_campaign=crawlora-skills).76- **Public data only** — public listing/seller pages; respect eBay's terms.77- **Security:** key lives in `CRAWLORA_API_KEY` only — never hardcode, query-param, or commit it.78- `/ebay/search` is a `POST` with flat fields such as `keyword`, `page`, and79 `limit`; the MCP argument name `option` is not a REST JSON wrapper.80- Feedback and shop listings are paginated — pass `page` (and `per_page`81 for feedback) to walk beyond the first page.