Pull latest data via the active ingestion adapter and upsert into the local store.

method='csv': source is a directory containing creators.csv / campaigns.csv / content_items.csv / performance_metrics.csv (see sample_data/). method='api': pulls from the real SideShift API. Requires the SIDESHIFT_API_KEY env var (Settings -> Integrations in the SideShift dashboard). since (YYYY-MM-DD) limits ingestion to records on/after that date.

List creators, optionally filtered by niche tag, platform, or status.

Full creator profile: niche, style, platforms, performance history, best formats.

Aggregate metrics + trend direction.

scope: 'global' | 'creator' | 'campaign' | 'format'. scope_id required unless scope='global'.

Ranked content items by a chosen metric (views/likes/comments/shares/saves/conversions/revenue/engagement_rate).

include_unlisted: whether to include content from creators no longer returned by SideShift's /creators (ghost handles or removed accounts -- SideShift excludes those by design, so this tool can't fetch more about who they are, just show or hide their content).

Format/hook tags whose average performance beats the roster baseline, ranked by multiplier.

Rank active creators for a brief or set of format tags, with rationale for each match.

Draft a brief tailored to a creator's style, targeting a given or trending format.