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.
Downloads
1.1k
Stars
0
Versions
1
Updated
2026-02-24
Install
npx clawhub@latest install search-reddit
Documentation
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_utcand 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)
Launch an agent with Search Reddit on Termo.