# solari fetch instagram account search

> Instagram에서 이름으로 계정을 바로 찾습니다.

- **CLI**: `solari fetch instagram account search`
- **MCP 도구**: `solari_fetch_instagram_account_search`
- **권한**: `solari:read`
- **이용 가능 플랜**: 무료 체험 · Plus · Pro · Enterprise
- **크레딧**: 1

이름이나 핸들 일부로 Instagram에서 직접 계정을 찾습니다. catalog account search는 SOLARI가 수집하는 계정만 찾을 수 있습니다. 이 도구는 나머지 계정도 찾고, 그중 이미 수집 중인 계정을 알려 줍니다.

**언제 쓰나요** — catalog account search에서 이름으로 찾은 결과가 없거나, 카탈로그에 추가하기 전에 정확한 핸들을 알아야 할 때 쓰세요.

**돌려주는 값** — Instagram이 정한 순서대로 최대 50개 계정. 이미 카탈로그에 있는 계정에는 account_id가 붙습니다.

## 파라미터

- `query` (string, 필수, ≤ 100 chars) — 이름이나 핸들 일부. @는 붙여도 되고 빼도 됩니다.

## 응답

### `Response`

- `query` (string) — 검색에 쓴 텍스트. @는 뺀 값입니다.
- `items` (object[]) — 일치한 계정 목록. Instagram이 정한 순서.
- `found` (integer) — 돌려받은 계정 수.
- `tracked` (integer) — account_id가 있는 계정 수.

### `items[]`

- `username` (string) — 핸들. 소문자로 바꾼 값.
- `full_name` (string | null) — 표시 이름.
- `is_verified` (boolean) — 인증 배지 여부.
- `is_private` (boolean) — 비공개 계정 여부.
- `profile_picture_url` (string | null) — 프로필 사진 URL.
- `account_id` (uuid | null) — 이미 수집 중인 계정이면 SOLARI 계정 id. null이면 먼저 fetch instagram account로 추가하세요.

## 예시

```console
$ solari fetch instagram account search query=innisfree
```

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

```json
{
  "query": "innisfree",
  "items": [
    {
      "username": "innisfreeofficial",
      "full_name": "innisfree official",
      "is_verified": true,
      "is_private": false,
      "profile_picture_url": "https://scontent.cdninstagram.com/v/t51.2885-19/example.jpg",
      "account_id": "018cabce-14cc-7544-8890-7811ec33ef74"
    },
    {
      "username": "innisfree_jp",
      "full_name": "innisfree Japan",
      "is_verified": false,
      "is_private": false,
      "profile_picture_url": null,
      "account_id": null
    }
  ],
  "found": 2,
  "tracked": 1
}
```

## MCP 호출

```json
{
  "name": "solari_fetch_instagram_account_search",
  "arguments": {
    "query": "innisfree"
  }
}
```

## 주의사항

- 아무것도 저장하지 않습니다. 수집하지 않은 계정을 카탈로그에 넣으려면 그 username으로 fetch instagram account를 실행하세요.
- 순서는 Instagram이 정해서 공식 계정이 항상 맨 앞에 오지는 않습니다. is_verified를 확인하세요.
- 여기서는 팔로워 수가 오지 않습니다. 계정이 수집된 뒤 catalog account profile로 확인하세요.

## 관련 도구

- [`solari_catalog_instagram_account_search`](https://clip-pub.bzine.co/docs/tools/catalog-instagram-account-search.md?lang=ko)
- [`solari_fetch_instagram_account`](https://clip-pub.bzine.co/docs/tools/fetch-instagram-account.md?lang=ko)
- [`solari_catalog_instagram_account_profile`](https://clip-pub.bzine.co/docs/tools/catalog-instagram-account-profile.md?lang=ko)