← All Skills
Enhanced · live dataSocial Listening Agent

Reddit Community Research Agent

Turn Reddit posts and comments into a community research brief an agent can keep refining.

Agent-native

Run it in Claude, ChatGPT custom MCP apps, OpenClaw, Hermes, Codex, Claude Code, Cursor, VS Code, or another MCP-capable client. No dedicated GUI flow and no separate LLM API key.

Backed by live public data

Every step is grounded in live public-data records UnifAPI returns, so the output cites what is actually ranking, posting, or being said — not a generic best-practice list.

Composable & open source

Skills cross-reference each other and live in a public, MIT-style repo. Read the full SKILL.md on GitHub, fork it, or run it as-is inside your agent.

Run prompt

Paste this into Codex or Claude Code

The prompt is intentionally editable. Replace the handles, market, budget, and campaign goal, then let the agent call UnifAPI MCP when it needs live public data.

Find active Reddit communities for developer productivity tools. Summarize common pains, buying triggers, repeated objections, and outreach-safe threads.
How the skill works

The full skill, rendered from its SKILL.md

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 hotreddit/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 threadsreddit/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-usersreddit/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

  1. 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.
  2. 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.
  3. Build the subreddit map. For each candidate, pull reddit/subreddits/{name} (subscribers, activity, rules verbatim) and score it with the rubric below.
  4. 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).
  5. 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.
  6. 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:

AxisWhat it measures135
Relevancehow on-topic for the nichetangential overlappartly relevantcore audience lives here
Activitylive enough to mine and reachdormant / few postssteady weekly postsdaily active, fast comments
Outreach safetyroom for a disclosed, helpful replyrule 1 = no self-promo, hostile to vendorspromo 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

  1. Pull titles + top comments from the highest-scoring subreddits.
  2. Normalize each question to its intent ("which tool for X," "is X worth it," "how do I do X," "why does X keep happening").
  3. Cluster near-duplicate phrasings into one question; keep every source URL on the cluster.
  4. Rank questions by recurrence across distinct threads/subreddits (not by single-post upvotes), and tag each as a question, objection/blocker, or recommendation request.
  5. Preserve the verbatim wording of the clearest example per cluster — that phrasing is the reusable copy asset.

Output

A community research brief:

  • Subreddit map:
SubredditSubscribersActivityRelevanceOutreach safetySelf-promo rule (verbatim)Tone toward category
r/…84kdaily52"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.
  • 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.

Source: reddit-community-research/SKILL.md on GitHub — open a PR there to improve it.

Public-data tools

The live APIs this skill calls

Every operation the skill names is one of these UnifAPI platforms — still visible and callable for product code, debugging, and custom agent flows.

  • Subreddit map
  • Pain-point themes
  • Example threads
Related skills

More skills in the Social Listening Agent

Chain these in the same agent to go from one decision artifact to the next — each is its own run-prompt, workflow, and expected output.

Social listening

Track public mentions and return a concise brief instead of a dashboard.

Open skill

Thread fit check

Score Reddit threads by relevance, intent, rules, timing, and account risk before anyone replies.

Open skill
See every skill in the Social Listening Agent