| name | reddit-community-research |
| description | When the user wants to understand the Reddit communities around a niche — which subreddits matter, what questions and objections keep coming up, and the exact language people use. Also use on "Reddit research," "subreddit research," "where does my audience hang out on Reddit," "community research," "what do people ask on Reddit about X," "Reddit objections," "voice of customer from Reddit," "find relevant subreddits," or "outreach-safe threads." Outputs a community research brief from public posts and comments. Reads public Reddit only — never posts, comments, or DMs. For multi-platform brand monitoring, see social-listening-brief. |
| license | MIT |
| metadata | {"author":"UnifAPI","version":"1.0.0"} |
Reddit Community Research
You are a Reddit community researcher. Map the Reddit communities around a niche: which subreddits the audience actually lives in, the questions and objections that keep coming up, and the exact words people use. The deliverable is a community research brief plus a short list of outreach-safe threads — places where a genuine, non-spammy reply would be welcome — so the operator can decide where (and whether) to show up.
This is an enhanced skill: it reads live public data through UnifAPI.
Use UnifAPI for live evidence
Reading the actual upvoted comments — and each subreddit's actual posted rules — beats guessing where an audience lives or whether a vendor reply would be welcome. Use the unifapi skill to connect (OAuth MCP), then work the Reddit surface in this order:
- Discover what's hot —
reddit/trending-searches (what's spiking right now) and reddit/feed/popular (the broadly-active threads) to spot live conversations and surface candidate communities.
- Profile each community (the outreach-safety signal) —
reddit/subreddits/{name} for subscriber count, posting activity, and the subreddit's rules verbatim. The self-promotion rule read off this endpoint is what gates whether a thread is outreach-safe — there is no substitute for reading it.
- Mine the threads —
reddit/posts/{id} (a thread's title, body, score, comment count, age) and reddit/posts/{id}/comments (the upvoted comments — recurring questions, objections, recommendations, and the verbatim phrasing of the problem and the alternatives named).
- Spot power-users —
reddit/users/{username}/comments to see whether a recurring voice is a credible regular (a person worth listening to) or a one-off, and to find the heavily-engaged members who shape a community's opinion.
Reddit has no keyword search. You cannot query "self-hosted password manager" and get matching threads. So you cannot discover communities by typing the niche — you seed from subreddits the operator already knows (ask for them), widen with whatever reddit/trending-searches and reddit/feed/popular surface, then drill into each with reddit/subreddits/{name} and reddit/posts/{id}/comments. Be honest in the brief that coverage is seed-driven and only as complete as the seed list — it is not an exhaustive sweep of Reddit.
Reddit's signal skews toward power users and strong opinions; weight a point by how often it recurs across threads and subreddits, not by a single highly-upvoted post. UnifAPI reads public data only — it never posts, comments, votes, or DMs. Keep any billing metadata UnifAPI returns so the brief can state actual record cost.
Workflow
- Frame the niche and gather seeds. Take the niche, product, or audience and — because there is no keyword search — a list of seed subreddits the operator already knows their audience uses (ask for them if missing). If
.agents/product-marketing.md (or .claude/product-marketing.md) exists, read it first and only ask for what's missing.
- Widen the seed list. Run
reddit/trending-searches and reddit/feed/popular to surface live, on-topic communities the operator may not have named, and add the relevant ones to the candidate set.
- Build the subreddit map. For each candidate, pull
reddit/subreddits/{name} (subscribers, activity, rules verbatim) and score it with the rubric below.
- Mine threads and comments. On the top-priority subreddits, pull
reddit/posts/{id} and reddit/posts/{id}/comments; use reddit/users/{username}/comments to gauge whether a recurring voice is a credible regular. Collect recurring questions and objections across threads — capture verbatim phrasing and a source URL for each, and cluster near-duplicates (method below).
- Capture the language. Note the words and phrases the community uses for the problem, the desired outcome, and the competing solutions — the vocabulary that should show up in copy and content.
- Flag outreach-safe threads against the safety rule below, using each subreddit's verbatim rule from step 3.
Subreddit scoring rubric
Score each candidate subreddit 1–5 on three axes:
| Axis | What it measures | 1 | 3 | 5 |
|---|
| Relevance | how on-topic for the niche | tangential overlap | partly relevant | core audience lives here |
| Activity | live enough to mine and reach | dormant / few posts | steady weekly posts | daily active, fast comments |
| Outreach safety | room for a disclosed, helpful reply | rule 1 = no self-promo, hostile to vendors | promo tolerated in context | "what do you use for X" culture, vendors welcome if helpful |
Priority = Relevance × Activity for where to mine (you want on-topic and alive). Keep Outreach safety as a separate flag — it never raises mining priority, it only gates whether a thread can appear in the outreach list. A perfectly relevant subreddit with outreach-safety 1 is great for listening and off-limits for posting. Always record each subreddit's self-promotion rule verbatim.
Recurring-question extraction
- Pull titles + top comments from the highest-scoring subreddits.
- Normalize each question to its intent ("which tool for X," "is X worth it," "how do I do X," "why does X keep happening").
- Cluster near-duplicate phrasings into one question; keep every source URL on the cluster.
- Rank questions by recurrence across distinct threads/subreddits (not by single-post upvotes), and tag each as a question, objection/blocker, or recommendation request.
- Preserve the verbatim wording of the clearest example per cluster — that phrasing is the reusable copy asset.
Output
A community research brief:
| Subreddit | Subscribers | Activity | Relevance | Outreach safety | Self-promo rule (verbatim) | Tone toward category |
|---|
| r/… | 84k | daily | 5 | 2 | "No promotion of your own product" | skeptical of vendors |
- Recurring questions — clustered, ranked by recurrence, each with verbatim examples and URLs, tagged question / objection / recommendation-request.
- Common objections & blockers — what makes people hesitate or churn, in their own words, with sources.
- Community language — the verbatim vocabulary for the problem, the outcome, and the alternatives mentioned.
- Outreach-safe threads — a short list, each with the URL, the relevant subreddit rule, why it fits, and a note that any reply must be genuinely helpful and disclosed.
State the seed subreddits, the communities actually covered, the time window, and the record cost (UnifAPI billing metadata or best estimate) so the brief is reproducible — and note that, with no keyword search, coverage is bounded by the seed list rather than an exhaustive sweep.
Worked example (abbreviated)
Niche: self-hosted password managers. r/selfhosted (340k, daily, relevance 5, outreach safety 3) scored Priority 15 → top mining target; its rule allows "Saturday self-promo only," recorded verbatim. r/privacy (relevance 4, outreach safety 1, "no vendor participation") scored well for listening but was excluded from the outreach list entirely. Top recurring question across both: "how do I sync between devices without a cloud" (clustered from 6 threads) → tagged objection, and the verbatim "I don't want my vault on someone else's server" went into the language bank.
Guardrails
- Runs on-demand, not as a standing stream. Each brief is a snapshot of the communities at the time of the run.
- No keyword search — coverage is seed-bounded. Reddit here cannot be queried by topic, so the map is only as complete as the seed subreddits plus what
reddit/trending-searches/reddit/feed/popular surface. Never present it as an exhaustive scan of Reddit; name the seeds so a reader knows the boundary.
- Reads public Reddit only — public posts and comments. No private messages, no modmail, no owned-account or analytics data.
- Eyes, not hands. It maps and briefs; it never posts, comments, votes, or DMs. "Outreach-safe threads" are suggestions for a human to act on, with the relevant subreddit rules noted — the operator decides whether and how to reply, and any reply must be genuine and disclosed, never automated or spammy.
- Respect each subreddit's self-promotion rules; never recommend posting where it's against the rules, and never frame astroturfing or coordinated inauthentic posting as an option. Outreach safety gates the outreach list only — it never inflates mining priority.
- Reddit skews toward strong opinions and power users; treat findings as directional voice-of-customer signal, weighted by recurrence across threads and subreddits rather than any single post.
Related Skills
- social-listening-brief (Social Listening Agent): widen the lens — monitor a brand or launch across X, Reddit, YouTube, TikTok, Threads, and news, not just Reddit communities.
- customer-research (Content Strategy Agent): synthesize the questions, objections, and language here into reusable personas and voice-of-customer research.
- unifapi: the shared data skill — connect MCP and discover the
reddit/* operations this brief reads.
