instagram · catalog · accountsolari:read

solari catalog instagram account search

모아 둔 Instagram 계정을 사용자명, 이름, Bio 문구로 찾아요. account_id를 확보하는 데 쓸 수 있어요.

MCP 도구: solari_catalog_instagram_account_search
CLI: solari catalog instagram account search
권한: solari:read로그인한 SOLARI 계정이면 쓸 수 있어요.로그인한 SOLARI 계정이면 쓸 수 있어요.
Required plan: Free
Credit: 0

개요

SOLARI가 모아 둔 Instagram 계정 카탈로그에서 사용자명, 이름, 또는 프로필 Bio 문구로 찾아요. Instagram 검색이 아니에요. 여기서 받은 account_id는 다른 Instagram 도구에 그대로 넣으면 돼요.

언제 쓰나 — 이름이나 사용자명만 있고, account_id는 아직 없을 때 사용해요.

무엇이 나오나 — 맞는 계정 목록이에요. 가장 가까운 결과가 맨 앞에 와요.

파라미터

querystring필수: 사용자명, 이름, 또는 query_type=bio일 때는 프로필 Bio에 있는 문구
query_typeenum선택: 어디를 볼지: 사용자명, 표시 이름, Bio, 또는 전부 (auto)기본값 "auto"값autousernamefull_namebio
brands_onlyboolean선택: 알려진 브랜드 계정만 남겨요. 브랜드를 찾을 때 켜 주세요기본값 false
limitinteger선택: 몇 명까지≥ 1
regionstring선택: KR, JP 같은 국가 코드. 비우면 전체를 찾아요≤ 8 chars

응답

Response

foundboolean: 맞는 계정이 있는지예요
itemsobject[]: 맞는 계정이에요. 가장 가까운 결과가 맨 앞이에요

items[]

account_iduuid: 다른 Instagram 도구에 넣는 account_id예요
usernamestring: Instagram 사용자명
full_namestring: 표시 이름
biographystring: 프로필 Bio
follower_countinteger: 팔로워 수
regionstring: 국가 코드
is_verifiedboolean: 인증 배지
profile_pic_urlstring: 프로필 사진 URL

예시

요청

$ solari catalog 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_catalog_instagram_account_search",
  "arguments": {
    "query": "oliveyoung",
    "brands_only": true,
    "limit": 5
  }
}

주의사항

이름 검색은 사용자명이나 표시 이름에 그 글자가 있어야 해요. 별명이나 약어는 잘 안 맞아요.
브랜드를 찾을 때는 brands_only=true로 두세요. 팬 계정이 빠져요.
region을 넣으면 지정한 국가만 남아요. 특정 국가가 아니면 비워 두세요.

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

개요

파라미터

응답

예시

주의사항

관련 도구