# 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=ko)
- [`solari_instagram_content_rising`](https://solari.sh/docs/tools/instagram-content-rising.md?lang=ko)