search-reddit – OpenClaw Skill

---

name: search-reddit description: Search Reddit in real time using OpenAI web_search with enrichment (engagement + top comments). Use when you need recent Reddit threads, subreddit-filtered results, or quick link lists.

Search Reddit

Real-time Reddit search powered by OpenAI web_search with post enrichment (score, comments, and top comment excerpts).

Setup

Set your OpenAI API key:

clawdbot config set skills.entries.search-reddit.apiKey "sk-YOUR-KEY"

Or use environment variable:

export OPENAI_API_KEY="sk-YOUR-KEY"

You can also set a shared key:

clawdbot config set skills.entries.openai.apiKey "sk-YOUR-KEY"

Commands

Basic Search

node {baseDir}/scripts/search.js "Claude Code tips"

Filter by Time

node {baseDir}/scripts/search.js --days 7 "AI news"

Filter by Subreddit

node {baseDir}/scripts/search.js --subreddits machinelearning,openai "agents"
node {baseDir}/scripts/search.js --exclude bots "real discussions"

Output Options

node {baseDir}/scripts/search.js --json "topic"        # JSON results
node {baseDir}/scripts/search.js --compact "topic"     # Minimal output
node {baseDir}/scripts/search.js --links-only "topic"  # Only Reddit links

Example Usage in Chat

User: "Search Reddit for what people are saying about Claude Code" Action: Run search with query "Claude Code"

User: "Find posts in r/OpenAI from the last week" Action: Run search with --subreddits openai --days 7

User: "Get Reddit links about Kimi K2.5" Action: Run search with --links-only "Kimi K2.5"

How It Works

Uses OpenAI Responses API (/v1/responses) with the web_search tool:

• Allowed domain: reddit.com
• Enriches each thread by fetching Reddit JSON (/r/.../comments/.../.json)
• Updates the date from created_utc and filters to last N days
• Computes engagement and top comment excerpts

Environment Variables

• OPENAI_API_KEY - OpenAI API key (required)
• SEARCH_REDDIT_MODEL - Model override (default: gpt-5.2)
• SEARCH_REDDIT_DAYS - Default days to search (default: 30)

Search Reddit — Real-time Reddit Search for Clawdbot

Search Reddit in real-time using OpenAI's web_search tool. Results are enriched with engagement stats and top comment excerpts.

Installation

clawdhub install search-reddit

Or manually:

cd ~/clawd/skills && git clone https://github.com/mvanhorn/clawdbot-skill-search-reddit search-reddit

Setup

Get your API key from https://platform.openai.com, then:

clawdbot config set skills.entries.search-reddit.apiKey "sk-YOUR-KEY"

Or set environment variable:

export OPENAI_API_KEY="sk-YOUR-KEY"

You can also set a shared key:

clawdbot config set skills.entries.openai.apiKey "sk-YOUR-KEY"

Usage

Basic Search

node scripts/search.js "Claude Code tips"

Time Filter

node scripts/search.js --days 7 "breaking news"    # Last 7 days
node scripts/search.js --days 1 "trending today"   # Last 24 hours

Subreddit Filters

node scripts/search.js --subreddits machinelearning,openai "agents"
node scripts/search.js --exclude bots "real discussions"

Output Formats

node scripts/search.js --compact "topic"      # Minimal output
node scripts/search.js --links-only "topic"   # Just URLs
node scripts/search.js --json "topic"         # JSON results

Chat Examples

Just tell your Clawdbot:

• "Search Reddit for what people are saying about Claude"
• "Find posts in r/OpenAI from the last week"
• "Get Reddit links about Kimi K2.5"

How It Works

Uses OpenAI's Responses API with the web_search tool:

• Endpoint: /v1/responses
• Model: gpt-5.2 (default)
• Features: Date filtering, subreddit filtering, enrichment via Reddit JSON

Output Example

🔍 Searching Reddit: "Kimi K2.5" (last 7 days)...

**Kimi K2.5 impressions?**
r/MachineLearning • 2026-01-22
https://www.reddit.com/r/MachineLearning/comments/xxxxxx/...
Score: 231 • Comments: 82 • Upvote ratio: 0.92
Top comments:
- user1 (120): Interesting that...
- user2 (88): I tested it and...

📎 Links (3):
   https://www.reddit.com/r/MachineLearning/comments/xxxxxx/...

License

MIT