reddit-problem-finder

reddit-problem-finder is a local, read-only OpenClaw skill package for turning sanitized Reddit threads into ranked SaaS/problem opportunity briefs.

It is intentionally fixture-first:

• Required path: analyze user-provided Reddit JSON fixtures offline.
• Optional path: wire in approved Reddit API credentials later, behind explicit opt-in.
• Default posture: no scraping, no posting, no outreach, no sensitive-community profiling.

What it builds

• Complaint/workaround/money-talk extraction from Reddit post and comment fixtures
• Deterministic keyword clustering without heavy ML dependencies
• Weighted scoring for pain intensity, recurrence, monetization, and feasibility
• Markdown and JSON reports written to runs/<run-id>/

Policy notes

• Official Reddit API only for any future live collection.
• Live collection is disabled by default and emits warnings unless explicitly enabled.
• The implementation is read-only and never posts, comments, messages, or automates outreach.
• NSFW, private, quarantined, and sensitive communities are blocked by default.
• Output redacts usernames and skips deleted/removed content.

See references/reddit-policy-notes.md for the packaged policy guidance.

Install

python3 -m pip install -r requirements.txt

Commands

make test
make lint
make sample-run

Direct CLI usage:

python3 scripts/reddit_problem_finder.py analyze \
  --input tests/fixtures/reddit/freelance-operations.json \
  --query "freelance operations"

The run creates:

• runs/<run-id>/report.md
• runs/<run-id>/opportunities.json

Live API status

The repo includes safe stubs for future approved Reddit API access. They are intentionally conservative:

• require explicit --use-live-api
• require REDDIT_ENABLE_LIVE_API=true
• require credentials in the environment
• return warnings and no collected data when the safety checks are not satisfied

Layout

• SKILL.md
• scripts/reddit_problem_finder.py
• scripts/lib/
• tests/