# solari catalog instagram content batch

> Instagram 게시물 여러 개를 한 번에.

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

게시물 id 목록으로 캡션과 지표를 불러옵니다. 찾을 수 없는 id는 건너뜁니다.

**언제 쓰나요** — brand overview나 피드에서 받은 id로 게시물을 봐야 할 때.

**돌려주는 값** — 찾은 게시물.

## 파라미터

- `post_ids` (uuid[], 필수, 1–100 items, uuid) — 불러올 post_id. 최대 100개.
- `sort` (enum, 선택, 기본값 "recent") — 최신순이나 참여순으로 정렬합니다. 값: `recent`, `engagement`.

## 응답

### `Response`

- `items` (object[]) — 찾은 게시물.
- `requested` (integer) — 보낸 id 수.
- `found` (integer) — 찾은 id 수. SOLARI에 없는 id는 빠지니까 보낸 수보다 적을 수 있습니다.

### `items[]`

- `id` (uuid) — 게시물 id.
- `slug` (string) — Instagram shortcode.
- `text` (string) — 캡션.
- `posted_at` (timestamp) — 게시 시각(UTC).
- `username / user_id / account_id` (string) — 게시물을 올린 계정.
- `like_count / comment_count` (integer) — 참여 지표.
- `play_count` (integer | null) — 영상 재생 수.
- `media_type` (string) — 게시물 형식.
- `assets` (object[]) — 미디어 파일 목록(순서대로). 파일마다 asset_url, media_type, video_duration이 있습니다.
- `assets[].asset_url` (string | null) — 원본 크기 이미지나 영상을 바로 내려받는 링크. 저장된 파일이 없으면 null입니다.

## 예시

```console
$ solari catalog 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_catalog_instagram_content_batch",
  "arguments": {
    "post_ids": [
      "019f505f-f8be-7e88-ae08-6fba999950b1",
      "019f5060-3449-779e-a08b-d6d49add90cd"
    ]
  }
}
```

## 주의사항

- SOLARI 게시물 id만 받습니다. shortcode는 content detail 도구에 slug로 넣으세요.
- likes_hidden이 true면 like_count를 쓰지 마세요. 작성자가 좋아요를 숨겨서 null이거나 실제 값이 아닐 수 있습니다.

## 관련 도구

- [`solari_catalog_instagram_content_detail`](https://clip-pub.bzine.co/docs/tools/catalog-instagram-content-detail.md?lang=ko)
- [`solari_insight_instagram_brand_overview`](https://clip-pub.bzine.co/docs/tools/insight-instagram-brand-overview.md?lang=ko)