Turn reviews into insights

Mine customer sentiment and extract the themes customers actually complain about or love โ€” from any ASIN's reviews. Pure Python, no NLP dependencies, free on GitHub Actions.

Fork it on GitHub

โœจ What it does

๐Ÿ˜Š Sentiment scoring

A lightweight lexicon scores each review positive, neutral, or negative โ€” no heavy ML models required.

โญ Rating distribution

Aggregates the 1โ€“5 star breakdown so you see the real shape of customer opinion.

๐Ÿ”ฅ Theme mining

Extracts the most common complaint and praise keywords, so you know what to fix or feature.

๐Ÿ—“๏ธ Daily refresh

Re-runs on a schedule and commits fresh stats, tracking sentiment drift over time.

๐Ÿš€ Quick start

# 1. Fork & clone
git clone https://github.com/pangolinfoapi/amazon-review-analyzer
cd amazon-review-analyzer

# 2. Configure ASINs to analyze
cp reviews.example.json reviews.json
#   edit reviews.json

# 3. Run locally
export PANGOLIN_TOKEN=eyJ...your_jwt
python3 amazon_review_analyzer.py run
python3 amazon_review_analyzer.py report

Add the PANGOLIN_TOKEN repository secret and the daily workflow handles the rest.

๐ŸŒ Part of the Pangolinfo tool family