mcpField
A
amazon-research

amazon-research

github.com/crawlora-orgOther141 installsUpdated 1d ago
Repository

About amazon-research

amazon-research is a skill for querying Amazon product listings through the Crawlora API. It supports product searches, ASIN lookups, pricing and availability checks, review samples, and keyword suggestions.

Key features

  1. 01Search listings by keyword
  2. 02Fetch product details by ASIN
  3. 03Check pricing and availability
  4. 04Read inline review samples
  5. 05Get Amazon search suggestions

Use cases

  1. 01Compare Amazon product prices
  2. 02Find candidate listings for a product
  3. 03Check availability for a known ASIN
  4. 04Expand keywords before a product search

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/crawlora-org/crawlora-skills --skill amazon-research

After installing, type/amazon-researchin Claude Code to confirm it loaded.

Bundled filesreference/endpoints.mdscripts/crawlora.sh

Details

From the project README

Amazon product research

Look up and search Amazon products — pricing, availability, overview data, inline reviews, and search suggestions — all as normalized JSON from the Crawlora API, with no HTML scraping.

When to use this skill

  • "What does X cost on Amazon?" / "find this product on Amazon."
  • "Search Amazon for X" and return candidate listings.
  • "Look up this ASIN" / "get price and availability for B0XXXXXXX."
  • "What does Amazon autocomplete suggest for this keyword?"
  • Competitive pricing or catalog research scoped to Amazon.

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 — /amazon/search with a keyword (k) to find candidate products; paginate with page, sort with s.
  2. Detail — /amazon/product/{asin} to fetch a specific product's pricing, availability, overview data, inline review samples, and descriptive content; optionally scope by currency/language.
  3. Suggest — /amazon/suggest/{keyword} for Amazon's own typeahead keyword suggestions, useful for discovering related search terms before running a full search.

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

Calling the API

# Search Amazon (GET, key=value params):
scripts/crawlora.sh /amazon/search k="standing desk" | jq '.'

# Product detail (ASIN is a path param):
scripts/crawlora.sh /amazon/product/B0XXXXXXX | jq '.data'

# Search suggestions (keyword is a path param):
scripts/crawlora.sh /amazon/suggest/standing | 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 Amazon endpoint this skill uses (method, path, params, description).

Examples

  • Price check by ASIN: /amazon/product/{asin} and read price / availability from the response.
  • Keyword-to-listing pipeline: /amazon/suggest/{keyword} to expand a rough query into Amazon's own suggested terms, then /amazon/search on the best ones to collect candidate listings.
  • Catalog sweep: paginate /amazon/search with page for a keyword, collecting asin + price from each result to build a price snapshot.

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 Amazon product/listing pages; respect Amazon's terms.
  • Security: key lives in CRAWLORA_API_KEY only — never hardcode, query-param, or commit it.
  • Results are paginated — pass page on /amazon/search to walk listings.
  • asin and keyword are path params (substituted into the URL), not query params — pass them as the last path segment, e.g. /amazon/product/B0XXXXXXX, not asin=B0XXXXXXX.
  • All endpoints target amazon.com only.

Comments

Markdown supported