# solari insight instagram account discover

> キャンペーンのブリーフに合う Instagram クリエイターを探します。

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

ブリーフをもとにクリエイターの候補リストを作ります。条件にできるのは、投稿の内容、プロフィール文、似ているクリエイター、伸びているかどうか、過去に広告を出した商品です。フォロワー数と 3 か月の再生回数で絞り込み、除外キーワードに当てはまるクリエイターは外せます。

**どんなときに使うか** — まだ知らないクリエイターを探したいとき。名前がわかっているなら catalog account search を使います。

**返される内容** — search_id、見つかった総数、上位のユーザー名のプレビュー、結果のセクション。全件は discover results でページごとに取得します。

## パラメータ

- `intent` (string, 必須, ≤ 300 chars) — ブリーフを 1 文で。結果のラベルとして使われます。
- `topic_keywords` (string[], 任意, 1–3 items) — 投稿の内容を表す 2〜3 個のフレーズ。対象市場の言語で書きます。複数の単語からなるフレーズのほうが精度が上がります。
- `profile_keywords` (string[], 任意, 1–2 items) — プロフィール文で探す 1〜2 個のフレーズ。職業名や得意ジャンルなど。
- `similar_username` (string, 任意, ≤ 64 chars) — 参考にするクリエイターのユーザー名。そのクリエイターに似たクリエイターを追加します。
- `trending` (boolean, 任意, 既定値 false) — 再生回数が急上昇しているクリエイターも追加します。
- `product_query` (string, 任意, ≤ 200 chars) — 商品の短い説明（英語）。似た商品を広告したことのあるクリエイターを優先します。
- `follower_min` (integer, 任意, ≥ 0) — フォロワー数の下限。
- `follower_max` (integer, 任意, ≥ 0) — フォロワー数の上限。
- `total_views_min` (integer, 任意, ≥ 0) — 直近 3 か月の再生回数の合計の下限。
- `total_views_max` (integer, 任意, ≥ 0) — 直近 3 か月の再生回数の合計の上限。
- `median_views_min` (integer, 任意, ≥ 0) — 直近 3 か月の投稿あたりの再生回数の中央値の下限。
- `median_views_max` (integer, 任意, ≥ 0) — 直近 3 か月の投稿あたりの再生回数の中央値の上限。
- `negative_keywords` (string[], 任意, 1–10 items) — プロフィール文か投稿にこれらの語句が 1 つでも含まれるクリエイターを除きます。
- `media_focus` (enum, 任意, 既定値 "balanced") — 見た目のスタイルを照合するとき、写真と動画のどちらの投稿を重視するか。 値: `balanced`, `photo`, `video`.
- `region` (string, 任意, 既定値 "KR") — KR, JP, US などの国コード。
- `brand_account_id` (string, 任意, uuid, pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$) — ブランドの account_id。ブランドのオーディエンスとの相性でクリエイターを順位付けします。
- `brand_username` (string, 任意, ≤ 64 chars) — ブランドのユーザー名。brand_account_id を指定した場合は無視されます。
- `limit` (integer, 任意, 既定値 20, 1–60) — プレビューに含める上位ユーザー名の件数。全件の一覧は常に別途ページごとに取得します。

## レスポンス

### `Response`

- `search_id` (uuid) — discover results に渡すと、全件の一覧をページごとに取得できます。
- `intent` (string) — 結果のラベルとして使うブリーフ。
- `total` (integer) — 見つかったクリエイターの数。
- `top_usernames` (string[]) — 最も合うクリエイターのプレビュー。合う順に並びます。
- `sections` (object[]) — 結果のグループ分け。
- `duration_ms` (integer) — 検索にかかった時間。
- `next` (string) — 全件の一覧をページごとに取得するコマンド。

### `sections[]`

- `type` (string) — 最も合うクリエイターは best_match、それ以外は full_results。
- `label` (string) — 表示用のラベル。
- `count` (integer) — そのセクションの最初のページに含まれるクリエイター。
- `has_more` (boolean) — そのセクションに 2 ページ目以降があるかどうか。

## 例

```console
$ solari insight instagram account discover intent="KR makeup creators for an autumn eyeshadow palette launch" topic_keywords='["가을 메이크업 팔레트","데일리 아이섀도우"]' follower_min=10000 follower_max=300000 region=KR limit=5
```

_読みやすさのため、長い文字列と繰り返しの配列要素を省略しています。_

```json
{
  "search_id": "01a0f3c2-7e41-7b9a-8d2c-5e6f1a9b3c47",
  "intent": "KR makeup creators for an autumn eyeshadow palette launch",
  "total": 184,
  "top_usernames": [
    "beinny_motd",
    "donge_cos",
    "… 18 more"
  ],
  "sections": [
    {
      "type": "best_match",
      "label": "베스트 매칭",
      "count": 12,
      "has_more": false
    },
    {
      "type": "full_results",
      "label": "전체 결과",
      "count": 48,
      "has_more": true
    }
  ],
  "duration_ms": 23871,
  "next": "solari insight instagram account discover results search_id=01a0f3c2-7e41-7b9a-8d2c-5e6f1a9b3c47"
}
```

## MCP で呼び出す場合

```json
{
  "name": "solari_insight_instagram_account_discover",
  "arguments": {
    "intent": "KR makeup creators for an autumn eyeshadow palette launch",
    "topic_keywords": [
      "가을 메이크업 팔레트",
      "데일리 아이섀도우"
    ],
    "follower_min": 10000,
    "follower_max": 300000,
    "region": "KR",
    "limit": 5
  }
}
```

## 注意点

- topic_keywords, profile_keywords, similar_username, product_query, trending=true のうち、少なくとも 1 つを指定してください。
- 条件が広いと、最大 1 分ほどかかることがあります。
- search_id は有効なまま残ります。あとから検索し直さずに、並べ替えやページ移動ができます。

## 関連ツール

- [`solari_insight_instagram_account_discover_results`](https://clip-pub.bzine.co/docs/tools/insight-instagram-account-discover-results.md?lang=ja)
- [`solari_catalog_instagram_account_search`](https://clip-pub.bzine.co/docs/tools/catalog-instagram-account-search.md?lang=ja)
- [`solari_insight_instagram_ranking_creators`](https://clip-pub.bzine.co/docs/tools/insight-instagram-ranking-creators.md?lang=ja)