# solari catalog instagram account search

> 収集済みの Instagram アカウントを、ユーザー名・名前・プロフィール文の語句で探します。account_id を調べるときに使います。

- **CLI**: `solari catalog instagram account search`
- **MCP ツール**: `solari_catalog_instagram_account_search`
- **アクセス権**: `solari:read`
- **対象プラン**: 無料トライアル · Plus · Pro · Enterprise
- **クレジット**: 1

SOLARI が収集した Instagram アカウントを、ユーザー名・表示名・プロフィール文の語句で検索します。Instagram 本体の検索ではありません。ここで得た account_id を、ほかの Instagram ツールに渡します。

**どんなときに使うか** — 名前やユーザー名はわかっていて、account_id がまだないとき。

**返される内容** — 条件に合うアカウント。近いものから順に並びます。

## パラメータ

- `query` (string, 必須) — ユーザー名か表示名。query_type=bio のときはプロフィール文の語句。
- `query_type` (enum, 任意, 既定値 "auto") — 検索する対象。ユーザー名・表示名・プロフィール文、またはそのすべて（auto）。 値: `auto`, `username`, `full_name`, `bio`.
- `brands_only` (boolean, 任意, 既定値 false) — 既知のブランドアカウントだけを返します。ブランドを調べるときはオンにしてください。
- `limit` (integer, 任意, 既定値 8, 1–50) — 返すアカウントの件数。
- `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) — プロフィール文。
- `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://clip-pub.bzine.co/docs/tools/catalog-instagram-account-profile.md?lang=ja)
- [`solari_catalog_instagram_account_posts`](https://clip-pub.bzine.co/docs/tools/catalog-instagram-account-posts.md?lang=ja)
- [`solari_catalog_tiktok_account_search`](https://clip-pub.bzine.co/docs/tools/catalog-tiktok-account-search.md?lang=ja)