# 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 に直接問い合わせて探します。カタログのアカウント検索は収集済みのアカウントしか対象にしません。このツールはそれ以外のアカウントも見つけ、どれが収集済みかも示します。

**どんなときに使うか** — カタログのアカウント検索で名前が見つからないとき、または取り込む前に正確なハンドルを確認したいとき。

**返される内容** — 最大 50 件のアカウント（Instagram の並び順）。カタログにあるアカウントには 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=ja)
- [`solari_fetch_instagram_account`](https://clip-pub.bzine.co/docs/tools/fetch-instagram-account.md?lang=ja)
- [`solari_catalog_instagram_account_profile`](https://clip-pub.bzine.co/docs/tools/catalog-instagram-account-profile.md?lang=ja)