reddit-spy

# Reddit Spy -- Stealth Subreddit Intelligence

Browse any target subreddit, read full posts, analyze strategies, and extract competitive intelligence -- all without getting blocked by Reddit.

**Entry point:**

```bash
python3 /root/.openclaw/skills/reddit-spy/scripts/reddit_spy.py <command> [options]
```

All commands output JSON to stdout. Logs go to stderr.

---

## Setup

**Tor (primary, already running):**
Tor provides real-time Reddit access from any IP. It's running on this VPS as a systemd service.

```bash
# Verify Tor is running
systemctl status tor@default

# If stopped, start it
systemctl start tor@default
```

**Optional: Reddit OAuth (even more reliable):**
If you have Reddit API access, set these env vars for 60 req/min:

```bash
export REDDIT_CLIENT_ID="your-app-client-id"
export REDDIT_CLIENT_SECRET="your-app-secret"
export REDDIT_USERNAME="your-reddit-username"
export REDDIT_PASSWORD="your-reddit-password"
```

**Optional: Proxy:**
```bash
export REDDIT_PROXY_URL="http://user:pass@proxy:port"
```

---

## Fetching Layers (Cascade Order)

| Layer | Method | Speed | Data | Status |
|-------|--------|-------|------|--------|
| 1. OAuth API | Reddit API v2 | Fast | Full real-time | Optional (needs API key) |
| 2. **Tor** | SOCKS5 via Tor exit nodes | Fast | **Full real-time** | **ACTIVE -- primary layer** |
| 3. Stealth HTTP | old.reddit.com direct | Fast | Full real-time | Blocked on VPS IPs |
| 4. Browser Stealth | Playwright | Slow | Full real-time | Blocked on VPS IPs |
| 5. PullPush | Archive API | Fast | Historical (may lag) | Always works |

Each command tries layers in order, falls through on failure. Layer health is cached for 1 hour. Tor auto-rotates circuits (new IP) on rate limits.

---

## Commands

### `spy` -- Comprehensive Subreddit Intelligence

Full scan: about info + top posts + strategy analysis in one pass.

```bash
python3 .../reddit_spy.py spy --subreddit IndieHackers --sort top --timeframe week --limit 25
```

| Param | Default...