bggg-data-amazon

Collect Amazon written reviews via Woot's public AJAX route and normalize them into auditable JSONL.

588|92|Updated May 2, 2026
One-click install
npx skills add https://github.com/binggandata/bggg-skills --skill bggg-data-amazon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bggg-data-amazon
Source: https://github.com/binggandata/bggg-skills/tree/main/bggg-data-amazon
Command: npx skills add https://github.com/binggandata/bggg-skills --skill bggg-data-amazon

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Gathering Amazon product reviews at scale usually requires paid scraper APIs, browser automation, or Amazon credentials. This Skill collects written Amazon US reviews through Woot's public review endpoint with no login or API key, while preserving every attempt and error log so the resulting dataset remains auditable.

Core Features & Use Cases

  • Batch Review Acquisition: Reads a TSV of ASINs with basic/full/max collection modes, runs up to two workers with retries and backoff, and reconciles partial runs by unioning all valid attempts with exact content dedupe.
  • Auditable Evidence Trail: Saves every attempt JSON plus stdout/stderr logs, detects partial runs even when exit codes are zero, and writes an acquisition manifest with per-target status (complete, partial, failed, no reviews).
  • Normalized JSONL Export: Merges duplicate reviews across ASIN variants, parses human-readable dates, builds stable SHA-256 content keys, and outputs analysis-ready JSONL with star ratings, verified-purchase flags, Vine flags, media URLs, and keyword hit labels.
  • Use Case: A VOC analyst needs low-star complaint data for five competitor ASINs. They list the ASINs in a TSV, run the batch script, and receive a deduplicated JSONL file plus a manifest showing exactly which requests succeeded or failed.

Quick Start

Ask the agent to collect Amazon reviews for a list of ASINs using this skill, specifying basic or full mode, and export the normalized results to a JSONL file in the project's data/raw folder.

Frequently Asked Questions about bggg-data-amazon

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scrape Amazon reviews without an API key?

Use the Woot public review AJAX route at woot.com/review/Reviews/{ASIN}, which returns Amazon review JSON without login, cookies, or developer keys. This Skill's scraper iterates star filters and sort orders, then deduplicates results to maximize extraction.

How to collect Amazon reviews for multiple ASINs in bulk?

Create a tab-separated file with asin, mode, lang, and title columns, then run the batch runner script. It processes targets with up to two workers, retries failed attempts with backoff, and writes a reconciled JSON file per ASIN plus an acquisition manifest.

What is the difference between basic, full, and max scrape modes?

Basic mode uses one unfiltered route returning up to about 100 written reviews. Full mode splits by five star ratings for up to roughly 100 per star. Max mode combines five star filters with four sort orders and deduplicates for the largest possible extraction.

Does this Amazon review scraper work outside the US?

No, the Woot route only exposes Amazon US (amazon.com) written reviews. Star-only ratings are unavailable, and a valid ASIN can return HTTP 404 through Woot, which should be treated as an unsupported target rather than a route failure.

Why does the scraper sometimes return fewer reviews than Amazon's rating count?

Each filter and sort combination exposes a limited window, commonly around 100 reviews, and high-volume star buckets can remain truncated even in max mode. Results should be described as collected written reviews, not all customer ratings.

How are duplicate reviews handled across ASIN variants?

The normalizer builds a SHA-256 content key from author, title, and body, then merges identical reviews across ASINs while preserving every observed ASIN in the context field. This keeps syndicated variant reviews auditable instead of silently dropped.