A read-only Reddit scraper for AI agents that allows searching and browsing subreddits via the public JSON API without an API key.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install reddit-scraper
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install reddit-scraper using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Reddit?
The Reddit skill for Clawdbot provides a lightweight and efficient way for AI agents to access community-driven data. By utilizing the public JSON API via old.reddit.com, this skill enables seamless browsing of subreddits, topic searching, and community monitoring. It is a core component within the Openclaw Skills ecosystem, designed for developers who need to feed real-world discussions and technical threads into their AI workflows without the overhead of complex OAuth configurations or API key management.
This skill is strictly read-only, ensuring a safe and non-intrusive way for agents to gather information. Whether you are tracking the latest developments in AI or looking for troubleshooting steps in technical forums, this skill translates Reddit's unstructured conversations into structured data that agents can easily interpret.
Reddit Use Cases
- Gathering community sentiment and feedback on specific software or libraries.
- Monitoring niche subreddits for the latest news and emerging trends.
- Extracting technical troubleshooting steps and user-documented solutions.
- Aggregating daily top posts from multiple communities for automated research summaries.
How Reddit Works
- The AI agent or user executes the scraper script with specific flags such as --subreddit or --search.
- The skill sends a request to Reddit's public JSON endpoints, bypassing the need for traditional authentication.
- The scraper retrieves the requested data, applying filters for sorting (e.g., hot, new, top) and time ranges.
- The results are parsed and returned as structured output, allowing the agent to process post titles, text, and metadata.
Reddit Setup
To begin using this skill within the Openclaw Skills framework, ensure the script is accessible in your environment. You can test the installation by running:
# Fetch the top 5 posts from a specific subreddit
python3 /root/clawd/skills/reddit/scripts/reddit_scraper.py --subreddit LocalLLaMA --limit 5
# Search all of Reddit for a specific term
python3 /root/clawd/skills/reddit/scripts/reddit_scraper.py --search "Openclaw Skills" --limit 5
Reddit Data Schema & Taxonomy
The skill returns a structured dataset for each post. When using the --json flag, the following fields are available:
| Field | Description |
|---|---|
| title | The title of the post |
| author | The Reddit username of the poster |
| score | The net upvote count |
| num_comments | Total number of comments on the thread |
| url | The direct link to the content or external resource |
| permalink | The relative URL to the Reddit discussion |
| subreddit | The name of the subreddit where the post resides |
| created_utc | Unix timestamp of post creation |
| selftext | A snippet of the post body (first 200 characters) |
| upvote_ratio | The percentage of upvotes relative to total votes |
Reddit Advanced Features
- Global search capability to find mentions and topics across the entire Reddit platform.
- Granular sorting options including hot, new, top, rising, and controversial (populares/nuevos).
- Temporal filtering to narrow down results by hour, day, week, month, year, or all-time.
- Verbose mode for previewing post content directly within the CLI output.
- JSON output format to facilitate data piping between different Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
DingTalk Calendar Management
An AI-powered skill to manage DingTalk calendars, attendee status, and meeting room reservations via the mcporter CLI.
i18n for Next.js
A comprehensive implementation guide and toolset for full internationalization (i18n) and localized SEO in Next.js App Router applications.
2slides
An AI-powered skill for generating professional presentations and slide decks from text content, documents, or reference images via the 2slides API.
Powerdrill Data Analysis
A sophisticated data exploration skill that uses the Powerdrill API to transform raw files into interactive insights, charts, and tables via natural language.
Sound FX (ElevenLabs)
A high-performance utility for generating custom sound effects from text prompts using the ElevenLabs API.
VibeVoice TTS
A high-performance, local text-to-speech engine optimized for Spanish voice synthesis and mobile messaging.
Featured*
