← Back to Skills Marketplace
mguozhen

Amazon Review Scraper

by mguozhen · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
80
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install amazon-review-scraper
Description
Amazon Review Intelligence — input an ASIN, automatically fetch product reviews via VOC.AI and run Claude AI analysis. Outputs structured VOC report: sentime...
README (SKILL.md)

Amazon Review Scraper — VOC Intelligence

Input an ASIN → fetch reviews via VOC.AI → Claude AI analysis → structured report. No browser, no scraping. Powered by VOC.AI API.

Quick Start

# Basic analysis (8 reviews free, English report)
bash voc.sh B08N5WRWNW

# Chinese report
bash voc.sh B08N5WRWNW --lang zh

# More reviews (requires VOC.AI Team plan token)
bash voc.sh B08N5WRWNW --token YOUR_TOKEN --limit 50

# Save to file
bash voc.sh B08N5WRWNW --output report.md

# Fetch only (no AI, saves JSON)
bash voc.sh B08N5WRWNW --scrape-only --output reviews.json

# Analyze existing JSON
bash voc.sh --analyze reviews.json --asin B08N5WRWNW --lang zh

API Token

  • Free tier: 8 reviews per ASIN — no token needed
  • More reviews: Get a VOC.AI token at https://voc.ai/pricing (Team/Enterprise plan)
  • Pass via --token YOUR_TOKEN or export VOC_TOKEN=YOUR_TOKEN

Sample Output

╔══════════════════════════════════════════════════════╗
║     Amazon Review Intelligence Report               ║
║  ASIN: B08N5WRWNW  │  Reviews: 8    │  amazon.com   ║
║  Generated: 2026-04-01 10:30                         ║
╚══════════════════════════════════════════════════════╝

📊 Sentiment Distribution
  Positive  ████████████░░░░  74%  (6 reviews)
  Neutral   ███░░░░░░░░░░░░░  13%  (1 reviews)
  Negative  ██░░░░░░░░░░░░░░  13%  (1 reviews)
  Verified  ████████████████  89% verified purchases

⭐ Rating Distribution
  5★  ███████████████  5
  4★  ████░░░░░░░░░░░  1
  3★  ██░░░░░░░░░░░░░  1
  2★  █░░░░░░░░░░░░░░  0
  1★  █░░░░░░░░░░░░░░  1

  Average Rating: ████  4.2/5.0

────────────────────────────────────────────────────────

## 🔴 Top 5 Pain Points

1. **Short battery life** (3 mentions)
   > "Battery drained in 2 days, very disappointed"
   - Customers expect longer standby time vs. what's advertised

## 🟢 Top 5 Selling Points

1. **Excellent sound quality** (5 mentions)
   > "Amazing bass and crystal clear highs for the price"

## 💡 Listing Optimization
...

Requirements

  • Python 3.8+
  • requests (auto-installed on first run)
  • claude CLI for AI analysis (optional — scrape-only mode works without it)
  • VOC.AI API token for more than 8 reviews

Notes

  • Default free tier: 8 reviews per ASIN
  • Want more? Upgrade to VOC.AI Team plan (https://voc.ai/pricing) — uses credits
  • Each AI analysis uses 2,000–5,000 Claude tokens ($0.01–$0.03)
  • Supports all Amazon marketplaces via VOC.AI
Usage Guidance
Before installing or running: (1) Review and be comfortable that review text will be sent to VOC.AI (API endpoint in scraper.py) and to the local 'claude' CLI (which will contact Anthropic services). (2) The analyzer passes '--dangerously-skip-permissions' to the Claude CLI — this bypasses client-side permission prompts and could allow broader data transmission; avoid running with sensitive or PII-containing data unless you trust the target services. (3) The script will auto-install the 'requests' package via pip if missing—run in a virtualenv or sandbox if you prefer isolation. (4) Provide a VOC.AI Team token only if you understand billing/credit implications. (5) If you need higher assurance, run the scripts in an isolated environment, inspect the code, and/or remove or modify the '--dangerously-skip-permissions' usage in analyze.py before use.
Capability Analysis
Type: OpenClaw Skill Name: amazon-review-scraper Version: 1.0.0 The skill contains several high-risk vulnerabilities and behaviors. The main entry point `voc.sh` is vulnerable to shell injection because it passes unquoted variables ($SCRAPE_ARGS) to a python3 command, which could allow arbitrary code execution if parameters like the API token are manipulated. Additionally, `analyze.py` passes untrusted review data into the `claude` CLI using the `--dangerously-skip-permissions` flag, creating a high risk of indirect prompt injection. Finally, `scraper.py` performs unauthorized environment modification by automatically executing `pip install` to fetch dependencies.
Capability Assessment
Purpose & Capability
The code and SKILL.md align with the stated purpose: scraper.py calls VOC.AI APIs and analyze.py calls a local 'claude' CLI to generate VOC reports. Minor inconsistency: registry metadata lists no environment variables, but the scripts expect an optional VOC_TOKEN env var (and the analysis requires a configured 'claude' CLI). Requiring VOC.AI tokens and an AI CLI is coherent with the skill's purpose.
Instruction Scope
Runtime instructions and included scripts only fetch reviews from VOC.AI and send review text to the 'claude' CLI for analysis. However analyze.py invokes claude with the flag '--dangerously-skip-permissions' which explicitly bypasses permission safeguards — this is a security-relevant behavior because it may cause the Claude/Anthropic client to transmit data without normal permission checks. The scripts do not read unrelated system files or network endpoints beyond VOC.AI and the local 'claude' binary.
Install Mechanism
There is no declared install spec (instruction-only skill), but scraper.py will auto-install the 'requests' package at runtime if missing (pip install). Auto-installing from PyPI at runtime is common but adds runtime network dependency and writes to disk; be aware code performs pip installs.
Credentials
The only external credentials involved are an optional VOC.AI token (VOC_TOKEN) and whatever credentials the user's local 'claude' CLI requires (Anthropic/Claude). The registry metadata did not declare VOC_TOKEN, which is a small documentation mismatch. No unrelated credentials or system config paths are requested.
Persistence & Privilege
The skill does not request permanent agent presence (always:false), does not modify other skills or system-wide configs, and cleans up its temporary JSON file. No elevated persistence or privilege escalation behavior detected.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install amazon-review-scraper
  3. After installation, invoke the skill by name or use /amazon-review-scraper
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of amazon-review-scraper. - Fetches Amazon product reviews by ASIN using VOC.AI API (no scraping or browser required). - Analyzes reviews with Claude AI to generate structured VOC reports, including sentiment breakdown, pain points, selling points, optimization suggestions, and SEO keywords. - Free tier supports up to 8 reviews per ASIN; higher limits available with a VOC.AI token. - Provides multiple output options, language support (English/Chinese), and integrates easily with Bash. - Compatible with all Amazon marketplaces through VOC.AI.
Metadata
Slug amazon-review-scraper
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Amazon Review Scraper?

Amazon Review Intelligence — input an ASIN, automatically fetch product reviews via VOC.AI and run Claude AI analysis. Outputs structured VOC report: sentime... It is an AI Agent Skill for Claude Code / OpenClaw, with 80 downloads so far.

How do I install Amazon Review Scraper?

Run "/install amazon-review-scraper" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Amazon Review Scraper free?

Yes, Amazon Review Scraper is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Amazon Review Scraper support?

Amazon Review Scraper is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Amazon Review Scraper?

It is built and maintained by mguozhen (@mguozhen); the current version is v1.0.0.

💬 Comments