Gentic Influencer Discovery

When to apply

• User wants to find influencers or creators for a brand campaign
• User asks to search Instagram or TikTok for creator partnerships
• User wants to score, review, or export creator match results
• User is setting up a brand profile for influencer matchmaking
• User wants to draft or send outreach emails to creators
• User wants to exclude existing creators from future searches

Tools reference

get_brand

save_brand

fetch_page

search_creators

score_creators

get_creator_results

draft_personalized_creator_outreach_email

export_creator_results

upload_excluded_creators

Workflow

1. Brand setup (required first)

get_brand

save_brand

• description

  : brand identity, values, voice, target audience

• matchmakingInstructions

  : what makes a creator a good fit (content style, audience demographics, deal-breakers)

• activeCampaignContext

  : current campaign or product focus

• initialOutreachCallToAction

  : the CTA paragraph for outreach emails — tells creators what to do next (e.g. product seeding offer, "reply if interested", "book a call")

• emailSignOff

  : sign-off line for outreach emails (defaults to "Team {brand_name}")

fetch_page

2. Upload existing creators (optional)

upload_excluded_creators

• usernames

  array — pass usernames directly (the agent reads a CSV or paste and extracts them)

• googleSheetsUrl

  — brand shares a public Google Sheets link; the tool fetches it server-side and extracts usernames from the first column

@

3. Search creators

search_creators

• Always search both platforms (Instagram and TikTok) unless the user specifies one. Run both calls in parallel.
• Write descriptive

  searchText

  — "fitness micro-influencers who post workout routines and meal prep" beats "fitness influencers"
• Use filters:

  minFollowers

  ,

  maxFollowers

  ,

  country

  ,

  minEngagementRate

  to narrow results

• campaignContext

  auto-reads from the brand profile — only override if the user gives campaign-specific instructions
• Results are stored automatically. Each search gets a unique

  run_id

  .

4. Score creators

score_creators

• Scoring is async. Tell the user results are processing and will be ready shortly.
• Score both platforms if both were searched.
• The

  brandContext

  auto-assembles from the brand profile — don't override unless asked.
• Scoring writes

  final_match_score

  (0-100) plus sub-scores back to the database.

5. View results

get_creator_results

• Format as a ranked table with columns: rank, username, platform, followers, engagement rate, match score, one-line analysis
• Bold any creator with score >= 80
• Below the table, highlight the top 3 with a short paragraph each: why they're a fit, any risk factors, and their personalized pitch angle
• If

  total

  exceeds

  count

  , mention how many more results are available
• If results have null scores, they haven't been scored yet — tell the user to run scoring first

6. Draft outreach emails

draft_personalized_creator_outreach_email

• Requires a brand profile with

  initialOutreachCallToAction

  set — prompt the user to add one via

  save_brand

  if missing.
• Only drafts for creators that have been scored and don't already have an email.

• minScore

  defaults to 70 — only high-quality matches get emails.
• Capped at 10 per call. Emails are stored in the database and visible in

  get_creator_results

  and

  export_creator_results

  .
• Sign-off is appended automatically from

  emailSignOff

  (or defaults to "Team {brand_name}").

7. Export

export_creator_results

Important notes

• All tools are org-scoped. Users only see their own data.
• Mention costs when the user is doing a large search (50+ results).
• If a user asks to "find influencers" or "find creators" with no prior context, start from step 1.