AI Review Insight Extractor (App Store)

Apify Actor: paste an App Store app URL → get structured insights (liked features, complaints, sentiment, etc.) via Groq (Llama).

Supported platform: Apple App Store only. Other URLs return a clear error.

---

Setup

npm install
cp .env.example .env
# Edit .env: set GROQ_API_KEY=your_key (required for AI)

App Store — no API key required

• Method: Apple’s public iTunes RSS feed for app reviews (no auth).
• URL must include the app ID:
  https://apps.apple.com/app/app-name/id123456789
  or
  https://apps.apple.com/us/app/app-name/id123456789
  The number after id is the app ID; we use it to request the RSS feed.

Groq model

The Actor uses llama-3.1-8b-instant by default (fast, low cost). To override, set env/secret GROQ_MODEL (e.g. llama-3.3-70b-versatile for higher quality). See Groq models.

429 / Rate limit: If you see "Groq rate limit exceeded", check your Groq rate limits. The Actor retries once after 10s on 429.

---

Run locally

# App Store (URL must contain /id123456789/)
node src/main.js "https://apps.apple.com/app/notion/id1232783681"

# Or use env
INPUT_URL="https://apps.apple.com/app/your-app/id123456789" INPUT_MAX_REVIEWS=40 node src/main.js

---

Deploy to Apify

1. Apify CLI

npm install -g apify-cli
apify login
apify push

2. Set secrets

In Apify Console → your Actor → Settings → Environment variables / Secrets:

• Add GROQ_API_KEY (as a secret or environment variable) with your Groq API key. Apify injects it as process.env.GROQ_API_KEY at run time.

3. Run on Apify

• Input: { "url": "https://apps.apple.com/app/.../id123456789", "maxReviews": 80 }
url must be an App Store app URL; maxReviews is optional (default 80, max 150).
• Output: One dataset item (insights JSON or error). Logs appear in the run log.

4. GitHub (optional)

Connect your repo in Apify Console → Actor → Source → Git. See Apify deployment docs.

---

Monetization (pay per event)

The Actor charges one event per run (insight-generated). Each output includes billingUnits: 1 and billingEvent: "insight-generated".

To enable pricing:

1. In Apify Console → Actor → Publication → Monetization, choose Pay per event (PPE).
2. Add event insight-generated and set a price (e.g. $5 per 1,000 events = $0.005 per run).
3. See ./PRICING.md for full setup and recommended pricing.

---

Structure

• src/main.js — entry, orchestration, Actor.init + logging
• src/logger.js — logging (Actor.log on Apify, console locally)
• src/platforms.js — App Store URL helpers (app ID, RSS URL)
• src/reviewScraper.js — App Store (iTunes RSS)
• src/ai.js — Groq (Llama), JSON-only
• src/utils.js — chunking (30), merge + dedup (top 5–8 per category)
• .actor/actor.json — Actor metadata and input schema path
• .actor/INPUT_SCHEMA.json — input: url (required), maxReviews (optional)

See prd.md for full requirements.