# Send Reddit Spy to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "reddit-spy",
    "name": "Reddit Spy",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/hioliver933/reddit-spy",
    "canonicalUrl": "https://clawhub.ai/hioliver933/reddit-spy",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/reddit-spy",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=reddit-spy",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "_meta.json",
      "requirements.txt",
      "scripts/lib/__init__.py",
      "scripts/lib/browser_stealth.py",
      "scripts/lib/cascade_fetcher.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/reddit-spy"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/reddit-spy",
    "downloadUrl": "https://openagent3.xyz/downloads/reddit-spy",
    "agentUrl": "https://openagent3.xyz/skills/reddit-spy/agent",
    "manifestUrl": "https://openagent3.xyz/skills/reddit-spy/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/reddit-spy/agent.md"
  }
}
```
## Documentation

### 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:

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.

# 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:

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:

export REDDIT_PROXY_URL="http://user:pass@proxy:port"

### Fetching Layers (Cascade Order)

LayerMethodSpeedDataStatus1. OAuth APIReddit API v2FastFull real-timeOptional (needs API key)2. TorSOCKS5 via Tor exit nodesFastFull real-timeACTIVE -- primary layer3. Stealth HTTPold.reddit.com directFastFull real-timeBlocked on VPS IPs4. Browser StealthPlaywrightSlowFull real-timeBlocked on VPS IPs5. PullPushArchive APIFastHistorical (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.

### spy -- Comprehensive Subreddit Intelligence

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

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

ParamDefaultValues--subreddit(required)Subreddit name without r/--sorttophot, new, top, rising--timeframeweekhour, day, week, month, year, all--limit25Max posts to analyze

Returns: about metrics, posts fetched, content type breakdown, hook patterns, timing analysis, top 5 posts, actionable recommendations.

### deep-read -- Full Post Deep Dive

Read complete post body + all nested comments with statistics.

python3 .../reddit_spy.py deep-read --url "https://www.reddit.com/r/.../comments/..." --depth 8

Returns: full post, flattened comment list (author, body, score, depth, is_op), comment stats.

### bulk-scan -- Multi-Subreddit Sweep

Scan multiple subreddits in one run with comparison.

python3 .../reddit_spy.py bulk-scan --subreddits "IndieHackers,SaaS,Entrepreneur" --timeframe all --limit 20

Returns: per-subreddit strategy analysis + cross-sub comparison (ranked by subscribers and engagement).

### strategy -- Strategy Pattern Extraction

Extract what content strategies work best in a subreddit.

python3 .../reddit_spy.py strategy --subreddit SaaS --sort top --timeframe month --limit 50

Returns: content types ranked, hook patterns ranked, best posting hours/days, top 5 posts, recommendations.

### search -- Keyword Search

Search within a subreddit for specific topics.

python3 .../reddit_spy.py search --subreddit IndieHackers --query "growth strategy" --sort top --timeframe month

### user-intel -- User Profile Analysis

Analyze a Reddit user's posting patterns across subreddits.

python3 .../reddit_spy.py user-intel --username some_user --limit 25

Returns: total posts, subreddit distribution, content patterns, hook analysis.

### health-check -- Test Layers

Test which fetching layers are currently working.

python3 .../reddit_spy.py health-check --test-sub python

### Step 1: Health check

python3 .../reddit_spy.py health-check

Verify which layers are operational before starting analysis.

### Step 2: Bulk scan targets

python3 .../reddit_spy.py bulk-scan --subreddits "IndieHackers,SaaS,Entrepreneur,Automation" --timeframe week --limit 25

### Step 3: Deep-dive top posts

Pick high-scoring posts from Step 2 and read full content + comments:

python3 .../reddit_spy.py deep-read --url "https://reddit.com/r/.../comments/..."

### Step 4: Profile top contributors

python3 .../reddit_spy.py user-intel --username top_poster

### Step 5: Search for topic gaps

python3 .../reddit_spy.py search --subreddit IndieHackers --query "automation" --sort top

### Strategy Analysis Output

The spy, bulk-scan, and strategy commands return:

content_types: question, how-to, tip, showcase, list, discussion, link -- with avg score/comments per type
hook_patterns: question, number, bracket, emotional, personal, neutral -- with engagement metrics
timing_by_hour: UTC hours ranked by avg score
timing_by_day: days of week ranked by avg score
top_5_posts: highest scoring with title, score, and type classification
recommendations: actionable insights (best type, hook, time, day)

### Safety & Limits

Read-only: never posts, comments, votes, or interacts
Rate limited: jittered 3-8s delays between requests
OAuth: respects Reddit API 60 req/min limit
PullPush: historical archive, data may lag weeks/months behind real-time
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: hioliver933
- Version: 1.0.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-05-07T17:22:31.273Z
- Expires at: 2026-05-14T17:22:31.273Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/reddit-spy)
- [Send to Agent page](https://openagent3.xyz/skills/reddit-spy/agent)
- [JSON manifest](https://openagent3.xyz/skills/reddit-spy/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/reddit-spy/agent.md)
- [Download page](https://openagent3.xyz/downloads/reddit-spy)