instagram · insight · accountsolari:read

solari insight instagram account discover

캠페인 브리프에 맞는 Instagram 크리에이터를 찾습니다.

MCP 도구

solari_insight_instagram_account_discover

권한

solari:read

이용 가능 플랜

무료 체험
Plus
Pro
Enterprise

크레딧

개요

브리프를 바탕으로 크리에이터 후보 목록을 만듭니다. 어떤 콘텐츠를 올리는지, 소개글에 무엇이 있는지, 누구와 비슷한지, 성장 중인지, 전에 무엇을 광고했는지로 찾습니다. 팔로워 수와 3개월 조회수로 거르고, 제외 키워드에 걸리는 크리에이터는 뺍니다.

언제 쓰나요 — 아직 모르는 크리에이터가 필요할 때. 이미 이름을 알면 catalog account search 도구를 쓰세요.

돌려주는 값 — search_id, 찾은 전체 수, 상위 username 미리보기, 결과 섹션. 전체 목록은 discover results 도구로 페이지를 넘겨 보세요.

파라미터

intentstring필수: 브리프를 한 문장으로. 결과 이름으로 쓰입니다.≤ 300 chars
topic_keywordsstring[]선택: 콘텐츠에 관한 문구 2~3개. 타깃 시장의 언어로 쓰세요. 여러 단어로 된 문구가 더 잘 맞습니다.1–3 items
profile_keywordsstring[]선택: 소개글에서 찾을 문구 1~2개. 직업명이나 분야 같은 것.1–2 items
similar_usernamestring선택: 참고할 크리에이터의 username. 그 크리에이터와 비슷한 크리에이터를 더합니다.≤ 64 chars
trendingboolean선택: 조회수가 빠르게 느는 크리에이터도 더합니다.기본값 false
product_querystring선택: 짧은 영어 제품 설명. 비슷한 제품을 광고한 크리에이터를 앞에 둡니다.≤ 200 chars
follower_mininteger선택: 최소 팔로워 수.≥ 0
follower_maxinteger선택: 최대 팔로워 수.≥ 0
total_views_mininteger선택: 최근 3개월 총 조회수 최솟값.≥ 0
total_views_maxinteger선택: 최근 3개월 총 조회수 최댓값.≥ 0
median_views_mininteger선택: 최근 3개월 게시물당 조회수 중앙값의 최솟값.≥ 0
median_views_maxinteger선택: 최근 3개월 게시물당 조회수 중앙값의 최댓값.≥ 0
negative_keywordsstring[]선택: 소개글이나 게시물에 이 단어가 하나라도 있으면 뺍니다.1–10 items
media_focusenum선택: 시각 스타일을 맞출 때 사진과 영상 중 어느 쪽을 더 볼지.기본값 "balanced"값balancedphotovideo
regionstring선택: KR, JP, US 같은 국가 코드.기본값 "KR"
brand_account_idstring선택: 브랜드 account_id. 브랜드 오디언스와 잘 맞는 순서로 크리에이터를 정렬합니다.uuid, pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
brand_usernamestring선택: 브랜드 사용자 이름. brand_account_id를 넣으면 무시됩니다.≤ 64 chars
limitinteger선택: 미리보기로 보여 줄 상위 username 수. 전체 목록은 늘 따로 페이지로 받습니다.기본값 201–60

응답

Response

search_iduuid: discover results 도구에 넣어 전체 목록을 페이지로 넘겨 보세요.
intentstring: 결과 이름으로 쓴 브리프.
totalinteger: 찾은 크리에이터 수.
top_usernamesstring[]: 가장 잘 맞는 크리에이터 미리보기. 잘 맞는 순서입니다.
sectionsobject[]: 결과를 나눈 방식.
duration_msinteger: 검색에 걸린 시간.
nextstring: 전체 목록을 페이지로 넘겨 보는 명령어.

sections[]

typestring: 가장 잘 맞는 크리에이터는 best_match, 나머지는 full_results.
labelstring: 표시용 이름.
countinteger: 섹션 첫 페이지의 크리에이터.
has_moreboolean: 섹션이 첫 페이지 뒤로 더 이어지는지 여부.

예시

요청

$ solari insight instagram account discover intent="KR makeup creators for an autumn eyeshadow palette launch" topic_keywords='["가을 메이크업 팔레트","데일리 아이섀도우"]' follower_min=10000 follower_max=300000 region=KR limit=5

응답 · 읽기 편하도록 긴 문자열과 반복되는 배열 항목을 줄였습니다.

{
  "search_id": "01a0f3c2-7e41-7b9a-8d2c-5e6f1a9b3c47",
  "intent": "KR makeup creators for an autumn eyeshadow palette launch",
  "total": 184,
  "top_usernames": [
    "beinny_motd",
    "donge_cos",
    "… 18 more"
  ],
  "sections": [
    {
      "type": "best_match",
      "label": "베스트 매칭",
      "count": 12,
      "has_more": false
    },
    {
      "type": "full_results",
      "label": "전체 결과",
      "count": 48,
      "has_more": true
    }
  ],
  "duration_ms": 23871,
  "next": "solari insight instagram account discover results search_id=01a0f3c2-7e41-7b9a-8d2c-5e6f1a9b3c47"
}

MCP 호출

{
  "name": "solari_insight_instagram_account_discover",
  "arguments": {
    "intent": "KR makeup creators for an autumn eyeshadow palette launch",
    "topic_keywords": [
      "가을 메이크업 팔레트",
      "데일리 아이섀도우"
    ],
    "follower_min": 10000,
    "follower_max": 300000,
    "region": "KR",
    "limit": 5
  }
}

주의사항

topic_keywords, profile_keywords, similar_username, product_query, trending=true 중 하나 이상을 넣으세요.
브리프가 넓으면 최대 1분쯤 걸릴 수 있습니다.
search_id는 계속 쓸 수 있습니다. 나중에 다시 검색하지 않고 정렬을 바꾸거나 페이지를 넘길 수 있습니다.

에이전트용 문서: /docs/tools/insight-instagram-account-discover.md

개요

파라미터

응답

예시

주의사항

관련 도구