# solari catalog instagram account search

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

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

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

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

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

## 파라미터

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

## 응답

### `Response`

- `found` (boolean) — 맞는 계정이 있는지예요
- `items` (object[]) — 맞는 계정이에요. 가장 가까운 결과가 맨 앞이에요

### `items[]`

- `account_id` (uuid) — 다른 Instagram 도구에 넣는 account_id예요
- `username` (string) — Instagram 사용자명
- `full_name` (string) — 표시 이름
- `biography` (string) — 프로필 Bio
- `follower_count` (integer) — 팔로워 수
- `region` (string) — 국가 코드
- `is_verified` (boolean) — 인증 배지
- `profile_pic_url` (string) — 프로필 사진 URL

## 예시

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

## 주의사항

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

## 관련 도구

- [`solari_catalog_instagram_account_profile`](https://solari.sh/docs/tools/catalog-instagram-account-profile.md?lang=ko)
- [`solari_catalog_instagram_account_posts`](https://solari.sh/docs/tools/catalog-instagram-account-posts.md?lang=ko)
- [`solari_catalog_tiktok_account_search`](https://solari.sh/docs/tools/catalog-tiktok-account-search.md?lang=ko)