---
name: reddit-growth
description: Reddit Growth Engine (RGE) for product marketing. Finds Reddit posts where people have problems your product solves, drafts helpful comments, tracks karma and engagement. Use when growing a product's Reddit presence, warming up accounts, finding opportunities, or drafting comments. Keywords: reddit marketing, reddit growth, karma farming, subreddit engagement, community marketing.
---

# Reddit Growth Engine (RGE)

AI finds opportunities + drafts comments. Human reviews and posts. No API keys required.

## Workflow

1. **Scan** — Find posts where target users have problems
2. **Analyze** — Read thread, identify gaps, find angle
3. **Draft** — Write helpful comment in product voice
4. **Review** — Human tweaks and posts via browser
5. **Track** — Record posted comments for stats

## Setup for a New Product

### 1. Create Product Config

Copy template to product folder and customize:

```bash
mkdir -p /home/aria/products/<slug>/reddit-growth
cp /home/aria/.openclaw/workspace/skills/reddit-growth/references/config-template.py \
   /home/aria/products/<slug>/reddit-growth/config.py
```

Edit `config.py` with:
- `REDDIT_USERNAME` — The persona account
- `BRAND_NAME` — Product name
- `TIER_1_SUBS` through `TIER_4_SUBS` — Target subreddits
- `HIGH/MEDIUM/LOW_INTENT_KEYWORDS` — Pain points
- `BRAND_DISCLOSURE` — Required disclosure text

### 2. Create CLAUDE.md

Create `/home/aria/products/<slug>/reddit-growth/CLAUDE.md` with:
- Product description, features, pricing
- Competitor analysis (honest pros/cons)
- Voice guidelines
- See `references/claude-template.md` for template

### 3. Initialize Environment

```bash
cd /home/aria/products/<slug>/reddit-growth
ln -s /home/aria/.openclaw/workspace/skills/reddit-growth/scripts/*.py .
python3 -m venv venv && source venv/bin/activate
pip install requests
```

### 4. Create Reddit Account

- Go to reddit.com/register
- Username: sounds like a real person (not `ClocklanePOS`)
- Verify email, add avatar, write industry-related bio
- Subscribe to target subreddits

## CLI Commands

Run from product's reddit-growth folder:

```bash
source venv/bin/activate

# Discovery
python cli.py scan                    # Scan Tier 1+2, new posts
python cli.py scan --mode rising      # Rising posts (best for early comments)
python cli.py scan --mode deep        # All tiers (slow, rate limited)
python cli.py opportunities           # Show ranked queue
python cli.py search <sub> "query"    # Search specific subreddit

# Analysis
python cli.py thread <post_id>        # Full thread + comments
python cli.py thread <post_id> --brief # Just title + body

# Account Health
python cli.py karma                   # Current karma + age
python cli.py mission                 # Today's action plan
python cli.py stats                   # Today's progress
python cli.py health                  # Full health check
python cli.py comments                # Recent public comments

# Tracking
python cli.py posted <id> "text"      # Record posted comment
python cli.py posted <id> "text" --brand  # Record brand mention
python cli.py skip <id>               # Skip opportunity
```

**Note:** Scanning ~12 subs takes ~80 seconds due to rate limits. This is normal.

**⚠️ IP Restriction:** Reddit blocks requests from cloud/VPS IPs. Run the CLI from a local machine (laptop/desktop with consumer IP), NOT from a server.

## 7-Day Warmup (Non-Negotiable)

| Day | Phase | Focus | Comments/Day | Brand? |
|-----|-------|-------|--------------|--------|
| 1-2 | Karma Sprint | Tier 3 only (AskReddit, NoStupidQuestions) | 15-20 | ❌ NO |
| 3-4 | Bridge | Tier 2 (adjacent professional subs) | 12-15 | ❌ NO |
| 5-6 | Enter Targets | Tier 1 (core audience subs) | 8-12 | ❌ NO |
| 7+ | Brand Entry | IF ratio ≥8:1 AND asked for recs | 7-10 | ✅ MAX 1 |

## Rules (Break = Ban)

- **8 helpful : 1 brand mention** — Reddit users check history
- **No links for 14+ days** — Triggers spam filters
- **Always disclose** — "Disclosure: I work at [Product]"
- **Mention competitors first** — 2-3 alternatives before your product
- **Every comment unique** — Reddit detects duplicates
- **Max 20 comments/day** — More = bot behavior
- **Max 1 brand mention/day** — More = spam
- **Human always posts** — Never automate posting

## Comment Structure (When Brand Mention OK)

```
Lines 1-3: Genuine advice (valuable without product mention)
Lines 4-5: Name 2-3 competitors with honest pros/cons
Line 6: Mention your product as ONE option
Line 7: "Disclosure: I work at [Product], which also does this."
```

**Test:** Delete your product mention. Is the comment still useful? If no, don't mention.

## Daily Workflow (~30 min)

1. `python cli.py mission` — Get today's focus
2. `python cli.py scan --mode rising` — Find opportunities
3. Pick top opportunity, `python cli.py thread <id>`
4. Analyze thread: What's asked? What's covered? What's missing?
5. Draft comment (I do this)
6. Human reviews, tweaks, pastes in browser, submits
7. `python cli.py posted <id> "text"` — Record it
8. Repeat 5-15 times depending on phase
9. **Evening:** Reply to every response on your comments

## Files

| File | Purpose |
|------|---------|
| `config.py` | Product config (username, subs, keywords) |
| `CLAUDE.md` | Product knowledge for drafting |
| `cli.py` | Main command tool |
| `radar.py` | Opportunity scoring engine |
| `storage.py` | SQLite state tracking |
| `reddit_client.py` | Public JSON API client |

Database stored at: `~/.jarvis/jarvis.db`
