# solari instagram content batch

> 한 번의 호출로 포스트 id를 최대 100개까지 실제 데이터로 채워요.

- **CLI**: `solari instagram content batch`
- **MCP 도구**: `solari_instagram_content_batch`
- **권한**: `solari:read` — 로그인한 SOLARI 계정이면 쓸 수 있어요.

solari_instagram_content_detail의 배치 버전. 포스트를 SOLARI 포스트 UUID로 한 번에 최대 100개까지 채워서 반환해요. 각 행에는 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. 호출당 최대 100개. Instagram shortcode/slug가 아니에요.
- `sort` (enum, 선택, 기본값 "recent") — 항목 정렬: posted_at 내림차순(recent) 또는 like+comment engagement 내림차순. 값: `recent`, `engagement`.

## 응답

### `Response`

- `items` (object[]) — 찾은 포스트.
- `requested` (integer) — 보낸 id 개수.
- `found` (integer) — 찾아낸 개수. 추적 중이 아닌 id는 버려지므로 더 적을 수 있어요.

### `items[]`

- `id` (uuid) — 포스트 id.
- `slug` (string) — Instagram shortcode.
- `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 shortcode는 여기 들어가지 않아요 — 그건 content detail에 slug로 넣으세요.
- sort=engagement는 최신순 대신 like + comment 순으로 정렬해요.

## 관련 도구

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