solari instagram account search

개요

브랜드/크리에이터 이름이나 Instagram 핸들을 추적 중인 후보 계정으로 해석하고, 프로필 bio 텍스트도 검색해요. 빠른 결정적 인덱스 검색이며, 타입어헤드처럼 후보를 모두 반환해요. query_type으로 무엇을 매칭할지 고를 수 있어요 — auto(기본값)는 핸들을 접두사로, 프로필 표시 이름(한글 또는 영문)을 텍스트 매치로 함께 보고, username이나 full_name은 둘 중 하나로만 좁히며, bio는 프로필 bio 텍스트를 전문 검색해요. bio 모드는 이름이 아니라 계정이 스스로를 어떻게 소개하는지로 찾는 방법이에요("skincare", "협찬 문의", "コスメ"). 매치 품질과 팔로워 수 순으로 정렬해요. found와 함께 가장 잘 맞는 순으로 정렬된 items를 반환하며(items[0]이 최상위 매치), 각 항목은 account_id(다른 모든 툴이 받는 SOLARI 계정 UUID), username, full_name, biography, follower_count, region, is_verified, profile_pic_url을 담아요. found=false에 items가 비어 있으면 매치가 없다는 뜻이에요. 이름으로 찾는 모드에서는 query가 핸들이나 표시 이름에 실제로 나타나야 해요 — 발음 기반 별칭이나 약어로는 해석되지 않으니 원래 표기(예: 영문 브랜드명)로 다시 시도해 보세요. 브랜드명을 해석할 때는 brands_only=true를 설정해 팬 계정과 밈 계정을 걸러내고, query_type=bio와 함께 쓰면 한 카테고리의 브랜드를 한 번에 훑을 수 있어요. region은 특정 국가를 요청받은 게 아니라면 비워 두세요 — 설정하면 그 리전 밖 계정을 전부 버려요. 로그인된 SOLARI 계정이면 누구나 사용할 수 있어요. 이름으로 언급된 엔티티를 해석할 때는 이 툴을 먼저 쓰세요.

파라미터

querystring필수

해석할 브랜드/크리에이터 이름(한글/영문) 또는 Instagram 핸들. query_type=bio일 때는 프로필 bio에서 찾을 단어예요.

query_typeenum선택

무엇을 매칭할지 골라요. auto = 핸들과 표시 이름을 함께, username = 핸들만, full_name = 표시 이름만, bio = 프로필 bio 텍스트.기본값 "auto"값autousernamefull_namebio

brands_onlyboolean선택

알려진 브랜드 계정으로 매치를 한정해요. 브랜드명을 해석할 때 권장해요.기본값 false

limitinteger선택

반환할 최대 후보 수, 기본값 8. 50을 넘는 값은 50으로 잘려요.≥ 1

regionstring선택

KR, JP, US 같은 리전 코드(선택). 특정 국가를 요청받은 게 아니라면 비워 두세요 — 설정하면 해당 리전만 남기고 나머지는 버려요.≤ 8 chars

응답

예시

요청

$ solari instagram account search query=oliveyoung brands_only=true limit=5

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

{
  "found": true,
  "items": [
    {
      "account_id": "018cab6d-1648-7071-9734-c47a2be2fd19",
      "username": "oliveyoung_official",
      "full_name": "올리브영 OLIVE YOUNG",
      "biography": "ALL LIVE YOUNG 🫒\nALL LIVE BETTER @olivebetter.official",
      "follower_count": 1199628,
      "region": "KR",
      "is_verified": true,
      "profile_pic_url": "https://dcr.bzine.co/instagram/users/oliveyoung_official/profile-picture"
    },
    {
      "account_id": "018dc63c-31b5-740f-bde0-2c00931385e1",
      "username": "oliveyoung_global",
      "full_name": "OLIVE YOUNG Global",
      "biography": "Korea's No.1 Health & Beauty Store\n✈️ FREE SHIPPING on orders over $60",
      "follower_count": 535949,
      "region": "KR",
      "is_verified": true,
      "profile_pic_url": "https://dcr.bzine.co/instagram/users/oliveyoung_global/profile-picture"
    },
    {
      "account_id": "018cabcf-e60e-70af-95eb-eff777ce5195",
      "username": "oliveyoung_magazine",
      "full_name": "올리브영 매거진",
      "biography": "내 일상과 가까운 뷰티 매거진",
      "follower_count": 142316,
      "region": "KR",
      "is_verified": false,
      "profile_pic_url": "https://dcr.bzine.co/instagram/users/oliveyoung_magazine/profile-picture"
    },
    "… 2 more"
  ]
}

MCP 호출로 쓰면

{
  "name": "solari_instagram_account_search",
  "arguments": {
    "query": "oliveyoung",
    "brands_only": true,
    "limit": 5
  }
}

주의사항

• 이름으로 찾는 모드에서는 query가 핸들이나 표시 이름에 실제로 나타나야 해요. 발음 기반 별칭이나 약어로는 해석되지 않아요 — 원래 표기로 다시 시도해 보세요.
• 브랜드명을 해석할 때는 brands_only=true를 설정하세요. 팬 계정과 밈 계정을 걸러내요.
• query_type=bio는 이름 대신 프로필 bio 텍스트를 검색해요. 계정이 스스로를 어떻게 소개하는지로 찾을 수 있어요 — "skincare", "협찬 문의", "コスメ". 한국어·일본어·중국어 bio는 부분 문자열로도 매칭되니, 검색어가 bio 안에서 독립된 단어일 필요는 없어요.
• bio 검색 대상은 SOLARI가 이미 추적 중인 계정이고, 열 곳 중 한 곳쯤은 bio 자체가 없어요. 전수 조사가 아니라 발견용으로 쓰세요.
• region은 결과를 해당 리전으로 좁히고 나머지 계정은 전부 버려요. 특정 국가를 요청받은 게 아니라면 비워 두세요.

관련 도구

• solari_instagram_account_profileSOLARI가 Instagram 계정 하나에 대해 아는 모든 것, 성과 지표 포함.
• solari_instagram_account_posts계정 하나의 포스트를 최신순으로 페이지 단위로 훑어요.
• solari_tiktok_account_search브랜드나 크리에이터 이름을 TikTok account_id로 바꿔요.

기계가 읽는 형식: /docs/tools/instagram-account-search.md