# 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_id。デフォルトでは先頭 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=ja)
- [`solari_instagram_content_batch`](https://solari.sh/docs/tools/instagram-content-batch.md?lang=ja)
- [`solari_instagram_brand_ad_posts`](https://solari.sh/docs/tools/instagram-brand-ad-posts.md?lang=ja)