# solari catalog tiktok content detail

> id, video_id, URL로 찾는 TikTok 게시물 하나.

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

post_id, video_id, 공개 URL 중 하나로 TikTok 게시물을 불러옵니다.

**언제 쓰나요** — 게시물 하나가 필요할 때 쓰세요. id가 여러 개면 content batch를 쓰세요.

**돌려주는 값** — 게시물. 영상 자막이 있으면 함께 옵니다.

## 파라미터

- `post_id` (string, 선택, uuid, pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$) — post_id. 이 값, video_id, url 중 하나를 넣으세요.
- `video_id` (string, 선택, pattern ^\d{15,20}$) — TikTok 공개 숫자 id.
- `url` (string, 선택, ≤ 512 chars) — TikTok 게시물 공개 URL.

## 응답

### `Response`

- `item` (object | null) — 게시물. 없거나 공개되지 않은 게시물이면 null.
- `fetched_on_demand` (boolean) — 이번 호출에서 게시물을 바로 수집했으면 true.
- `note` (string) — item이 null일 때만 옵니다. 다음에 할 일.
- `next` (string) — item이 null이고 게시물을 URL로 지정했을 때만 옵니다. 그 게시물을 수집하는 fetch post 명령입니다.

### `item`

- `post_id` (uuid) — TikTok 게시물 id. Instagram 게시물 id와 섞어 쓸 수 없습니다.
- `video_id` (string) — TikTok URL에 들어 있는 공개 숫자 id.
- `url` (string) — 공개 고유 링크.
- `account_id` (uuid) — 작성자 account_id.
- `username` (string) — 작성자 username.
- `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[]) — 캡션에서 언급한 username.
- `transcript` (string | null) — 영상 자막. account posts와 content batch에서는 include_transcript=true일 때만 옵니다.
- `assets` (object[]) — 미디어 파일 목록(순서대로). 각 항목에 asset_url, media_type, video_duration이 있습니다.
- `assets[].asset_url` (string | null) — 원본 크기 이미지나 영상을 바로 내려받는 링크. 저장된 파일이 없으면 null.

## 예시

```console
$ solari catalog tiktok content detail video_id=7680375687139642645 include_transcript=true
```

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

```json
{
  "item": {
    "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-c.bzine.co/tiktok/users/019b2137-f76e-7b33-9437-26044fa7b1ed/posts/01a0631e-f0df-7e9d-a09b-d84bc31d3834/medias/origin.mp4",
    "images": [],
    "hashtags": [],
    "mentions": [],
    "transcript": null
  },
  "fetched_on_demand": false
}
```

## MCP 호출

```json
{
  "name": "solari_catalog_tiktok_content_detail",
  "arguments": {
    "video_id": "7680375687139642645"
  }
}
```

## 주의사항

- vm.tiktok.com, vt.tiktok.com 단축 링크도 쓸 수 있습니다.
- 카탈로그에 있는 데이터만 읽습니다. 카탈로그에 없는 게시물을 수집하려면 solari fetch tiktok post url=…을 실행하세요. 작성자도 함께 알려 줍니다. 작성자를 이미 알면 solari fetch tiktok posts username=…을 실행하세요.

## 관련 도구

- [`solari_fetch_tiktok_post`](https://clip-pub.bzine.co/docs/tools/fetch-tiktok-post.md?lang=ko)
- [`solari_catalog_tiktok_content_batch`](https://clip-pub.bzine.co/docs/tools/catalog-tiktok-content-batch.md?lang=ko)
- [`solari_catalog_tiktok_account_posts`](https://clip-pub.bzine.co/docs/tools/catalog-tiktok-account-posts.md?lang=ko)