# solari insight instagram account discover

> Find Instagram creators that fit a campaign brief.

- **CLI**: `solari insight instagram account discover`
- **MCP ツール**: `solari_insight_instagram_account_discover`
- **アクセス権**: `solari:read` — トライアルを含むすべての SOLARI プランで利用できます。成功した呼び出し 1 回につき 1 クレジットです。
- **対象プラン**: Any paid plan or trial
- **クレジット**: 1

Build a creator shortlist from a brief: what they post about, what their bio says, who they resemble, whether they're growing, and what they've advertised before. Filter by followers and 3-month views, and drop anyone matching excluded keywords.

**どんなときに使うか** — When you need creators you don't know yet. If you already have a name, use catalog account search.

**何が返るか** — A search_id, the total found, a preview of top usernames, and the result sections. Page the full list with discover results.

## パラメータ

- `intent` (string, 必須, ≤ 300 chars) — The brief in one sentence. It becomes the result label.
- `topic_keywords` (string[], 任意, 1–3 items) — 2–3 phrases about the content, in the target market's language. Multi-word phrases work better.
- `profile_keywords` (string[], 任意, 1–2 items) — 1–2 phrases to look for in bios, such as a job title or niche.
- `similar_username` (string, 任意, ≤ 64 chars) — A reference creator's username. Adds creators like them.
- `trending` (boolean, 任意, 既定値 false) — Also add creators whose views are growing fast.
- `product_query` (string, 任意, ≤ 200 chars) — Short English product description. Favors creators who advertised something similar.
- `follower_min` (integer, 任意, ≥ 0) — Minimum followers.
- `follower_max` (integer, 任意, ≥ 0) — Maximum followers.
- `total_views_min` (integer, 任意, ≥ 0) — Minimum total views over the last 3 months.
- `total_views_max` (integer, 任意, ≥ 0) — Maximum total views over the last 3 months.
- `median_views_min` (integer, 任意, ≥ 0) — Minimum median views per post over the last 3 months.
- `median_views_max` (integer, 任意, ≥ 0) — Maximum median views per post over the last 3 months.
- `negative_keywords` (string[], 任意, 1–10 items) — Drop creators whose bio or posts contain any of these.
- `media_focus` (enum, 任意, 既定値 "balanced") — Favor photo or video posts when matching visual style. 値: `balanced`, `photo`, `video`.
- `region` (string, 任意, 既定値 "KR") — Country code such as KR, JP, or 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)$) — Brand account_id. Ranks creators by fit with the brand's audience.
- `brand_username` (string, 任意, ≤ 64 chars) — Brand username. Ignored when brand_account_id is set.
- `limit` (integer, 任意, ≥ 1) — How many top usernames to preview. The full list is always paged separately.

## レスポンス

### `Response`

- `search_id` (uuid) — Pass to discover results to page the full list.
- `intent` (string) — The brief, as the result label.
- `total` (integer) — Creators found.
- `top_usernames` (string[]) — Preview of the best matches, best first.
- `sections` (object[]) — How the results are grouped.
- `duration_ms` (integer) — How long the search took.
- `next` (string) — Command that pages the full list.

### `sections[]`

- `type` (string) — best_match for the strongest fits, full_results for the rest.
- `label` (string) — Display label.
- `count` (integer) — Creators in the section's first page.
- `has_more` (boolean) — Whether the section continues past its first page.

## 例

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

## 注意点

- Give at least one of topic_keywords, profile_keywords, similar_username, product_query, or trending=true.
- A broad brief can take up to a minute.
- The search_id stays valid, so you can re-sort or page later without searching again.

## 関連ツール

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