Skill

reddit-2

From sundial-org-awesome-openclaw-skills-4

Reads and searches Reddit posts from subreddits via public JSON API using Python CLI script. Supports sorting by hot/new/top, time filters, JSON output for titles, scores, comments, monitoring communities.

Python

Bash

cli-tools

automation

Install

npx claudepluginhub joshuarweaver/cascade-ai-ml-agents-misc-2 --plugin sundial-org-awesome-openclaw-skills-4

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Read and search Reddit posts using the public JSON API. No API key required.

Supporting Assets

references/TECHNICAL.mdscripts/reddit_scraper.py

SKILL.md

Similar Skills

cache-components

Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.

cache-components

139.2k

mcp-builder

9 files

Guides building MCP servers enabling LLMs to interact with external services via tools. Covers best practices, TypeScript/Node (MCP SDK), Python (FastMCP).

anthropics-skills-13

124.2k

canvas-design

20 files

Generates original PNG/PDF visual art via design philosophy manifestos for posters, graphics, and static designs on user request.

anthropics-skills-13

124.2k

Stats

Stars586

Forks75

Last CommitFeb 1, 2026

Actions

View Source View Plugin View on GitHub View README

Reddit Skill 📰

Read and search Reddit posts using the public JSON API. No API key required.

Quick Start

# Read top posts from a subreddit
python3 /root/clawd/skills/reddit/scripts/reddit_scraper.py --subreddit LocalLLaMA --limit 5

# Search for posts
python3 /root/clawd/skills/reddit/scripts/reddit_scraper.py --search "clawdbot" --limit 5

# Read newest posts
python3 /root/clawd/skills/reddit/scripts/reddit_scraper.py --subreddit ClaudeAI --sort nuevos --limit 5

Options

Option	Short	Description	Default
`--subreddit`	`-s`	Subreddit name (without r/)	-
`--search`	`-q`	Search query	-
`--sort`	-	Sort: hot, new, top, populares, nuevos, rising	top
`--time`	`-t`	Time filter: hour, day, week, month, year, all	day
`--limit`	`-n`	Number of posts (max 100)	25
`--json`	`-j`	Output as JSON	false
`--verbose`	`-v`	Show post preview text	false

Examples

Read subreddit posts

# Top posts of the day (default)
python3 /root/clawd/skills/reddit/scripts/reddit_scraper.py --subreddit programming

# Hot posts
python3 /root/clawd/skills/reddit/scripts/reddit_scraper.py --subreddit programming --sort hot

# New posts
python3 /root/clawd/skills/reddit/scripts/reddit_scraper.py --subreddit programming --sort nuevos

# Top posts of the week
python3 /root/clawd/skills/reddit/scripts/reddit_scraper.py --subreddit programming --sort top --time week

Search posts

# Search all of Reddit
python3 /root/clawd/skills/reddit/scripts/reddit_scraper.py --search "machine learning"

# Search within a subreddit
python3 /root/clawd/skills/reddit/scripts/reddit_scraper.py --subreddit selfhosted --search "docker"

# Search with time filter
python3 /root/clawd/skills/reddit/scripts/reddit_scraper.py --search "AI news" --time week

JSON output

# Get raw JSON data for processing
python3 /root/clawd/skills/reddit/scripts/reddit_scraper.py --subreddit technology --limit 3 --json

Output Fields (JSON)

title: Post title
author: Username
score: Upvotes (net)
num_comments: Comment count
url: Link URL
permalink: Reddit discussion URL
subreddit: Subreddit name
created_utc: Unix timestamp
selftext: Post text (first 200 chars)
upvote_ratio: Upvote percentage (0-1)

Limitations

Read-only: Cannot post, comment, or vote
Rate limits: Reddit may rate-limit if too many requests
No auth: Some content may be restricted

Technical Details

See TECHNICAL.md for implementation details.