alex-jb

Customer Discovery Agent — Development skill for Claude Code

Development community

Reddit pain-point scraper + Claude clustering with structured outputs.

How to install Customer Discovery Agent

This entry records only its repository, not the path inside it, so there is no exact command to give. Open alex-jb/customer-discovery-agent and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Customer Discovery Agent does

Reddit pain-point scraper + Claude clustering with structured outputs. Find what users actually complain about. pip · MCP · MIT.

Alternatives in Development

Reddit Fetch — Fetches Reddit content via Gemini CLI when WebFetch is blocked or returns 403 errors 6.5k ★
Claude Context Mode — An MCP server that sits between Claude Code and these outputs 5.3k ★
Last30days Skill — Claude Code skill that researches any topic across Reddit + X from the last 30 days, then writes copy-paste-re 4.4k ★

README

customer-discovery-agent

**English** | [中文](README.zh-CN.md)

Scan online communities for **maker pain points**. Cluster into themes. Get a weekly digest of what your future users are actually frustrated about.

[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE) [![PyPI](https://img.shields.io/pypi/v/customer-discovery-agent.svg)](https://pypi.org/project/customer-discovery-agent/) [![Python](https://img.shields.io/badge/python-3.10%2B-blue.svg)](#) [![Tests](https://img.shields.io/badge/tests-13%20passing-brightgreen.svg)](#) [![Sources](https://img.shields.io/badge/sources-Reddit_(v0.1)-FF4500.svg)](#)

Built by [Alex Ji](https://github.com/alex-jb) — solo founder shipping [VibeXForge](https://vibexforge.com), [Orallexa](https://github.com/alex-jb/orallexa-ai-trading-agent), and [marketing-agent](https://github.com/alex-jb/orallexa-marketing-agent). Born from this thought:

*I keep guessing what indie makers actually need. Reddit knows.*

What it does

customer-discovery-agent scan \
  --subreddits SaaS IndieHackers SideProject Entrepreneur \
  --hours 168 \
  --out digest.md

For each enabled subreddit, the agent:

Pulls top + new posts in the last --hours window
Filters by pain-pattern keywords (default: 17 phrases like "i wish", "frustrated", "is there a tool", "struggle with")
Sends matches to Claude Haiku for theme clustering (3-7 clusters)
Renders a markdown digest with representative quotes + sample URLs

Without `ANTHROPIC_API_KEY`, falls back to deterministic keyword-based clustering — still useful, just less coherent.

Sample output

# Customer Discovery Digest

*Window: last 168h · Sources: reddit*
*Pain points scanned: 47 · Clusters: 5*

## Top themes

### Founders frustrated with Vercel build minutes

**8 posts · avg score 42.5**

> $130 in build minutes this month, half from failed type-check pushes

Sample posts:
- https://reddit.com/r/SaaS/comments/...
- https