Score how well specific creators fit a campaign brief or search intent.
Use this when the user already has candidate creators in mind and wants to evaluate
fit (e.g., "rate these 5 creators for a vegan cookbook launch", "which of these is
the best match for my crypto audience?"). For each creator the API returns a match
score (0-1), a good/neutral/avoid decision, and structured reasons.
Pass candidates in `creator_ids` (canonical UUIDs) and/or `profiles`
(platform + username). `intent_query` is the brief the LLM reasons against;
`intent_context` is optional extra context (target audience, brand values,
prior collabs).
Use `semantic_search_creators` when you don't have candidates yet and need topical
or niche discovery. Use `search_creators` first when you only need to resolve rough
creator names/handles into candidates.
Use `find_lookalike_creators` when you want creators similar to known good fits.
Examples:
- User: "Is @niickjackson a fit for Pixel?" -> use this tool after resolving the
exact Instagram profile with `get_profile`; call `get_posts` first if recent
content context is needed.
- User: "Rate these five creators for a vegan cookbook launch" -> use this tool.
Connector