# solari insight instagram content aggregate

> Instagram 포스트 개수를 셀 때 사용해요.

- **CLI**: `solari insight instagram content aggregate`
- **MCP 도구**: `solari_insight_instagram_content_aggregate`
- **권한**: `solari:read` — 로그인한 SOLARI 계정이면 쓸 수 있어요.
- **Required plan**: Free
- **Credit**: 0

계정, 형식, 해시태그, 멘션, 키워드별로 포스트 수를 더해요. 숫자가 답인 질문에 쓰면 돼요.

**언제 쓰나** — 규모, 평균, 어떤 해시태그가 앞서는지가 필요할 때 사용해요. 포스트 자체는 content search예요.

**무엇이 나오나** — 그룹별 개수예요. 큰 그룹이 먼저 와요. 다른 지표는 요청한 것만 채워져요.

## 파라미터

- `region` (enum, 선택, 기본값 "KR") — KR, JP, US, TW 값: `KR`, `JP`, `US`, `TW`.
- `group_by` (enum, 선택) — 개수를 어떻게 나눌지 값: `account`, `post_type`, `hashtag`, `mention`, `caption_keyword`, `transcription_keyword`.
- `interval` (enum, 선택) — 이 달력 간격으로 시계열을 붙여요 값: `day`, `week`, `month`.
- `metrics` (string[], 선택) — post_count 외에 받을 지표 값: `like_sum`, `like_avg`, `comment_sum`, `comment_avg`, `view_sum`, `view_avg`, `follower_avg`, `account_count`.
- `query` (string, 선택) — 캡션과 대본에서 찾을 키워드
- `usernames` (string[], 선택) — 이 Instagram 사용자명만
- `hashtags` (string[], 선택) — 이 해시태그를 모두 가진 포스트만
- `mentions` (string[], 선택) — 이 사용자명을 모두 멘션한 포스트만
- `post_types` (string[], 선택) — 이 형식만
- `since` (string, 선택, pattern ^\d{4}-\d{2}-\d{2}$) — 이 UTC 날짜 이후 포스트만 (YYYY-MM-DD)
- `until` (string, 선택, pattern ^\d{4}-\d{2}-\d{2}$) — 이 UTC 날짜 이전 포스트만 (YYYY-MM-DD)
- `limit` (integer, 선택, ≥ 1) — 그룹을 몇 개까지 줄지

## 응답

### `Response`

- `region` (string) — 집계한 국가예요
- `since` (date) — 실제로 쓴 시작 날짜예요
- `until` (date | null) — 실제로 쓴 끝 날짜예요
- `group_by` (string | null) — 이번에 쓴 묶음 기준이에요
- `interval` (string | null) — 이번에 쓴 시간 간격이에요
- `total_posts` (integer) — 필터에 맞는 포스트예요
- `truncated` (boolean) — 그룹이 limit보다 많으면 true예요
- `buckets` (object[]) — 그룹이에요. 큰 그룹이 먼저 와요

### `buckets[]`

- `key` (string) — 그룹 값이에요. group_by가 없으면 합계 하나예요
- `metrics.post_count` (integer) — 포스트 수예요. 항상 있어요
- `metrics.like_sum / like_avg` (number | null) — 좋아요 합계와 평균이에요. 요청한 경우에만 와요
- `metrics.comment_sum / comment_avg` (number | null) — 댓글 합계와 평균이에요. 요청한 경우에만 와요
- `metrics.view_sum / view_avg` (number | null) — 조회 합계와 평균이에요. 요청한 경우에만 와요
- `metrics.share_sum / collect_sum` (number | null) — TikTok 전용이에요. 여기선 항상 null이에요
- `metrics.follower_avg` (number | null) — 작성자 팔로워 수의 평균이에요
- `metrics.account_count` (integer | null) — 그룹 안의 서로 다른 계정 수예요
- `series` (object[] | null) — 기간별 내역이에요. interval을 넣은 경우에만 와요

## 예시

```console
$ solari insight instagram content aggregate group_by=hashtag query="이니스프리" metrics='["like_avg","view_sum","account_count"]' limit=5
```

_읽기 편하도록 긴 문자열과 반복되는 배열 항목을 줄였어요._

```json
{
  "region": "KR",
  "since": "2026-03-04",
  "until": null,
  "group_by": "hashtag",
  "interval": null,
  "total_posts": 1647,
  "truncated": true,
  "buckets": [
    {
      "key": "이니스프리",
      "metrics": {
        "post_count": 772,
        "like_sum": null,
        "like_avg": 320.7240932642487,
        "comment_sum": null,
        "comment_avg": null,
        "view_sum": 9400953,
        "view_avg": null,
        "share_sum": null,
        "share_avg": null,
        "collect_sum": null,
        "collect_avg": null,
        "follower_avg": null,
        "account_count": 587
      },
      "series": null
    },
    {
      "key": "광고",
      "metrics": {
        "post_count": 548,
        "like_sum": null,
        "like_avg": 373.04021937842776,
        "comment_sum": null,
        "comment_avg": null,
        "view_sum": 5463711,
        "view_avg": null,
        "share_sum": null,
        "share_avg": null,
        "collect_sum": null,
        "collect_avg": null,
        "follower_avg": null,
        "account_count": 381
      },
      "series": null
    },
    "… 3 more"
  ]
}
```

## MCP 호출로 쓰면

```json
{
  "name": "solari_insight_instagram_content_aggregate",
  "arguments": {
    "group_by": "hashtag",
    "query": "이니스프리",
    "metrics": [
      "like_avg",
      "view_sum",
      "account_count"
    ],
    "limit": 5
  }
}
```

## 주의사항

- metrics에 이름을 넣지 않으면 post_count만 채워져요.
- KR, JP, US, TW의 대략 최근 6개월이에요. 더 오래된 since는 잘려요.
- interval만 넣으면 기간마다 한 칸이에요. group_by와 같이 쓰면 그룹마다 시계열이 붙어요.

## 관련 도구

- [`solari_catalog_instagram_content_search`](https://solari.sh/docs/tools/catalog-instagram-content-search.md?lang=ko)
- [`solari_insight_tiktok_content_aggregate`](https://solari.sh/docs/tools/insight-tiktok-content-aggregate.md?lang=ko)