# solari instagram brand overview

> 브랜드 프로필과 광고 발자취를 나타내는 id 목록.

- **CLI**: `solari instagram brand overview`
- **MCP 도구**: `solari_instagram_brand_overview`
- **권한**: `solari:read` — 로그인한 SOLARI 계정이면 쓸 수 있어요.

브랜드의 프로필과 광고 협업 발자취를 반환해요: 그 브랜드를 타깃으로 광고 포스트를 만든 크리에이터 ID와 광고 포스트 ID 자체 (기본은 상위 20개 프리뷰에 전체 개수가 함께 실리며, full=true로 설정하면 각각 최대 100개까지 전체 목록을 받아요). 포스트 ID는 solari_instagram_content_batch에 넣어 내용을 채우세요. UUID가 아니라 브랜드의 Instagram 핸들(@ 없이)을 받아요. 로그인한 SOLARI 계정이면 누구나 사용할 수 있어요. 추적 중이 아닌 핸들이면 404를 반환해요.

**언제 쓰나** — 브랜드 분석의 출발점. 포스트 id는 content batch에 넣어 내용을 채우세요.

**무엇이 돌아오나** — 브랜드 프로필, 그리고 그 브랜드를 태그한 크리에이터와 포스트의 id.

## 파라미터

- `username` (string, 필수) — 앞의 @를 뺀 브랜드 Instagram 핸들.
- `full` (boolean, 선택, 기본값 false) — 상위 20개 프리뷰 대신 전체 ID 목록을 반환해요.

## 응답

### `Response`

- `information` (object) — 브랜드 프로필: user_id, username, full_name, bio, follower_count.
- `all_influencers_id` (uuid[]) — 그 브랜드의 광고를 만든 크리에이터의 account_ids. 기본은 상위 20개.
- `all_influencers_count` (integer) — 잘리기 전 전체 크리에이터 수.
- `all_influencers_truncated` (boolean) — 목록이 프리뷰일 때 true.
- `all_campaign_posts_id` (uuid[]) — 광고 포스트 id. 기본은 상위 20개.
- `all_campaign_posts_count` (integer) — 잘리기 전 전체 포스트 수.
- `all_campaign_posts_truncated` (boolean) — 목록이 프리뷰일 때 true.

## 예시

```console
$ solari instagram brand overview username=innisfreeofficial
```

_읽기 편하도록 긴 문자열과 반복되는 배열 항목을 줄였어요._

```json
{
  "information": {
    "user_id": "018cabce-14cc-7544-8890-7811ec33ef74",
    "username": "innisfreeofficial",
    "full_name": "INNISFREE | 이니스프리",
    "bio": "NATURE MEETS KOREAN SKIN SCIENCE",
    "follower_count": 847619,
    "brand_id": null
  },
  "all_influencers_id": [
    "01935f3d-8188-727e-a0bb-09e54aadfdac",
    "018caf6e-abfd-73da-88ad-11a56c39358b",
    "019a0061-b1d4-7adb-8ea4-1c5572dca38c",
    "… 17 more"
  ],
  "all_campaign_ids": [],
  "all_campaign_posts_id": [
    "019f505f-f8be-7e88-ae08-6fba999950b1",
    "019f5060-3449-779e-a08b-d6d49add90cd",
    "019f4342-3357-7418-916c-da1c44468308",
    "… 17 more"
  ],
  "post_id_to_campaign_id": {},
  "all_influencers_count": 93,
  "all_influencers_truncated": true,
  "all_campaign_posts_count": 100,
  "all_campaign_posts_truncated": true
}
```

## MCP 호출로 쓰면

```json
{
  "name": "solari_instagram_brand_overview",
  "arguments": {
    "username": "innisfreeofficial"
  }
}
```

## 주의사항

- full=true는 전체 목록을 반환하지만 각각 100개에서 상한이 걸려요. 정확한 총계가 필요하면 id를 세지 말고 brand ad stats를 사용하세요.
- 핸들만 받아요 — 여기서는 account_id UUID를 받지 않아요.
- 추적 중이 아닌 핸들은 404를 반환해요.

## 관련 도구

- [`solari_instagram_brand_ad_stats`](https://solari.sh/docs/tools/instagram-brand-ad-stats.md?lang=ko)
- [`solari_instagram_content_batch`](https://solari.sh/docs/tools/instagram-content-batch.md?lang=ko)
- [`solari_instagram_brand_ad_posts`](https://solari.sh/docs/tools/instagram-brand-ad-posts.md?lang=ko)