{"skill":{"slug":"reddit-scraper","displayName":"Reddit Scraper","summary":"Read and search Reddit posts via web scraping of old.reddit.com. Use when Clawdbot needs to browse Reddit content - read posts from subreddits, search for topics, monitor specific communities. Read-only access with no posting or comments.","description":"---\nname: reddit\ndescription: \"Read and search Reddit posts via web scraping of old.reddit.com. Use when Clawdbot needs to browse Reddit content - read posts from subreddits, search for topics, monitor specific communities. Read-only access with no posting or comments.\"\n---\n\n# Reddit Skill 📰\n\nRead and search Reddit posts using the public JSON API. No API key required.\n\n## Quick Start\n\n```bash\n# Read top posts from a subreddit\npython3 /root/clawd/skills/reddit/scripts/reddit_scraper.py --subreddit LocalLLaMA --limit 5\n\n# Search for posts\npython3 /root/clawd/skills/reddit/scripts/reddit_scraper.py --search \"clawdbot\" --limit 5\n\n# Read newest posts\npython3 /root/clawd/skills/reddit/scripts/reddit_scraper.py --subreddit ClaudeAI --sort nuevos --limit 5\n```\n\n## Options\n\n| Option | Short | Description | Default |\n|--------|-------|-------------|---------|\n| `--subreddit` | `-s` | Subreddit name (without r/) | - |\n| `--search` | `-q` | Search query | - |\n| `--sort` | - | Sort: hot, new, top, populares, nuevos, rising | top |\n| `--time` | `-t` | Time filter: hour, day, week, month, year, all | day |\n| `--limit` | `-n` | Number of posts (max 100) | 25 |\n| `--json` | `-j` | Output as JSON | false |\n| `--verbose` | `-v` | Show post preview text | false |\n\n## Examples\n\n### Read subreddit posts\n```bash\n# Top posts of the day (default)\npython3 /root/clawd/skills/reddit/scripts/reddit_scraper.py --subreddit programming\n\n# Hot posts\npython3 /root/clawd/skills/reddit/scripts/reddit_scraper.py --subreddit programming --sort hot\n\n# New posts\npython3 /root/clawd/skills/reddit/scripts/reddit_scraper.py --subreddit programming --sort nuevos\n\n# Top posts of the week\npython3 /root/clawd/skills/reddit/scripts/reddit_scraper.py --subreddit programming --sort top --time week\n```\n\n### Search posts\n```bash\n# Search all of Reddit\npython3 /root/clawd/skills/reddit/scripts/reddit_scraper.py --search \"machine learning\"\n\n# Search within a subreddit\npython3 /root/clawd/skills/reddit/scripts/reddit_scraper.py --subreddit selfhosted --search \"docker\"\n\n# Search with time filter\npython3 /root/clawd/skills/reddit/scripts/reddit_scraper.py --search \"AI news\" --time week\n```\n\n### JSON output\n```bash\n# Get raw JSON data for processing\npython3 /root/clawd/skills/reddit/scripts/reddit_scraper.py --subreddit technology --limit 3 --json\n```\n\n## Output Fields (JSON)\n\n- `title`: Post title\n- `author`: Username\n- `score`: Upvotes (net)\n- `num_comments`: Comment count\n- `url`: Link URL\n- `permalink`: Reddit discussion URL\n- `subreddit`: Subreddit name\n- `created_utc`: Unix timestamp\n- `selftext`: Post text (first 200 chars)\n- `upvote_ratio`: Upvote percentage (0-1)\n\n## Limitations\n\n- **Read-only**: Cannot post, comment, or vote\n- **Rate limits**: Reddit may rate-limit if too many requests\n- **No auth**: Some content may be restricted\n\n## Technical Details\n\nSee [TECHNICAL.md](references/TECHNICAL.md) for implementation details.\n","tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":6177,"installsAllTime":38,"installsCurrent":37,"stars":8,"versions":1},"createdAt":1769552693110,"updatedAt":1778485863829},"latestVersion":{"version":"1.0.0","createdAt":1769552693110,"changelog":"Initial release: JSON API, search, short links, flairs","license":null},"metadata":null,"owner":{"handle":"javicasper","userId":"s171w9v69dx5sgs4hdw2bcjj55885w1n","displayName":"javicasper","image":"https://avatars.githubusercontent.com/u/96118421?v=4"},"moderation":null}