playstore-review-responder

Open-source CLI to auto-reply to Google Play reviews using any OpenAI-compatible AI endpoint.

What it does

• Fetches unreplied Google Play reviews
• Generates concise replies with your AI endpoint
• Uses the review text language directly (no metadata-based language guessing)
• Optionally posts replies to Google Play (DRY_RUN=false)
• Stores state and run reports in data/

Quick start (automatic setup)

npx playstore-review-responder setup

Interactive setup asks for:

• AI provider (OpenAI / OpenRouter / Custom)
• OpenAI-compatible base_url, api_key, model
• Google Play service account JSON path
• Support email
• Daily run hours + timezone
• Auto-fetch accessible apps from your Play account

Then it creates:

• .env (fully populated)
• config/apps.json (auto-fetched apps or manual package)
• data/
• .install-cron.sh (optional cron installer)

Validate integration:

npx playstore-review-responder validate

Preview unreplied reviews:

npx playstore-review-responder preview

Run once:

npx playstore-review-responder run

Run as daemon (startup + CRON_SCHEDULES):

npx playstore-review-responder daemon

Install system cron from generated script (optional):

bash ./.install-cron.sh

Manual env example

If you prefer editing manually:

GOOGLE_PLAY_SERVICE_ACCOUNT_JSON=/absolute/path/to/google-play-service-account.json
OPENAI_API_KEY=your-key
OPENAI_BASE_URL=https://api.openai.com/v1
OPENAI_MODEL=gpt-4o-mini
AI_PROVIDER=openai
DRY_RUN=true
CRON_SCHEDULES=0 09 * * *|0 21 * * *
TIMEZONE=Europe/Istanbul
RUN_ON_START=true

When you are ready for live replies, set DRY_RUN=false.

Local development

npm install
npm run setup
npm run validate
npm run run:once

Commands

• setup: interactive auto setup
• init: create starter files only
• validate: check AI endpoint and Google Play API access
• preview: fetch unreplied reviews only
• run: generate and send replies (or dry-run)
• daemon: run continuously with schedule

Google Play API setup

1. In Google Cloud Console, enable Google Play Android Developer API.
2. Create a service account and download JSON key.
3. In Play Console:
   • Go to Users and permissions
   • Invite the service account email
   • Grant permissions for reviews/replies for target apps
4. Put JSON path into .env as GOOGLE_PLAY_SERVICE_ACCOUNT_JSON.

AI endpoint compatibility

Any endpoint that supports these OpenAI routes should work:

• GET /models (validation)
• POST /chat/completions (reply generation)

Data files

• data/reply-state.json: tracks replied review IDs
• data/reports/YYYY-MM-DD.jsonl: per-run report records

License

MIT