SuperAPI AI Directory
Partner with us中文AI newsFavorites
Skillsebay-research

ebay-research

Writing & research

View repository

Updated 10-15 20:29

About this skill

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.
  3. 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.
  4. Seller feedback — GET /ebay/seller/{seller}/feedback (paginate with page/per_page) for the feedback summary, detailed ratings, and recent review cards.
  5. 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.