# solari instagram account collabs

> クリエイターがどのブランドの広告を行ってきたかを、ブランド単位でまとめたもの。

- **CLI**: `solari instagram account collabs`
- **MCP ツール**: `solari_instagram_account_collabs`
- **アクセス権**: `solari:read` — サインイン済みの SOLARI アカウントであれば利用できます。

1人のクリエイターが指定した月数の期間内に行った直近の広告コラボレーション。各アイテムは対象ブランド（target_account_id、target_username）で、collab_count、last_posted_at、サンプルのコラボレーション投稿を持ちます。items、has_more、totalを返します。limit/offsetでページングします。クリエイターはaccount_id（SOLARIアカウントUUID）またはusername（Instagramハンドル）で指定します。未知の参照はnot-foundエラーを返します。ブランド側から見た対の関係にあるのがsolari_instagram_brand_top_collaborators。サインイン済みのSOLARIアカウントであれば利用できます。

**どんなときに使うか** — 「このクリエイターは誰と組んでいるか」。ブランド側から見た対の関係にあるのがbrand top collaborators。

**何が返るか** — 対象ブランドごとに1行。各行はサンプルのコラボレーション投稿を持ちます。

## パラメータ

- `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（SOLARIアカウントUUID）。これかusernameのいずれかを指定してください。
- `username` (string, 任意, ≤ 64 chars) — Instagramハンドル。先頭の@はあってもなくてもかまいません。account_idが指定されている場合は無視されます。
- `months` (integer, 任意, ≥ 1) — 遡及期間（月数）。デフォルトは3。12を超える値は12に上限で切り詰められます。
- `limit` (integer, 任意, ≥ 1) — 1ページあたりのアイテムの最大数。デフォルトは5。200を超える値は200に上限で切り詰められます。
- `offset` (integer, 任意, 既定値 0, ≥ 0) — ページネーションのオフセット。デフォルトは0。

## レスポンス

### `Response`

- `total` (integer) — フィルタに一致した総行数。
- `has_more` (boolean) — offset + limitより先に行が存在するかどうか。
- `items` (object[]) — コラボレーションの集計。対象ブランドごとに1件。

### `items[]`

- `target_account_id` (uuid) — 対象ブランドのaccount_id。
- `target_username` (string) — 対象ブランドのハンドル。
- `collab_count` (integer) — このブランドとのコラボレーション投稿数。
- `last_posted_at` (timestamp) — 直近のコラボレーション。
- `post_id / slug` (string) — サンプル投稿の識別子。
- `text` (string) — サンプル投稿のキャプション。
- `like_count / play_count` (integer) — サンプル投稿のエンゲージメント。
- `media_type` (string) — サンプル投稿のフォーマット。
- `thumbnail_url / media_url` (string) — サンプル投稿のメディア。
- `bio` (string) — 対象ブランドのプロフィール文。

## 例

```console
$ solari instagram account collabs username=beinny_motd months=6 limit=3
```

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

```json
{
  "items": [
    {
      "post_id": "01a05575-7c9b-7232-8519-4a38fa061389",
      "target_user_id": "018cab85-8ef8-7dc9-ab0a-7044d463f65e",
      "target_username": "dasique_official",
      "collab_count": 2,
      "last_posted_at": "2026-08-30T05:08:56+00:00",
      "slug": "DcpugJ2kzv8",
      "text": "#광고 무겁지 않은 가을 데일리 팔레트 로즈밀크티 . .🫖🤎\n차분하고 미지근한 로즈핑크 팔레트인데\n부드러운 밀크티 무드라서 분위기가 넘 예뻐요..🥺\n\n데이지크에서 올리브영 X 산리오 콜라보\n시티팝 에디션으로 미니섀도우팔레트 4종이 출시되는데\n그 중 자주 추천드렸던 로즈밀크티, 밀크라떼가 있더라구요 !\n\nNEW 컬러 피치레코드, 모브카세트도 출시되어요🤍\n도시의 아침과 저녁 무드를 담은 데일리한 …",
      "play_count": 0,
      "media_type": "8",
      "like_count": 878,
      "video_media_count": 0,
      "media_count": 15,
      "bio": "🫒올영세일 08.30 – 09.05\nUP TO 37% SALE\n올리브영X산리오,\n🌠데이지크 🆕 미니 섀도우",
      "thumbnail_url": "https://bzine.co/cdn-cgi/image/fit=scale-down,width=480/https://smr-images-c.bzine.co/users/018ecc75-55d8-70a7-a348-d370aa504ed9/posts/01a05575-7c9b-7232-8519-4a38fa061389/medias/01a05575-7dd3-779e-9050-a6cb59578cb9.jpg",
      "media_url": "https://bzine.co/cdn-cgi/image/fit=scale-down,width=480/https://smr-images-c.bzine.co/users/018ecc75-55d8-70a7-a348-d370aa504ed9/posts/01a05575-7c9b-7232-8519-4a38fa061389/medias/01a05575-7dd3-779e-9050-a6cb59578cb9.jpg",
      "target_account_id": "018cab85-8ef8-7dc9-ab0a-7044d463f65e"
    },
    "… 2 more"
  ],
  "has_more": true,
  "total": 7
}
```

## MCP 呼び出しとして

```json
{
  "name": "solari_instagram_account_collabs",
  "arguments": {
    "username": "beinny_motd",
    "months": 6,
    "limit": 3
  }
}
```

## 注意点

- target_user_idはtarget_account_idと同じ値の旧名称。新しいコードではtarget_account_idを読んでください。
- monthsのデフォルトは3で、12に上限で切り詰められます。
- ブランド単位の集計ではなく行単位の履歴が必要な場合は、account ad postsをお使いください。

## 関連ツール

- [`solari_instagram_account_ad_posts`](https://solari.sh/docs/tools/instagram-account-ad-posts.md?lang=ja)
- [`solari_instagram_brand_top_collaborators`](https://solari.sh/docs/tools/instagram-brand-top-collaborators.md?lang=ja)