{"skill":{"slug":"reddit-readonly","displayName":"Reddit (read only - no auth)","summary":"Browse and search Reddit in read-only mode using public JSON endpoints. Use when the user asks to browse subreddits, search for posts by topic, inspect comment threads, or build a shortlist of links to review and reply to manually.","description":"---\nname: reddit-readonly\ndescription: >-\n  Browse and search Reddit in read-only mode using public JSON endpoints.\n  Use when the user asks to browse subreddits, search for posts by topic,\n  inspect comment threads, or build a shortlist of links to review and reply to manually.\nmetadata: {\"clawdbot\":{\"emoji\":\"🔎\",\"requires\":{\"bins\":[\"node\"]}}}\n---\n\n# Reddit Readonly\n\nRead-only Reddit browsing for Clawdbot.\n\n## What this skill is for\n\n- Finding posts in one or more subreddits (hot/new/top/controversial/rising)\n- Searching for posts by query (within a subreddit or across all)\n- Pulling a comment thread for context\n- Producing a *shortlist of permalinks* so the user can open Reddit and reply manually\n\n## Hard rules\n\n- **Read-only only.** This skill never posts, replies, votes, or moderates.\n- Be polite with requests:\n  - Prefer small limits (5–10) first.\n  - Expand only if needed.\n- When returning results to the user, always include **permalinks**.\n\n## Output format\n\nAll commands print JSON to stdout.\n\n- Success: `{ \"ok\": true, \"data\": ... }`\n- Failure: `{ \"ok\": false, \"error\": { \"message\": \"...\", \"details\": \"...\" } }`\n\n## Commands\n\n### 1) List posts in a subreddit\n\n```bash\nnode {baseDir}/scripts/reddit-readonly.mjs posts <subreddit> \\\n  --sort hot|new|top|controversial|rising \\\n  --time day|week|month|year|all \\\n  --limit 10 \\\n  --after <token>\n```\n\n### 2) Search posts\n\n```bash\n# Search within a subreddit\nnode {baseDir}/scripts/reddit-readonly.mjs search <subreddit> \"<query>\" --limit 10\n\n# Search all of Reddit\nnode {baseDir}/scripts/reddit-readonly.mjs search all \"<query>\" --limit 10\n```\n\n### 3) Get comments for a post\n\n```bash\n# By post id or URL\nnode {baseDir}/scripts/reddit-readonly.mjs comments <post_id|url> --limit 50 --depth 6\n```\n\n### 4) Recent comments across a subreddit\n\n```bash\nnode {baseDir}/scripts/reddit-readonly.mjs recent-comments <subreddit> --limit 25\n```\n\n### 5) Thread bundle (post + comments)\n\n```bash\nnode {baseDir}/scripts/reddit-readonly.mjs thread <post_id|url> --commentLimit 50 --depth 6\n```\n\n### 6) Find opportunities (multi-subreddit helper)\n\nUse this when the user describes criteria like:\n\"Find posts about X in r/a, r/b, and r/c posted in the last 48 hours, excluding Y\".\n\n```bash\nnode {baseDir}/scripts/reddit-readonly.mjs find \\\n  --subreddits \"python,learnpython\" \\\n  --query \"fastapi deployment\" \\\n  --include \"docker,uvicorn,nginx\" \\\n  --exclude \"homework,beginner\" \\\n  --minScore 2 \\\n  --maxAgeHours 48 \\\n  --perSubredditLimit 25 \\\n  --maxResults 10 \\\n  --rank new\n```\n\n## Suggested agent workflow\n\n1. **Clarify scope** if needed: subreddits + topic keywords + timeframe.\n2. Start with `find` (or `posts`/`search`) using small limits.\n3. For 1–3 promising items, fetch context via `thread`.\n4. Present the user a shortlist:\n   - title, subreddit, score, created time\n   - permalink\n   - a brief reason why it matched\n5. If asked, propose *draft reply ideas* in natural language, but remind the user to post manually.\n\n## Troubleshooting\n\n- If Reddit returns HTML, re-run the command (the script detects this and returns an error).\n- If requests fail repeatedly, reduce `--limit` and/or set slower pacing via env vars:\n\n```bash\nexport REDDIT_RO_MIN_DELAY_MS=800\nexport REDDIT_RO_MAX_DELAY_MS=1800\nexport REDDIT_RO_TIMEOUT_MS=25000\nexport REDDIT_RO_USER_AGENT='script:clawdbot-reddit-readonly:v1.0.0 (personal)'\n```\n","tags":{"latest":"1.0.0"},"stats":{"comments":8,"downloads":17707,"installsAllTime":134,"installsCurrent":134,"stars":42,"versions":1},"createdAt":1770050502449,"updatedAt":1778485994101},"latestVersion":{"version":"1.0.0","createdAt":1770050502449,"changelog":"- Initial public release.\n- Enables read-only browsing and searching of Reddit using public JSON endpoints.\n- Supports subreddit post listings, post and comment searches, comment/thread fetching, and constructing shortlists of permalinks.\n- Strictly read-only: never posts, replies, votes, or moderates.\n- All commands output standardized JSON for easy parsing and error handling.\n- Includes multi-subreddit search helper for complex criteria-based discovery.","license":null},"metadata":{"setup":[],"os":null,"systems":null},"owner":{"handle":"buksan1950","userId":"s17cze1nkwbyn4te0k1zanqrws884592","displayName":"buksan1950","image":"https://avatars.githubusercontent.com/u/48475739?v=4"},"moderation":null}