reddit-subreddit-finder — rank subreddits for a topic
Given a GTM object (a product/topic in one line), return a ranked table of candidate subreddits with fit, self-promo safety, and a rules summary. On-demand and live: no central index — fit is computed from what rdt returns now, not from corpus overlap.
Shared contracts: rdt-readonly · guardrails.
When to trigger
Manual only. Run when the user asks where to post, or to find communities/audience for a topic.
Flow
1. Find candidates
Derive query terms from the GTM object. reach fetch-reddit search "<terms>" -s relevance -t year — relevance, not top (top biases to mega-subs and off-topic viral posts). Keep only on-topic posts, and collect the subreddits they recur in as candidates.
2. Profile each candidate
reach fetch-reddit sub-info <sub> for subscribers, restrict_posting, submission_type, public_description. For a rough removal signal, sample reach fetch-reddit sub <sub> -s new and read each post's removed / removed_by_category field (per-post, not a single grep count).
3. Score — multi-axis, relative
Judge three axes per candidate from the data, and rank relatively across candidates (no fixed numbers):
- audience match — how on-topic its content/description is to the GTM object;
- self-promo tolerance — from
submission_type+ the removal signal + the rules summary (restrict_postingis near-universallytrue, so weak on its own); - activity — subscribers plus recent post cadence.
4. Safety + rules
Per candidate emit a hard self-promo: safe / risky flag consistent with its rules, a rules summary (see guardrails; it is an approximation), and a one-line tailored entry angle.
Output
A ranked table, best first:
subreddit | subscribers | fit (audience / tolerance / activity) | self-promo safe? | rules summary | entry angle
Stops here for the human to choose a community.
Persist the choice — confirm-then-save
When the human picks a community (this run or in reply), save it to that product's ~/Documents/auto-gtm/<product-slug>/subreddits.md per storage.md — mirroring how topic-scout saves confirmed highlights. This is the writer for the store that reddit-post-drafter reads, so a returning product skips re-ranking. Rules: only on an explicit human choice (never auto-save the top row); store just the chosen subreddit name(s) — never any fetched post/rules body; slugify the product from the trigger to locate the folder, create it on first save. If the human doesn't choose, write nothing.
Config
Candidate count (default ~8), search window (default -t year), removal-sample size (default ~25). Override per request.
Boundary
Read-only via rdt (whitelist in rdt-readonly). Ranks only; the human's chosen sub is persisted to the local subreddits.md. Drafting a reply is reddit-auto-comment-draft; writing a post is reddit-post-drafter.