# solari insight instagram content aggregate

> Instagram の投稿を数えるときに使います。

- **CLI**: `solari insight instagram content aggregate`
- **MCP ツール**: `solari_insight_instagram_content_aggregate`
- **アクセス権**: `solari:read`
- **対象プラン**: 無料トライアル · Plus · Pro · Enterprise
- **クレジット**: 1

収集済みの投稿を、アカウント・形式・ハッシュタグ・メンション・キーワード別に集計します。数値で答える必要がある質問に使います。

**どんなときに使うか** — 投稿量や平均値、どのハッシュタグが多いかを知りたいとき。投稿そのものが必要な場合は、コンテンツ検索を使います。

**返される内容** — グループごとの件数（多い順）。追加の指標は指定した場合のみ返します。

## パラメータ

- `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 の username のみ。
- `hashtags` (string[], 任意) — 指定したハッシュタグをすべて含む投稿のみ。
- `mentions` (string[], 任意) — 指定した username をすべてメンションしている投稿のみ。
- `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, 任意, 既定値 20, 1–50) — 返すグループの数。

## レスポンス

### `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 を省略した場合は全体の合計 1 件。
- `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
  }
}
```

## 注意点

- ほかの指標を指定しない限り、値が入るのは post_count だけです。
- 対象は KR・JP・US・TW の直近およそ 6 か月です。それより前の since は、扱える最も古い日付に合わせます。
- interval だけを指定すると、期間ごとに 1 つの区間を作ります。group_by と組み合わせると、グループごとに時系列が付きます。

## 関連ツール

- [`solari_catalog_instagram_content_search`](https://clip-pub.bzine.co/docs/tools/catalog-instagram-content-search.md?lang=ja)
- [`solari_insight_tiktok_content_aggregate`](https://clip-pub.bzine.co/docs/tools/insight-tiktok-content-aggregate.md?lang=ja)