| name | reddit-creator-deploy |
| description | Turn a KOL roster + subreddit brand-fit analysis into a deployable creator network. Splits creators into KOL (authority) and KOC (grassroots) layers, matches each to a main + secondary subreddits by real gear/shooting-type ∩ community fit, and emits an account×subreddit deployment_matrix (with a ≤3-per-sub ceiling + no-cross-interaction rule) plus per-creator persona_cards. Route A disclosed-compliance baked into every card (FTC disclosure required on any material connection). Consumes reddit-kol-finder's kol_roster.json natively. READ-ONLY, deterministic, no LLM key needed. |
reddit-creator-deploy
用途 / Purpose
The packaging step between "who could post" (reddit-kol-finder) and "who posts what, where" (reddit-content-brief). Takes real creators + real subreddit brand-fit and produces the deployment plan: KOL/KOC two-layer split, an account×subreddit matrix, and per-creator persona cards — all under Route A disclosed-creator compliance (no sockpuppets, disclosure mandatory, ≤3 of our creators per sub, no cross-creator interaction). Generalised from the AcmeGear campaign (创作者花名册 + 部署矩阵).
输入 / Inputs
| arg | required? | type | where it comes from | error if missing |
|---|
--roster | yes | file | kol_roster.json from reddit-kol-finder (uses reddit_native[]), or a plain [{handle,subreddits,tier,gear,shooting_types,geo,profession}] list | ERROR: --roster file not found (exit 2); 0 creators → exit 3 |
--subs | yes | file | subreddit brand-fit map {"<sub>":{"fit_score":N,"tolerance":".."}} or sweep jsonl ({"sub":..,"verdict":{"fit_score":..}}) | ERROR: --subs file not found (exit 2) |
--brand | yes | string | brand name (used in disclosure lines) | ERROR: the following arguments are required: --brand |
--products | no | comma list | product lines (for context) | — |
--out-dir | no | dir | output dir (default out) | — |
输出 / Outputs
deployment_matrix.json — {brand, n_creators, n_kol, n_koc, max_per_sub, saturated_subs, rows[]}; each row {handle, layer(KOL/KOC), geo, main_sub, secondary_subs[], cadence, disclosure}.deployment_matrix.md — the human table + 合规底线 block; flags any subreddit over the ≤3-creator ceiling.persona_cards.md — one card per creator (真实身份 / 主副场 / 社区匹配逻辑 / 披露式品牌关系 / 节奏), labelled 招募画像 (real people fill in later).
逻辑 / How it decides
- Layer: roster
tier A → KOL; B/C → KOC; else infer from signals.upvotes_total (≥200 → KOL).
- Main/secondary subs: rank the creator's own subreddits by real
fit_score from --subs; top = main, next 1-2 = secondary. A creator only ever lands in communities they actually belong to.
- Cadence: KOL = 1 post/2-3wk + weekly comments; KOC = comment-led + 1 post/3wk.
- Compliance (baked, not optional): every card carries the FTC disclosure requirement; matrix enforces ≤3 of our creators per sub (flags saturation), no cross-creator interaction, no same-content multi-sub. Route A only — no fabricated personas.
Usage
$ python3 scripts/generate.py --roster kol_roster.json --subs subs_fit.json \
--brand "AcmeGear" --products "兔笼,快装板,监视器支架" --out-dir out
{"n_creators": 5, "n_kol": 2, "n_koc": 3, "saturated_subs": {}, "out_dir": "out"}
Test: python3 scripts/test.py (real fixture in fixtures/, asserts layer split + fit-ranked mains + disclosure on every row).
Pipeline position
Runs after reddit-kol-finder (consumes its kol_roster.json) and before reddit-content-brief (which writes what each deployed creator posts). Front-end recon comes from subreddit-deep-research (community universe + high-upvote logic + rules) → its --subs fit output feeds this skill.
