{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/reddit-spy",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=reddit-spy",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "_meta.json",
      "requirements.txt",
      "scripts/lib/__init__.py",
      "scripts/lib/browser_stealth.py",
      "scripts/lib/cascade_fetcher.py"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "slug": "reddit-spy",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-08T02:16:15.851Z",
      "expiresAt": "2026-05-15T02:16:15.851Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=reddit-spy",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=reddit-spy",
        "contentDisposition": "attachment; filename=\"reddit-spy-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "reddit-spy"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/reddit-spy",
    "agentPageUrl": "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"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Reddit Spy -- Stealth Subreddit Intelligence",
        "body": "Browse any target subreddit, read full posts, analyze strategies, and extract competitive intelligence -- all without getting blocked by Reddit.\n\nEntry point:\n\npython3 /root/.openclaw/skills/reddit-spy/scripts/reddit_spy.py <command> [options]\n\nAll commands output JSON to stdout. Logs go to stderr."
      },
      {
        "title": "Setup",
        "body": "Tor (primary, already running):\nTor provides real-time Reddit access from any IP. It's running on this VPS as a systemd service.\n\n# Verify Tor is running\nsystemctl status tor@default\n\n# If stopped, start it\nsystemctl start tor@default\n\nOptional: Reddit OAuth (even more reliable):\nIf you have Reddit API access, set these env vars for 60 req/min:\n\nexport REDDIT_CLIENT_ID=\"your-app-client-id\"\nexport REDDIT_CLIENT_SECRET=\"your-app-secret\"\nexport REDDIT_USERNAME=\"your-reddit-username\"\nexport REDDIT_PASSWORD=\"your-reddit-password\"\n\nOptional: Proxy:\n\nexport REDDIT_PROXY_URL=\"http://user:pass@proxy:port\""
      },
      {
        "title": "Fetching Layers (Cascade Order)",
        "body": "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\n\nEach 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."
      },
      {
        "title": "spy -- Comprehensive Subreddit Intelligence",
        "body": "Full scan: about info + top posts + strategy analysis in one pass.\n\npython3 .../reddit_spy.py spy --subreddit IndieHackers --sort top --timeframe week --limit 25\n\nParamDefaultValues--subreddit(required)Subreddit name without r/--sorttophot, new, top, rising--timeframeweekhour, day, week, month, year, all--limit25Max posts to analyze\n\nReturns: about metrics, posts fetched, content type breakdown, hook patterns, timing analysis, top 5 posts, actionable recommendations."
      },
      {
        "title": "deep-read -- Full Post Deep Dive",
        "body": "Read complete post body + all nested comments with statistics.\n\npython3 .../reddit_spy.py deep-read --url \"https://www.reddit.com/r/.../comments/...\" --depth 8\n\nReturns: full post, flattened comment list (author, body, score, depth, is_op), comment stats."
      },
      {
        "title": "bulk-scan -- Multi-Subreddit Sweep",
        "body": "Scan multiple subreddits in one run with comparison.\n\npython3 .../reddit_spy.py bulk-scan --subreddits \"IndieHackers,SaaS,Entrepreneur\" --timeframe all --limit 20\n\nReturns: per-subreddit strategy analysis + cross-sub comparison (ranked by subscribers and engagement)."
      },
      {
        "title": "strategy -- Strategy Pattern Extraction",
        "body": "Extract what content strategies work best in a subreddit.\n\npython3 .../reddit_spy.py strategy --subreddit SaaS --sort top --timeframe month --limit 50\n\nReturns: content types ranked, hook patterns ranked, best posting hours/days, top 5 posts, recommendations."
      },
      {
        "title": "search -- Keyword Search",
        "body": "Search within a subreddit for specific topics.\n\npython3 .../reddit_spy.py search --subreddit IndieHackers --query \"growth strategy\" --sort top --timeframe month"
      },
      {
        "title": "user-intel -- User Profile Analysis",
        "body": "Analyze a Reddit user's posting patterns across subreddits.\n\npython3 .../reddit_spy.py user-intel --username some_user --limit 25\n\nReturns: total posts, subreddit distribution, content patterns, hook analysis."
      },
      {
        "title": "health-check -- Test Layers",
        "body": "Test which fetching layers are currently working.\n\npython3 .../reddit_spy.py health-check --test-sub python"
      },
      {
        "title": "Step 1: Health check",
        "body": "python3 .../reddit_spy.py health-check\n\nVerify which layers are operational before starting analysis."
      },
      {
        "title": "Step 2: Bulk scan targets",
        "body": "python3 .../reddit_spy.py bulk-scan --subreddits \"IndieHackers,SaaS,Entrepreneur,Automation\" --timeframe week --limit 25"
      },
      {
        "title": "Step 3: Deep-dive top posts",
        "body": "Pick high-scoring posts from Step 2 and read full content + comments:\n\npython3 .../reddit_spy.py deep-read --url \"https://reddit.com/r/.../comments/...\""
      },
      {
        "title": "Step 4: Profile top contributors",
        "body": "python3 .../reddit_spy.py user-intel --username top_poster"
      },
      {
        "title": "Step 5: Search for topic gaps",
        "body": "python3 .../reddit_spy.py search --subreddit IndieHackers --query \"automation\" --sort top"
      },
      {
        "title": "Strategy Analysis Output",
        "body": "The spy, bulk-scan, and strategy commands return:\n\ncontent_types: question, how-to, tip, showcase, list, discussion, link -- with avg score/comments per type\nhook_patterns: question, number, bracket, emotional, personal, neutral -- with engagement metrics\ntiming_by_hour: UTC hours ranked by avg score\ntiming_by_day: days of week ranked by avg score\ntop_5_posts: highest scoring with title, score, and type classification\nrecommendations: actionable insights (best type, hook, time, day)"
      },
      {
        "title": "Safety & Limits",
        "body": "Read-only: never posts, comments, votes, or interacts\nRate limited: jittered 3-8s delays between requests\nOAuth: respects Reddit API 60 req/min limit\nPullPush: historical archive, data may lag weeks/months behind real-time"
      }
    ],
    "body": "Reddit Spy -- Stealth Subreddit Intelligence\n\nBrowse any target subreddit, read full posts, analyze strategies, and extract competitive intelligence -- all without getting blocked by Reddit.\n\nEntry point:\n\npython3 /root/.openclaw/skills/reddit-spy/scripts/reddit_spy.py <command> [options]\n\n\nAll commands output JSON to stdout. Logs go to stderr.\n\nSetup\n\nTor (primary, already running): Tor provides real-time Reddit access from any IP. It's running on this VPS as a systemd service.\n\n# Verify Tor is running\nsystemctl status tor@default\n\n# If stopped, start it\nsystemctl start tor@default\n\n\nOptional: Reddit OAuth (even more reliable): If you have Reddit API access, set these env vars for 60 req/min:\n\nexport REDDIT_CLIENT_ID=\"your-app-client-id\"\nexport REDDIT_CLIENT_SECRET=\"your-app-secret\"\nexport REDDIT_USERNAME=\"your-reddit-username\"\nexport REDDIT_PASSWORD=\"your-reddit-password\"\n\n\nOptional: Proxy:\n\nexport REDDIT_PROXY_URL=\"http://user:pass@proxy:port\"\n\nFetching Layers (Cascade Order)\nLayer\tMethod\tSpeed\tData\tStatus\n1. OAuth API\tReddit API v2\tFast\tFull real-time\tOptional (needs API key)\n2. Tor\tSOCKS5 via Tor exit nodes\tFast\tFull real-time\tACTIVE -- primary layer\n3. Stealth HTTP\told.reddit.com direct\tFast\tFull real-time\tBlocked on VPS IPs\n4. Browser Stealth\tPlaywright\tSlow\tFull real-time\tBlocked on VPS IPs\n5. PullPush\tArchive API\tFast\tHistorical (may lag)\tAlways works\n\nEach 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.\n\nCommands\nspy -- Comprehensive Subreddit Intelligence\n\nFull scan: about info + top posts + strategy analysis in one pass.\n\npython3 .../reddit_spy.py spy --subreddit IndieHackers --sort top --timeframe week --limit 25\n\nParam\tDefault\tValues\n--subreddit\t(required)\tSubreddit name without r/\n--sort\ttop\thot, new, top, rising\n--timeframe\tweek\thour, day, week, month, year, all\n--limit\t25\tMax posts to analyze\n\nReturns: about metrics, posts fetched, content type breakdown, hook patterns, timing analysis, top 5 posts, actionable recommendations.\n\ndeep-read -- Full Post Deep Dive\n\nRead complete post body + all nested comments with statistics.\n\npython3 .../reddit_spy.py deep-read --url \"https://www.reddit.com/r/.../comments/...\" --depth 8\n\n\nReturns: full post, flattened comment list (author, body, score, depth, is_op), comment stats.\n\nbulk-scan -- Multi-Subreddit Sweep\n\nScan multiple subreddits in one run with comparison.\n\npython3 .../reddit_spy.py bulk-scan --subreddits \"IndieHackers,SaaS,Entrepreneur\" --timeframe all --limit 20\n\n\nReturns: per-subreddit strategy analysis + cross-sub comparison (ranked by subscribers and engagement).\n\nstrategy -- Strategy Pattern Extraction\n\nExtract what content strategies work best in a subreddit.\n\npython3 .../reddit_spy.py strategy --subreddit SaaS --sort top --timeframe month --limit 50\n\n\nReturns: content types ranked, hook patterns ranked, best posting hours/days, top 5 posts, recommendations.\n\nsearch -- Keyword Search\n\nSearch within a subreddit for specific topics.\n\npython3 .../reddit_spy.py search --subreddit IndieHackers --query \"growth strategy\" --sort top --timeframe month\n\nuser-intel -- User Profile Analysis\n\nAnalyze a Reddit user's posting patterns across subreddits.\n\npython3 .../reddit_spy.py user-intel --username some_user --limit 25\n\n\nReturns: total posts, subreddit distribution, content patterns, hook analysis.\n\nhealth-check -- Test Layers\n\nTest which fetching layers are currently working.\n\npython3 .../reddit_spy.py health-check --test-sub python\n\nRadar's Intelligence Workflow\nStep 1: Health check\npython3 .../reddit_spy.py health-check\n\n\nVerify which layers are operational before starting analysis.\n\nStep 2: Bulk scan targets\npython3 .../reddit_spy.py bulk-scan --subreddits \"IndieHackers,SaaS,Entrepreneur,Automation\" --timeframe week --limit 25\n\nStep 3: Deep-dive top posts\n\nPick high-scoring posts from Step 2 and read full content + comments:\n\npython3 .../reddit_spy.py deep-read --url \"https://reddit.com/r/.../comments/...\"\n\nStep 4: Profile top contributors\npython3 .../reddit_spy.py user-intel --username top_poster\n\nStep 5: Search for topic gaps\npython3 .../reddit_spy.py search --subreddit IndieHackers --query \"automation\" --sort top\n\nStrategy Analysis Output\n\nThe spy, bulk-scan, and strategy commands return:\n\ncontent_types: question, how-to, tip, showcase, list, discussion, link -- with avg score/comments per type\nhook_patterns: question, number, bracket, emotional, personal, neutral -- with engagement metrics\ntiming_by_hour: UTC hours ranked by avg score\ntiming_by_day: days of week ranked by avg score\ntop_5_posts: highest scoring with title, score, and type classification\nrecommendations: actionable insights (best type, hook, time, day)\nSafety & Limits\nRead-only: never posts, comments, votes, or interacts\nRate limited: jittered 3-8s delays between requests\nOAuth: respects Reddit API 60 req/min limit\nPullPush: historical archive, data may lag weeks/months behind real-time"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/hioliver933/reddit-spy",
    "publisherUrl": "https://clawhub.ai/hioliver933/reddit-spy",
    "owner": "hioliver933",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}