# solari insight instagram content trend clusters

> 주제별로 묶은 Instagram 트렌드.

- **CLI**: `solari insight instagram content trend clusters`
- **MCP 도구**: `solari_insight_instagram_content_trend_clusters`
- **권한**: `solari:read`
- **이용 가능 플랜**: 무료 체험 · Plus · Pro · Enterprise
- **크레딧**: 1

지정한 지역의 트렌드 요약입니다. 이름 붙은 주제마다 규모, 변화, 대표 게시물 몇 개가 들어 있습니다.

**언제 쓰나요** — 게시물 목록보다 지금 흐름의 큰 그림이 필요할 때.

**돌려주는 값** — 이름 붙은 묶음과 묶음에 속한 게시물 미리보기.

## 파라미터

- `region` (string, 선택, 기본값 "KR") — KR, JP 같은 국가 코드.
- `since_days` (integer, 선택, 기본값 7, 1–90) — 며칠 전까지 거슬러 볼지.
- `limit` (integer, 선택, 기본값 20, 1–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. 넣으면 이 브랜드에 맞춰 묶음 순위를 매깁니다.
- `username` (string, 선택, ≤ 64 chars) — 브랜드 username. 넣으면 이 브랜드에 맞춰 묶음 순위를 매깁니다. account_id가 있으면 무시합니다.
- `brand_aware` (boolean, 선택, 기본값 true) — 브랜드에 맞춰 묶음 순위를 매길지. 브랜드를 넣으면 기본으로 켜집니다.

## 응답

### `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 insight 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_insight_instagram_content_trend_clusters",
  "arguments": {
    "region": "KR",
    "since_days": 7,
    "limit": 2
  }
}
```

## 주의사항

- 호출이 최대 2분까지 걸릴 수 있습니다.
- 브랜드를 넣으면 그 브랜드에 맞춰 묶음 순위를 매깁니다. 원래 순서를 유지하려면 brand_aware=false로 두세요.

## 관련 도구

- [`solari_insight_instagram_content_trending`](https://clip-pub.bzine.co/docs/tools/insight-instagram-content-trending.md?lang=ko)
- [`solari_insight_instagram_content_rising`](https://clip-pub.bzine.co/docs/tools/insight-instagram-content-rising.md?lang=ko)