Review Summarizer

Overview

Automatically scrape and analyze product reviews from multiple platforms to extract actionable insights. Generate comprehensive summaries with sentiment analysis, pros/cons identification, and data-driven recommendations.

Core Capabilities

1. Multi-Platform Review Scraping

Supported Platforms: - Amazon (product reviews) - Google (Google Maps, Google Shopping) - Yelp (business and product reviews) - TripAdvisor (hotels, restaurants, attractions) - Custom platforms (via URL pattern matching)

Scrape Options: - All reviews or specific time ranges - Verified purchases only - Filter by rating (1-5 stars) - Include images and media - Max review count limits

2. Sentiment Analysis

Analyzes: - Overall sentiment score (-1.0 to +1.0) - Sentiment distribution (positive/neutral/negative) - Key sentiment drivers (what causes positive/negative reviews) - Trend analysis (sentiment over time) - Aspect-based sentiment (battery life, quality, shipping, etc.)

3. Insight Extraction

Automatically identifies: - Top pros mentioned in reviews - Common complaints and cons - Frequently asked questions - Use cases and applications - Competitive comparisons mentioned - Feature-specific feedback

4. Summary Generation

Output formats: - Executive summary (150-200 words) - Detailed breakdown by category - Pros/cons lists with frequency counts - Statistical summary (avg rating, review count, etc.) - CSV export for analysis - Markdown report for documentation

5. Recommendation Engine

Generates recommendations based on: - Overall sentiment score - Review quantity and recency - Verified purchase ratio - Aspect-based ratings - Competitive comparison

Quick Start

Summarize Amazon Product Reviews

# Use scripts/scrape_reviews.py
python3 scripts/scrape_reviews.py 
  --url "https://amazon.com/product/dp/B0XXXXX" 
  --platform amazon 
  --max-reviews 100 
  --output amazon_summary.md

Compare Reviews Across Platforms

# Use scripts/compare_reviews.py
python3 scripts/compare_reviews.py 
  --product "Sony WH-1000XM5" 
  --platforms amazon,google,yelp 
  --output comparison_report.md

Generate Quick Summary

# Use scripts/quick_summary.py
python3 scripts/quick_summary.py 
  --url "https://amazon.com/product/dp/B0XXXXX" 
  --brief 
  --output summary.txt

Scripts

scrape_reviews.py

Scrape and analyze reviews from a single URL.

Parameters: - --url: Product or business review URL (required) - --platform: Platform (amazon, google, yelp, tripadvisor) (auto-detected if omitted) - --max-reviews: Maximum reviews to fetch (default: 100) - --verified-only: Filter to verified purchases only - --min-rating: Minimum rating to include (1-5) - --time-range: Time filter (7d, 30d, 90d, all) (default: all) - --output: Output file (default: summary.md) - --format: Output format (markdown, json, csv)

Example:

python3 scripts/scrape_reviews.py 
  --url "https://amazon.com/dp/B0XXXXX" 
  --platform amazon 
  --max-reviews 200 
  --verified-only 
  --format markdown 
  --output product_summary.md

compare_reviews.py

Compare reviews for a product across multiple platforms.

Parameters: - --product: Product name or keyword (required) - --platforms: Comma-separated platforms (default: all) - --max-reviews: Max reviews per platform (default: 50) - --output: Output file - --format: Output format (markdown, json)

Example:

python3 scripts/compare_reviews.py 
  --product "AirPods Pro 2" 
  --platforms amazon,google,yelp 
  --max-reviews 75 
  --output comparison.md

sentiment_analysis.py

Analyze sentiment of review text.

Parameters: - --input: Input file or text (required) - --type: Input type (file, text, url) - --aspects: Analyze specific aspects (comma-separated) - --output: Output file

Example:

python3 scripts/sentiment_analysis.py 
  --input reviews.txt 
  --type file 
  --aspects battery,sound,quality 
  --output sentiment_report.md

quick_summary.py

Generate a brief executive summary.

Parameters: - --url: Review URL (required) - --brief: Brief summary only (no detailed breakdown) - --words: Summary word count (default: 150) - --output: Output file

Example:

python3 scripts/quick_summary.py 
  --url "https://yelp.com/biz/example-business" 
  --brief 
  --words 100 
  --output summary.txt

export_data.py

Export review data for further analysis.

Parameters: - --input: Summary file or JSON data (required) - --format: Export format (csv, json, excel) - --output: Output file

Example:

python3 scripts/export_data.py 
  --input product_summary.json 
  --format csv 
  --output reviews_data.csv

Output Format

Markdown Summary Structure

# Product Review Summary: [Product Name]

## Overview
- **Platform:** Amazon
- **Reviews Analyzed:** 247
- **Average Rating:** 4.3/5.0
- **Overall Sentiment:** +0.72 (Positive)

## Key Insights

### Top Pros
1. Excellent sound quality (89 reviews)
2. Great battery life (76 reviews)
3. Comfortable fit (65 reviews)

### Top Cons
1. Expensive (34 reviews)
2. Connection issues (22 reviews)
3. Limited color options (18 reviews)

## Sentiment Analysis
- **Positive:** 78% (193 reviews)
- **Neutral:** 15% (37 reviews)
- **Negative:** 7% (17 reviews)

## Recommendation
✅ **Recommended** - Strong positive sentiment with high customer satisfaction.

Best Practices

For Arbitrage Research

1. Compare across platforms - Check Amazon vs eBay seller ratings
2. Look for red flags - High return rates, quality complaints
3. Check authenticity - Verified purchases only
4. Analyze trends - Recent review sentiment vs older reviews

For Affiliate Content

1. Extract real quotes - Use actual customer feedback
2. Identify use cases - How people use the product
3. Find pain points - Problems the product solves
4. Build credibility - Use data from many reviews

For Purchasing Decisions

1. Check recent reviews - Last 30-90 days
2. Look at 1-star reviews - Understand worst-case scenarios
3. Consider your needs - Match features to your use case
4. Compare alternatives - Use compare_reviews.py

Integration Opportunities

With Price Tracker

Use review summaries to validate arbitrage opportunities:

# 1. Find arbitrage opportunity
price-tracker/scripts/compare_prices.py --keyword "Sony WH-1000XM5"

# 2. Validate with reviews
review-summarizer/scripts/scrape_reviews.py --url [amazon_url]
review-summarizer/scripts/scrape_reviews.py --url [ebay_url]

# 3. Make informed decision

With Content Recycler

Generate content from review insights:

# 1. Summarize reviews
review-summarizer/scripts/scrape_reviews.py --url [amazon_url]

# 2. Use insights in article
seo-article-gen --keyword "[product name] review" --use-insights review_summary.json

# 3. Recycle across platforms
content-recycler/scripts/recycle_content.py --input article.md

Automation

Weekly Review Monitoring

# Monitor competitor products
0 9 * * 1 /path/to/review-summarizer/scripts/compare_reviews.py 
  --product "competitor-product" 
  --platforms amazon,google 
  --output /path/to/competitor_analysis.md

Alert on Negative Trends

# Check for sentiment drops below threshold
if [ $(grep -o "Sentiment: -" summary.md | wc -l) -gt 0 ]; then
  echo "Negative sentiment alert" | mail -s "Review Alert" [email protected]
fi

Data Privacy & Ethics

• Only scrape publicly available reviews
• Respect robots.txt and rate limits
• Don't store PII (personal information)
• Aggregate data, don't expose individual reviewers
• Follow platform terms of service

Limitations

• Rate limiting on some platforms
• Cannot access verified purchase status on all platforms
• Fake reviews may skew analysis
• Language support varies by platform
• Some platforms block scraping

---

Make data-driven decisions. Automate research. Scale intelligence.