PainMiner

Mine complaints and pain points from Reddit.

A personal CLI tool that scans subreddits, analyzes posts and comments with Gemini, and outputs a clean list of complaints you can use for product research.

Features

• Scan multiple subreddits at once
• Analyze both posts and comments
• Use Gemini to identify real complaints vs neutral content
• Output as Markdown or JSON
• Respectful rate limiting for Reddit

Setup

cd projects/painminer
pnpm install
# or: npm install

cp .env.example .env

Reddit OAuth Setup

1. Go to https://www.reddit.com/prefs/apps
2. Click "create another app..."
3. Select "script"
4. Fill in name and redirect URI (http://localhost:8080)
5. Copy the client ID and secret into .env

Environment Variables

GEMINI_API_KEY_1=your_gemini_api_key
REDDIT_CLIENT_ID=your_reddit_client_id
REDDIT_CLIENT_SECRET=your_reddit_client_secret
REDDIT_USERNAME=your_reddit_username
REDDIT_PASSWORD=your_reddit_password

Usage

pnpm dev
# or: npm run dev

Configuration

Edit src/config.ts to change:

• subreddits: which subreddits to scan
• sort: new / hot / top
• limit: posts per subreddit
• maxCommentsPerPost: how many comments to analyze per post
• outputFormat: markdown or json

Output

Reports are saved to ./output/ with timestamps.

Example Markdown Output

# PainMiner Report

**Subreddits:** SideProject, indiehackers
**Generated:** 2026-06-27T15:30:00.000Z
**Total complaints found:** 12

## Complaints

### r/SideProject

- **Struggling to find reliable marketing channels after launch.**
  - I've launched 3 side projects and every time the hardest part is getting anyone to care. Twitter posts get 10 likes max.
  - [source](https://www.reddit.com/r/SideProject/comments/xxx/) | by u/indie_dev_99 | 45↑

- **Managing customer feedback across multiple tools is chaotic.**
  - Right now I have feedback in email, Twitter DMs, and a Notion board. I keep losing good ideas.
  - [source](https://www.reddit.com/r/SideProject/comments/yyy/) | by u/saas_builder | 23↑

License

MIT