# solari catalog tiktok content batch

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

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

틱톡 포스트 id 목록으로 캡션과 성과를 불러와요. 없는 id는 건너뛰어요.

**언제 쓰나** — 검색이나 계정 포스트에서 받은 id를 한 번에 볼 때 사용해요.

**무엇이 나오나** — 찾은 포스트만 나와요.

## 파라미터

- `post_ids` (uuid[], 필수, 1–100 items, uuid) — 불러올 TikTok 포스트 id. 최대 100개
- `sort` (enum, 선택, 기본값 "recent") — 최신순, 또는 참여 높은 순 값: `recent`, `engagement`.
- `include_transcript` (boolean, 선택, 기본값 false) — 말한 대본을 포함할지

## 응답

### `Response`

- `requested` (integer) — 보낸 id 개수예요
- `found` (integer) — 찾은 개수예요
- `items` (object[]) — 찾은 포스트예요

### `items[]`

- `post_id` (uuid) — TikTok 포스트 id예요. Instagram 것과는 서로 바꿔 쓸 수 없어요
- `video_id` (string) — TikTok URL에 있는 공개 숫자 id예요
- `url` (string) — 공개 링크예요
- `account_id` (uuid) — 작성자 account_id
- `username` (string) — 작성자 사용자명
- `post_type` (string) — video 또는 carousel
- `posted_at` (timestamp) — 게시 시각 (UTC)
- `caption` (string) — 캡션
- `duration_seconds` (integer) — 영상 길이
- `width / height` (integer) — 해상도
- `play_count` (integer) — 재생 수
- `like_count` (integer) — 좋아요
- `comment_count` (integer) — 댓글 수
- `share_count` (integer) — 공유 수
- `collect_count` (integer) — 저장 수
- `is_ad` (boolean) — TikTok 광고 표시예요
- `is_pinned` (boolean) — 프로필에 고정되어 있는지예요
- `aigc_label_type` (string | null) — AI 콘텐츠 라벨이에요. TikTok이 붙인 경우에만 와요
- `original_language_code` (string | null) — 원본 언어예요
- `cover_url` (string) — 커버 이미지 URL
- `video_url` (string) — 영상 파일 URL
- `images` (string[]) — 캐러셀 장이에요. 영상이면 비어 있어요
- `hashtags` (string[]) — 캡션에 있는 해시태그예요
- `mentions` (string[]) — 캡션에서 멘션된 사용자명이에요
- `transcript` (string | null) — 말한 대본이에요. include_transcript=true일 때만 와요

## 예시

```console
$ solari catalog tiktok content batch post_ids='["01a0631e-f0df-7e9d-a09b-d84bc31d3834"]'
```

_읽기 편하도록 긴 문자열과 반복되는 배열 항목을 줄였어요._

```json
{
  "requested": 1,
  "found": 1,
  "items": [
    {
      "post_id": "01a0631e-f0df-7e9d-a09b-d84bc31d3834",
      "video_id": "7680375687139642645",
      "url": "https://www.tiktok.com/@innisfree_official/video/7680375687139642645",
      "account_id": "019b2137-f76e-7b33-9437-26044fa7b1ed",
      "username": "innisfree_official",
      "post_type": "video",
      "posted_at": "2026-09-02T12:00:00Z",
      "caption": "Deeply hydrated skin—NO OFF HOURS. 💚  wherever the day takes MINGYU—his hydration stays SUPERCHARGED ⚡️ Green Tea Ceramide Milk: Lightweight milky toner that won't clog your pores  Green Tea Ceramide Mist: Touch-free, fa …",
      "duration_seconds": 23,
      "width": 1080,
      "height": 1920,
      "play_count": 493,
      "like_count": 37,
      "comment_count": 2,
      "share_count": 0,
      "collect_count": 3,
      "is_ad": false,
      "is_pinned": false,
      "aigc_label_type": null,
      "original_language_code": null,
      "cover_url": "https://smr-images-b.bzine.co/tiktok/users/019b2137-f76e-7b33-9437-26044fa7b1ed/posts/01a0631e-f0df-7e9d-a09b-d84bc31d3834/medias/cover.jpg",
      "video_url": "https://smr-images-b.bzine.co/tiktok/users/019b2137-f76e-7b33-9437-26044fa7b1ed/posts/01a0631e-f0df-7e9d-a09b-d84bc31d3834/medias/origin.mp4",
      "images": [],
      "hashtags": [],
      "mentions": [],
      "transcript": null
    }
  ]
}
```

## MCP 호출로 쓰면

```json
{
  "name": "solari_catalog_tiktok_content_batch",
  "arguments": {
    "post_ids": [
      "01a0631e-f0df-7e9d-a09b-d84bc31d3834"
    ]
  }
}
```

## 주의사항

- SOLARI 포스트 id만 받아요. 숫자 video id는 content detail의 video_id로 넣으세요.
- TikTok 포스트 id와 Instagram 포스트 id는 서로 바꿔 쓸 수 없어요.

## 관련 도구

- [`solari_catalog_tiktok_content_detail`](https://solari.sh/docs/tools/catalog-tiktok-content-detail.md?lang=ko)
- [`solari_catalog_tiktok_content_search`](https://solari.sh/docs/tools/catalog-tiktok-content-search.md?lang=ko)