Search Reddit

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.

Security Scan

The skill largely does what it says (search Reddit and enrich results), but the package/registry metadata omits that it requires an OpenAI API key and the script reads your Clawdbot config (~/.clawdbot/clawdbot.json) to find keys — this mismatch and undeclared config access are concerning and should be clarified before install.

Purpose & Capability

The name/description (real-time Reddit search + enrichment) aligns with the included script, which calls OpenAI's Responses API web_search and fetches Reddit JSON to compute engagement and top comments. However, registry metadata lists no required environment variables while the SKILL.md and script require an OpenAI API key — an inconsistency between declared requirements and actual needs.

Instruction Scope

SKILL.md instructs the agent to use OpenAI web_search, then enrich returned Reddit thread URLs by fetching Reddit JSON. The runtime instructions and the code remain focused on the stated goal and do not request unrelated filesystem or network targets beyond reading the clawdbot config and calling OpenAI/reddit endpoints.

Install Mechanism

There is no install spec (instruction-only) and no remote download during install. A local Node script is included; executing it requires node but nothing in the install flow pulls arbitrary remote archives. This is a lower install-risk posture.

Credentials

The skill requires an OpenAI API key (OPENAI_API_KEY) per SKILL.md and the script, but the registry metadata declares no required env vars/primary credential — that's a mismatch. The script also attempts to read ~/.clawdbot/clawdbot.json for stored keys, which is reasonable for convenience but is not declared in the registry and grants the skill read access to a local config file (potentially containing other keys). No other unrelated credentials are requested.

Persistence & Privilege

The skill is not set always:true, does not request elevated or persistent platform-wide privileges, and does not modify other skills' config. Its only persistent behavior is reading the user's clawdbot config file for an API key, which is expected for convenience but should be documented.

What to consider before installing

Before installing: 1) Note that the skill requires your OpenAI API key (OPENAI_API_KEY) even though the registry metadata doesn't declare it — the SKILL.md and script expect it. 2) Review the script (scripts/search.js) yourself; it will read ~/.clawdbot/clawdbot.json if present to find saved keys, so ensure that file doesn't contain unrelated secrets you don't want exposed to this skill. 3) The script only calls api.openai.com and reddit.com; if that is acceptable, run it in a controlled environment and consider creating a dedicated OpenAI key with limited scope/usage tracking. 4) Ask the publisher to update the registry metadata to declare OPENAI_API_KEY (and the config file usage) so required permissions are explicit. If you cannot inspect the code or cannot limit the API key, do not install.

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)