# solari instagram content trend clusters

> SOLARIのトレンドダイジェスト。直近のコンテンツを名前付きのテーマにまとめたもの。

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

SOLARIのトレンドダイジェスト。リージョンごとの直近のコンテンツトレンドクラスタを、クラスタのメタデータと所属投稿とともに返します。ブランドのaccount_idまたはusernameを渡した場合は、ブランド親和性で再ランキングできます。サインイン済みの SOLARI アカウントであれば利用できます。

**どんなときに使うか** — 個別の投稿ではなく、今の全体像を読むとき。

**何が返るか** — 名前付きクラスタ。規模、変化、所属投稿のプレビューを含みます。

## パラメータ

- `region` (string, 任意, 既定値 "KR") — リージョンコード。KR、JP、USなど。
- `since_days` (integer, 任意, 既定値 7, 1–90) — トレンドクラスタの遡及期間（日数）。1〜90の範囲。
- `limit` (integer, 任意, ≥ 1) — 返されるトレンドクラスタの最大数。デフォルトは20。24を超える値は24に上限で切り詰められます。
- `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` (string, 任意, ≤ 64 chars) — ブランド親和性による再ランキング用のブランドのInstagramハンドル。省略可。account_idが指定されている場合は無視されます。
- `brand_aware` (boolean, 任意, 既定値 true) — account_idが指定されている場合に、ブランド親和性でクラスタを再ランキングします。

## レスポンス

### `Response`

- `success` (boolean) — ダイジェストが生成されたかどうか。
- `trend_count` (integer) — 返されたクラスタ数。
- `header_text` (string) — ダイジェストの見出し。
- `region / since_days` (string · integer) — 適用されたリージョンと遡及期間。
- `brand_aware` (boolean) — ブランド親和性の再ランキングが要求されたかどうか。
- `als_applied` (boolean) — 親和性モデルが実際に実行されたかどうか。
- `trends` (object[]) — クラスタ。

### `trends[]`

- `cluster_id` (string) — クラスタのid。
- `name` (string) — クラスタ名。
- `bullets` (string[]) — クラスタを説明する文。
- `count` (integer) — 所属する投稿数。
- `count_delta` (integer) — 前の期間と比べた所属投稿数の変化。
- `growth_pct` (number) — 成長率（パーセント）。
- `avg_play_delta` (number) — 平均再生数の変化。
- `distinct_creators` (integer) — クラスタに寄与しているクリエイター数。
- `creator_delta` (integer) — クリエイター数の変化。
- `is_new` (boolean) — そのクラスタが今期に初めて現れたかどうか。
- `member_thumbnails` (object[]) — 所属投稿のサムネイルプレビュー。

## 例

```console
$ solari instagram content trend clusters region=KR since_days=7 limit=2
```

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

```json
{
  "success": true,
  "trend_count": 2,
  "header_text": "최근 7일 인기 트렌드 2개 (브랜드 컨텍스트 없음)",
  "brand_aware": true,
  "als_applied": false,
  "region": "KR",
  "since_days": 7,
  "directive": null,
  "trends": [
    {
      "cluster_id": "01a05857-7727-74d8-8da5-4e95981aca8d",
      "name": "GV90의 미래형 하이테크 기능",
      "bullets": [
        "화면이 회전하거나 시트가 뒤로 돌아가는 등 물리적으로 변형되는 자동차 내부 장치들을 직접 시연함",
        "… 1 more"
      ],
      "count": 7,
      "count_delta": 0,
      "growth_pct": 0,
      "avg_play_delta": 0,
      "creator_delta": 0,
      "distinct_creators": 3,
      "is_new": false,
      "early_zone_creator_count": null,
      "early_zone_creator_ratio": null,
      "als_member_count": null,
      "mean_als_score": null,
      "annotation": null,
      "group": null,
      "member_thumbnails": [
        {
          "post_id": "01a030df-c4b3-739c-9214-44b3b9463c7b",
          "thumbnail_url": "https://bzine.co/cdn-cgi/media/width=480,mode=frame,time=100ms/https://smr-images-c.bzine.co/users/018cb4c9-da89-7b02-8efd-53ccb65c26c9/posts/01a030df-c4b3-739c-9214-44b3b9463c7b/medias/01a030df-c7c3-788e-8775-1096728e07 …",
          "slug": "DcP6jgRMTRv",
          "username": "sol.bpd",
          "media_url": "https://smr-images-c.bzine.co/users/018cb4c9-da89-7b02-8efd-53ccb65c26c9/posts/01a030df-c4b3-739c-9214-44b3b9463c7b/medias/01a030df-c7c3-788e-8775-1096728e07f2.mp4",
          "media_type": "video",
          "play_count": 1947419,
          "posted_at": "2026-08-20T04:37:17+00:00"
        },
        "… 3 more"
      ]
    },
    "… 1 more"
  ],
  "insights": null,
  "insight_query": null
}
```

## MCP 呼び出しとして

```json
{
  "name": "solari_instagram_content_trend_clusters",
  "arguments": {
    "region": "KR",
    "since_days": 7,
    "limit": 2
  }
}
```

## 注意点

- 重い呼び出し。ゲートウェイは120秒まで許容します。
- since_daysは1〜90。limitは24に上限で切り詰められます。
- ブランドを渡すとbrand_awareの再ランキングが有効になります。元の並び順のままにするにはbrand_aware=falseを指定してください。

## 関連ツール

- [`solari_instagram_content_trending`](https://solari.sh/docs/tools/instagram-content-trending.md?lang=ja)
- [`solari_instagram_content_rising`](https://solari.sh/docs/tools/instagram-content-rising.md?lang=ja)