# solari instagram account search

> 브랜드·크리에이터 이름이나 프로필 bio 문구를 Instagram account_id로 바꿔요.

- **CLI**: `solari instagram account search`
- **MCP 도구**: `solari_instagram_account_search`
- **권한**: `solari:read` — 로그인한 SOLARI 계정이면 쓸 수 있어요.

브랜드/크리에이터 이름이나 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 계정이면 누구나 사용할 수 있어요. 이름으로 언급된 엔티티를 해석할 때는 이 툴을 먼저 쓰세요.

**언제 쓰나** — 사용자가 엔티티를 이름으로 언급하면 항상 이 툴을 먼저 호출하세요. 다른 모든 Instagram 툴은 여기서 반환된 account_id를 받아요.

**무엇이 돌아오나** — 가장 잘 맞는 순으로 정렬된 후보 계정. items[0]이 최상위 매치예요.

## 파라미터

- `query` (string, 필수) — 해석할 브랜드/크리에이터 이름(한글/영문) 또는 Instagram 핸들. query_type=bio일 때는 프로필 bio에서 찾을 단어예요.
- `query_type` (enum, 선택, 기본값 "auto") — 무엇을 매칭할지 골라요. auto = 핸들과 표시 이름을 함께, username = 핸들만, full_name = 표시 이름만, bio = 프로필 bio 텍스트. 값: `auto`, `username`, `full_name`, `bio`.
- `brands_only` (boolean, 선택, 기본값 false) — 알려진 브랜드 계정으로 매치를 한정해요. 브랜드명을 해석할 때 권장해요.
- `limit` (integer, 선택, ≥ 1) — 반환할 최대 후보 수, 기본값 8. 50을 넘는 값은 50으로 잘려요.
- `region` (string, 선택, ≤ 8 chars) — KR, JP, US 같은 리전 코드(선택). 특정 국가를 요청받은 게 아니라면 비워 두세요 — 설정하면 해당 리전만 남기고 나머지는 버려요.

## 응답

### `Response`

- `found` (boolean) — 후보가 하나 이상 매치되면 true.
- `items` (object[]) — 후보 목록. 매치 품질, 그다음 팔로워 수 순으로 정렬돼요.

### `items[]`

- `account_id` (uuid) — SOLARI account id — 다른 모든 Instagram 툴이 받는 값이에요.
- `username` (string) — Instagram 핸들.
- `full_name` (string) — 프로필 표시 이름.
- `biography` (string) — 프로필 bio 텍스트.
- `follower_count` (integer) — 스냅샷 시점의 팔로워 수.
- `region` (string) — 리전 코드.
- `is_verified` (boolean) — Instagram 인증 배지.
- `profile_pic_url` (string) — 프로필 사진 URL.

## 예시

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

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

```json
{
  "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 호출로 쓰면

```json
{
  "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_profile`](https://solari.sh/docs/tools/instagram-account-profile.md?lang=ko)
- [`solari_instagram_account_posts`](https://solari.sh/docs/tools/instagram-account-posts.md?lang=ko)
- [`solari_tiktok_account_search`](https://solari.sh/docs/tools/tiktok-account-search.md?lang=ko)