# 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, 찾은 전체 수, 상위 username 미리보기, 결과 섹션. 전체 목록은 discover results 도구로 페이지를 넘겨 보세요.

## 파라미터

- `intent` (string, 필수, ≤ 300 chars) — 브리프를 한 문장으로. 결과 이름으로 쓰입니다.
- `topic_keywords` (string[], 선택, 1–3 items) — 콘텐츠에 관한 문구 2~3개. 타깃 시장의 언어로 쓰세요. 여러 단어로 된 문구가 더 잘 맞습니다.
- `profile_keywords` (string[], 선택, 1–2 items) — 소개글에서 찾을 문구 1~2개. 직업명이나 분야 같은 것.
- `similar_username` (string, 선택, ≤ 64 chars) — 참고할 크리에이터의 username. 그 크리에이터와 비슷한 크리에이터를 더합니다.
- `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) — 소개글이나 게시물에 이 단어가 하나라도 있으면 뺍니다.
- `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) — 미리보기로 보여 줄 상위 username 수. 전체 목록은 늘 따로 페이지로 받습니다.

## 응답

### `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) — 섹션이 첫 페이지 뒤로 더 이어지는지 여부.

## 예시

```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분쯤 걸릴 수 있습니다.
- search_id는 계속 쓸 수 있습니다. 나중에 다시 검색하지 않고 정렬을 바꾸거나 페이지를 넘길 수 있습니다.

## 관련 도구

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