マニュアル
KOL lists — a fit-ranked decision surface, not a folder
最終更新: 2026-06-10
要点
A KOLens list answers “who do we actually work with?” in one screen: every member arrives with a 0–100 fit score, red flags (dormant, engagement under 4%, authenticity under 30, missing contact), positive flags, 7d/30d trend, an estimated price range, contact completeness and live CRM outreach status. A rollup header totals budget, triage progress and risk counts. You triage each member to shortlisted or passed, and the decision — plus its reasoning — stays visible to your whole workspace.
What it is
Spreadsheets die at the vetting stage: stats go stale the day after export, and decisions (“passed — fake followers”) live in someone's head. A KOLens list keeps members connected to the live database. One request — GET /api/lists/{list_id}/members — returns everything needed to decide, so neither humans nor AI agents ever fetch per-creator follow-ups.
What each member row carries
| Block | Contents |
|---|---|
| Fit score | 0–100, combining authenticity, engagement, growth, brand recommendation score, tier, pricing and contact completeness |
| Red flags | dormant (no recent posts) · low engagement (<4%) · fake followers (authenticity <30) · missing contact · offline >90 days |
| Positive flags | verified · high engagement (>8%) · strong authenticity (>80) · complete contact · rising growth |
| Trend | 7d/30d follower & engagement deltas with a rising / stable / declining label |
| Commercials | tier, estimated price range, your tags & notes |
| Pipeline | triage_state (untriaged / shortlisted / passed) + live CRM status (lead → contacted → … → partner) |
Above the rows, the rollup shows: total members, counts by triage state, red-flag and missing-contact counts, and the total estimated budget of the current shortlist — the number your finance review actually wants.
How to build and triage a list
- Create a list per campaign or per client (POST /api/lists with name + description).
- Fill it: add creators from search results in bulk, from a dossier's “Add to list” button, or automatically via a discovery plan's target_list_id.
- Sort by fit score and triage top-down: shortlist or pass each member (PATCH /api/lists/{list_id}/members/{username} with triage_state). Record reasons in notes.
- Set tier and expected pricing per member if you've negotiated — the rollup budget updates live.
- Use Refresh (POST /api/lists/{list_id}/refresh) before a decision meeting so stats and trends are current.
Typical scenarios
- Campaign casting: 60 candidates from three searches → fit-sorted triage → 12 shortlisted with a $9k total budget estimate, all visible in the rollup before anyone is contacted.
- Agency hand-off: the researcher triages, the account manager works only the shortlisted members — the same list, no export-import loop.
- Outreach division of labor: POST /api/lists/{list_id}/assign-export splits the list across team members into a multi-sheet Excel — one sheet per assignee.
Advanced usage
- Close the loop with CRM: once outreach starts, each member's CRM status (contacted / responded / negotiating / partner) appears in the list automatically — the list remains the single source of truth through signing.
- Brand-fit tuning: fill in your workspace brand profile (product, audience, budget) and the recommendation component of fit scores aligns to your brand, not a generic ideal.
- Agent triage: via MCP, get_list_members gives Claude the full decision payload — ask it to “triage my Q3 list, shortlist anyone above fit 70 with no red flags, and explain each pass”.
よくある質問
Do lists cost credits?
No — creating lists, adding members, triaging and reading the decision payload are all free. Credits are only spent upstream (discovery) or when you refresh stats via new scrapes.
How is the fit score different from the authenticity score?
Authenticity (0–100) answers “is this account real?” — it's one input. Fit (0–100) answers “should we work with them?” and also weighs engagement, growth trend, tier, estimated price and whether you can actually contact them.
Can the same creator be on several lists?
Yes — membership, triage states, tags and notes are per-list, so a creator can be shortlisted for one campaign and passed for another without conflict.
Who can see my lists?
Lists are workspace-scoped: everyone in your workspace sees and can collaborate on them. Personal accounts keep lists private to you.