# solari fetch instagram account search

> Find accounts on Instagram by name, live.

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

Ask Instagram itself for accounts matching a name or handle fragment. Catalog account search only knows tracked accounts; this finds the rest and tells you which ones are already tracked.

**どんなときに使うか** — When catalog account search returns nothing for a name, or you need the exact handle before ingesting it.

**何が返るか** — Up to 50 accounts in Instagram's order, with account_id on the ones already in the catalog.

## パラメータ

- `query` (string, 必須, ≤ 100 chars) — Name or handle fragment, with or without @.

## レスポンス

### `Response`

- `query` (string) — The text the lookup ran on, without @.
- `items` (object[]) — Matching accounts, Instagram's order.
- `found` (integer) — Accounts returned.
- `tracked` (integer) — How many carry an account_id.

### `items[]`

- `username` (string) — Handle, lowercased.
- `full_name` (string | null) — Display name.
- `is_verified` (boolean) — Verified badge.
- `is_private` (boolean) — Private account.
- `profile_picture_url` (string | null) — Profile picture URL.
- `account_id` (uuid | null) — SOLARI account id if already tracked; null means ingest it with fetch instagram account first.

## 例

```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"
  }
}
```

## 注意点

- Nothing is stored. To bring an untracked hit into the catalog, run fetch instagram account with its username.
- Order and ranking are Instagram's, so the official account is not always first: check is_verified.
- No follower counts here; read them with catalog account profile once the account is tracked.

## 関連ツール

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