Reddit Researcher#

Search Reddit for posts and comments matching your keywords, extract insights and pain points.

Environment Variables#

VariableRequiredDefaultDescriptionREDDIT_SUBREDDITSNoallComma-separated list of subreddits (e.g., technology,programming)REDDIT_KEYWORDSYes—Comma-separated keywords to search forREDDIT_SEARCH_ENGINENobingSearch engine: bing, google, or reddit (direct JSON API)

Scripts#

scan.sh — Search Reddit#

Searches Reddit for posts matching keywords using DuckDuckGo.

bash

./scripts/scan.sh <keywords>

Output: List of Reddit post titles with URLs.

summarize.sh — Extract Pain Points#

Fetches Reddit posts and extracts common themes, complaints, and requests.

bash

./scripts/summarize.sh <post_urls_file>

Output: Markdown summary with pain points, desires, and patterns.

export.sh — Export Findings#

Exports all research findings to a markdown file with timestamp.

bash

./scripts/export.sh <summary_file>

Output: reddit-research-YYYY-MM-DD.md in the output directory.

Usage Example#

bash

export REDDIT_KEYWORDS="AI coding,ChatGPT,developer tools"
export REDDIT_SUBREDDITS="programming,technology,artificial"

# Search for posts
./scripts/scan.sh "$REDDIT_KEYWORDS" > posts.txt

# Summarize findings
./scripts/summarize.sh posts.txt

# Export results
./scripts/export.sh summary.md

Notes#

• Uses Bing as primary search engine, with Reddit JSON API and Google as fallbacks — designed to work even when DuckDuckGo blocks automated queries
• Set REDDIT_SEARCH_ENGINE=reddit for direct Reddit API access (no search engine needed)
• Respects rate limits; adds delays between requests
• Results cached in ~/.openclaw/workspace/skills/reddit-researcher/cache/
• Output format is Reddit markdown with proper link formatting