search-reddit

# 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:

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

Or use environment variable:
```bash
export OPENAI_API_KEY="sk-YOUR-KEY"
```

You can also set a shared key:
```bash
clawdbot config set skills.entries.openai.apiKey "sk-YOUR-KEY"
```

## Commands

### Basic Search
```bash
node {baseDir}/scripts/search.js "Claude Code tips"
```

### Filter by Time
```bash
node {baseDir}/scripts/search.js --days 7 "AI news"
```

### Filter by Subreddit
```bash
node {baseDir}/scripts/search.js --subreddits machinelearning,openai "agents"
node {baseDir}/scripts/search.js --exclude bots "real discussions"
```

### Output Options
```bash
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

```bash
clawdhub install search-reddit
```

Or manually:
```bash
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:

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

Or set environment variable:
```bash
export OPENAI_API_KEY="sk-YOUR-KEY"
```

You can also set a shared key:
```bash
clawdbot config set skills.entries.openai.apiKey "sk-YOUR-KEY"
```

## Usage

### Basic Search
```bash
node scripts/search.js "Claude Code tips"
```

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

### Subreddit Filters
```bash
node scripts/search.js --subreddits machinelearning,openai "agents"
node scripts/search.js --exclude bots "real discussions"
```

### Output Formats
```bash
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)...