# solari instagram account search

> ブランド名・クリエイター名やプロフィール bio の語句を Instagram の account_id に変換します。

- **CLI**: `solari instagram account search`
- **MCP ツール**: `solari_instagram_account_search`
- **アクセス権**: `solari:read` — サインイン済みの SOLARI アカウントであれば利用できます。

ブランド名・クリエイター名または Instagram ハンドルを、追跡中のアカウント候補に解決し、プロフィールの bio テキストも検索します。高速で決定的なインデックス検索を使い、typeahead のように候補をすべて返します。query_type で何を照合するかを選べます — auto（既定）はハンドルを前方一致、プロフィールの表示名（韓国語または英語）をテキスト一致で同時に見ます。username と full_name はそのどちらか一方に絞り、bio はプロフィールの bio テキストを全文検索します。bio モードは、名前ではなくアカウントが自分をどう説明しているかで探す方法です（"skincare"、"협찬 문의"、"コスメ"）。一致の質とフォロワー数でランク付けします。found と、最良のものから順に並んだ items（items[0] が最上位の一致）を返します。各 item は 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) — 候補が1件以上一致した場合に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 がすでに追跡しているアカウントで、10 件に 1 件ほどは bio がありません。網羅的な調査ではなく、発見のための手段としてお使いください。
- region は結果をそのリージョンに絞り、ほかのアカウントをすべて除外します。特定の国を求められた場合以外は未設定のままにしてください。

## 関連ツール

- [`solari_instagram_account_profile`](https://solari.sh/docs/tools/instagram-account-profile.md?lang=ja)
- [`solari_instagram_account_posts`](https://solari.sh/docs/tools/instagram-account-posts.md?lang=ja)
- [`solari_tiktok_account_search`](https://solari.sh/docs/tools/tiktok-account-search.md?lang=ja)