# solari instagram content batch

> 最大100件の投稿idを1回の呼び出しで取得します。

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

solari_instagram_content_detailのバッチ版。SOLARIの投稿UUIDを指定して、最大100件の投稿を1回の呼び出しで取得します。各行はslug、caption、posted_at、like/commentの各カウント、動画の場合はplay_count、投稿者のusernameとaccount_idを持ちます。未追跡のidは省かれるため、foundはリクエストした数より少なくなることがあります。solari_instagram_brand_overview（full=true）、solari_instagram_account_posts、solari_instagram_content_search、またはトレンドフィードから得たpost_idのリストを渡してください。サインイン済みのSOLARIアカウントであれば利用できます。

**どんなときに使うか** — brand overviewやトレンドフィードから得たidリストを、実際のキャプションと指標に変えるとき。

**何が返るか** — リクエストしたidのうち見つかった投稿。

## パラメータ

- `post_ids` (uuid[], 必須, 1–100 items, uuid) — 取得するSOLARIの投稿UUID。1回の呼び出しにつき最大100件。Instagramのショートコード/slugではありません。
- `sort` (enum, 任意, 既定値 "recent") — アイテムの並び順。posted_atの降順（recent）またはlike+commentのエンゲージメントの降順。 値: `recent`, `engagement`.

## レスポンス

### `Response`

- `items` (object[]) — 見つかった投稿。
- `requested` (integer) — 送信されたidの件数。
- `found` (integer) — 解決できた件数。未追跡のidは除外されるため、送信した数より少なくなることがあります。

### `items[]`

- `id` (uuid) — 投稿のid。
- `slug` (string) — Instagramのショートコード。
- `text` (string) — キャプションのテキスト。
- `posted_at` (timestamp) — 投稿日時（UTC）。
- `username / user_id / account_id` (string) — 投稿したアカウント。現行の名称はaccount_id。
- `like_count / comment_count` (integer) — エンゲージメントのスナップショット。
- `play_count` (integer | null) — 動画の再生数。
- `media_type` (string) — 投稿のフォーマット。

## 例

```console
$ solari instagram content batch post_ids='["019f505f-f8be-7e88-ae08-6fba999950b1","019f5060-3449-779e-a08b-d6d49add90cd"]'
```

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

```json
{
  "items": [
    {
      "id": "019f505f-f8be-7e88-ae08-6fba999950b1",
      "slug": "Dam_BYyJxtR",
      "text": "#광고 ₊✩‧₊˚ @innisfreeofficial ˚₊✩‧₊ \n공들인 나의 화장.. 찜통 더위에 무너져 내릴때\n이니스프리 노세범 선 파우더 하나면 고민 끝!\n\n유분 가득한 피부.. 꺼진 부위, 모공, 요철 부각되어\n10년은 늙어보이는 몰골에서 노세범 선 파우더 바르는\n즉시 핑크빛 필터를 씌운 듯~ 뽀용 피부 완성 ⭒˚.⋆\n\n노세범 맛집 답게 과다 피지와 유분을 즉각 흡착시키고\n무엇보다 가벼 …",
      "posted_at": "2026-07-10T10:34:01Z",
      "virtual_campaign": null,
      "username": "the_ketchap",
      "user_id": "018d3b53-c0c1-71cc-a44f-204f7d850267",
      "profile_picture_url": null,
      "like_count": 38579,
      "comment_count": 31,
      "thumbnail_url": null,
      "media_url": null,
      "media": [],
      "media_type": "reel",
      "play_count": 676825,
      "account_id": "018d3b53-c0c1-71cc-a44f-204f7d850267"
    },
    "… 1 more"
  ],
  "requested": 2,
  "found": 2
}
```

## MCP 呼び出しとして

```json
{
  "name": "solari_instagram_content_batch",
  "arguments": {
    "post_ids": [
      "019f505f-f8be-7e88-ae08-6fba999950b1",
      "019f5060-3449-779e-a08b-d6d49add90cd"
    ]
  }
}
```

## 注意点

- 受け付けるのはSOLARIの投稿UUIDのみ。Instagramのショートコードはここには渡さないでください。それはcontent detailにslugとして渡してください。
- sort=engagementは新しさではなくlike + commentで並べます。

## 関連ツール

- [`solari_instagram_content_detail`](https://solari.sh/docs/tools/instagram-content-detail.md?lang=ja)
- [`solari_instagram_brand_overview`](https://solari.sh/docs/tools/instagram-brand-overview.md?lang=ja)