# solari catalog instagram content batch

> 여러 Instagram 포스트를 한 번에 불러와요.

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

포스트 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는 빠져서 더 적을 수 있어요

### `items[]`

- `id` (uuid) — 포스트 id
- `slug` (string) — Instagram 숏코드
- `text` (string) — 캡션
- `posted_at` (timestamp) — 게시 시각 (UTC)
- `username / user_id / account_id` (string) — 작성 계정이에요
- `like_count / comment_count` (integer) — 참여
- `play_count` (integer | null) — 영상 재생 수
- `media_type` (string) — 포스트 형식

## 예시

```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만 받아요. 숏코드는 content detail의 slug로 넣으세요.

## 관련 도구

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