Search & ResearchDocumentedScanned

search-reddit

Search Reddit in real time using OpenAI web_search with enrichment (engagement + top comments).

Share:

Installation

npx clawhub@latest install search-reddit

View the full skill documentation and source below.

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_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)