robertguss/app-review-analyzer

Prerequisites

• Chrome browser with Claude in Chrome extension (for reading store reviews)
• No API keys required — all analysis is done through live browser interaction
• Supports iOS App Store and Google Play Store

Mode Selection

Ask the user which mode they need:

1. Competitive Analysis — Analyze a competitor's reviews to find gaps and opportunities
2. Own App Management — Analyze your own app's reviews to prioritize fixes, surface feature requests, and draft professional responses

If the user provides a competitor's app, use Competitive Analysis mode. If they mention "my app" or "our app," use Own App Management mode.

---

Competitive Analysis Mode

Step 1: Navigate to the App Listing

Open the app's store page in Chrome:

• iOS App Store: Search on apps.apple.com or use a direct link
• Google Play: Search on play.google.com or use a direct link

Confirm the correct app with the user before proceeding.

Step 2: Collect Reviews Systematically

Read reviews in two passes:

1. Most Recent — Sort by newest first. Read at least 30-50 reviews to capture current sentiment.
2. Most Critical — Sort by lowest rating (1-star, then 2-star). Read at least 20-30 critical reviews to surface pain points.

For each review, note:

• Star rating
• Date posted
• Review text (key quotes)
• Whether the developer responded

Step 3: Categorize Reviews

Assign each review to one or more theme categories:

| Category | Signals | | ---------------------- | ---------------------------------------------------------------- | | Bug Reports | Crashes, errors, data loss, freezing, sync failures | | Missing Features | "I wish it had...", "Why can't I...", "Needs..." | | UX Complaints | "Too complicated", "Can't find...", "Confusing", "Slow" | | Pricing Objections | "Too expensive", "Not worth it", "Used to be free" | | Praise | Specific features users love, "best app for...", loyalty signals | | Support Complaints | "No response", "Unhelpful", "Can't reach anyone" |

Step 4: Produce the Analysis Report

Generate a structured report using the template in references/analysis-report-template.md. The report must include:

1. Theme Frequency Table — Count of reviews per category, sorted by frequency
2. Sentiment Trend — Are recent reviews better or worse than older ones?
3. Top 5 Pain Points — With direct quotes from reviews
4. Top 5 Praised Features — Competitor strengths you must match or exceed
5. Opportunity Summary — Gaps you could fill, weaknesses to exploit

---

Own App Management Mode

Step 1: Navigate to Your App's Reviews

Open your app's store page in Chrome. Confirm the correct app.

Step 2: Collect and Categorize Reviews

Follow the same collection process as Competitive Analysis (Steps 2-3 above).

Step 3: Prioritize Issues

Score each theme by Frequency x Severity:

| Severity | Definition | | ---------------- | -------------------------------------------------------- | | Critical (3) | Data loss, crashes, security issues, payment failures | | High (2) | Core functionality broken, major UX blockers | | Medium (1) | Nice-to-have features, minor annoyances, cosmetic issues |

Calculate priority score: count of reviews in theme x severity weight

Sort themes by priority score descending. This is the fix-first order.

Step 4: Draft Review Responses

For each negative review (1-3 stars), draft a response following the templates in references/response-templates.md.

Key response principles:

• Respond within 24-48 hours — speed improves update likelihood
• Never be defensive or argumentative
• Personalize every response — reference specific details from their review
• Acknowledge the problem before offering solutions
• Include a direct contact method for follow-up when appropriate
• Keep responses concise (2-4 sentences for most cases)

Platform-specific notes:

• iOS App Store: Developer responses appear publicly under the review. Users receive a notification and can update their rating.
• Google Play: Developer responses also appear publicly. You can report policy-violating reviews (spam, off-topic, profanity) via the Play Console.

Step 5: Produce the Action Plan

Generate a report using references/analysis-report-template.md with an additional action plan section:

1. Fix First — Critical bugs and top pain points by priority score
2. Add Next — Most-requested features with user quotes as evidence
3. Communicate — Issues that need a public response or in-app messaging
4. Monitor — Themes to watch in future review cycles

---

Review Category Quick Reference

Use this decision tree when categorizing ambiguous reviews:

Review mentions a crash/error/data loss?
  → Bug Report

Review says "I wish" or "please add" or "why can't I"?
  → Missing Feature

Review says "confusing" or "hard to use" or "can't find"?
  → UX Complaint

Review mentions price, subscription, cost, or payment?
  → Pricing Objection

Review says "no response" or "support" or "help"?
  → Support Complaint

Review is purely positive with no complaints?
  → Praise

Review has multiple themes?
  → Assign all applicable categories

Resources

references/

• response-templates.md — Detailed response templates for every review category with multiple variants each. Load when drafting review responses.
• analysis-report-template.md — Full markdown template for the analysis report output. Load when producing the final report.