# solari tiktok content detail

> TikTok 포스트 하나의 전체 정보.

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

TikTok 포스트 하나의 상세 정보. solari_tiktok_account_posts 엔트리와 같은 item 형태이며, 전사문이 있으면 함께 담겨요. 포스트는 post_id(solari_tiktok_account_posts, solari_tiktok_content_search, solari_tiktok_account_profile 이 반환하는 SOLARI post UUID), video_id(공개된 TikTok 숫자 video id), 또는 url(vm.tiktok.com·vt.tiktok.com 단축 링크를 포함한 모든 공개 TikTok 포스트 URL. upstream에서 해석돼요)로 지정해요. 아직 추적 중이 아닌 video_id나 url은 첫 요청 때 실시간으로 수집하며(10~40초 소요) 이 경우 fetched_on_demand=true로 표시돼요. 포스트가 존재하지 않거나 비공개일 때, 또는 post_id를 알 수 없을 때 item은 null이에요. 로그인된 SOLARI 계정이면 누구나 사용할 수 있어요.

**언제 쓰나** — post_id, video_id, 또는 공개 URL로 포스트 하나를 열 때.

**무엇이 돌아오나** — account-posts 형태의 item 하나. 전사문이 있으면 함께 담겨요.

## 파라미터

- `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)$) — SOLARI post_id UUID. 이 값, video_id, url 중 하나를 넘기세요.
- `video_id` (string, 선택, pattern ^\d{15,20}$) — 공개된 TikTok 숫자 video id. 포스트 URL의 /video/ 또는 /photo/ 뒤의 숫자예요. post_id가 설정되면 무시돼요.
- `url` (string, 선택, ≤ 512 chars) — https://www.tiktok.com/@<handle>/video/<id> 같은 공개 TikTok 포스트 URL, 또는 vm.tiktok.com / vt.tiktok.com 단축 링크. post_id나 video_id가 설정되면 무시돼요.

## 응답

### `Response`

- `item` (object | null) — 포스트. 존재하지 않거나 비공개면 null이에요.
- `fetched_on_demand` (boolean) — 이 요청이 해당 포스트를 처음 끌어온 경우 true.

### `item`

- `post_id` (uuid) — SOLARI post id. Instagram post id와는 다른 네임스페이스예요.
- `video_id` (string) — 공개된 TikTok 숫자 id — /video/ 또는 /photo/ 뒤의 숫자.
- `url` (string) — 공개 TikTok 퍼머링크.
- `account_id` (uuid) — 작성자의 TikTok 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) — TikTok이 붙인 경우의 AI 생성 콘텐츠 라벨.
- `original_language_code` (string | null) — 원본 언어 코드.
- `cover_url` (string) — 커버 이미지 URL.
- `video_url` (string) — 영상 파일 URL.
- `images` (string[]) — 캐러셀 슬라이드. video 포스트에서는 비어 있어요.
- `hashtags` (string[]) — 캡션에서 파싱한 해시태그.
- `mentions` (string[]) — 캡션에 멘션된 핸들.
- `transcript` (string | null) — 음성 전사문. include_transcript=true일 때만 채워져요.

## 예시

```console
$ solari 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_tiktok_content_detail",
  "arguments": {
    "video_id": "7680375687139642645"
  }
}
```

## 주의사항

- vm.tiktok.com과 vt.tiktok.com 단축 링크를 받으며, upstream에서 해석돼요.
- 추적 중이 아닌 video_id나 URL은 첫 요청 때 실시간으로 수집해요 — 10~40초가 걸려요.

## 관련 도구

- [`solari_tiktok_content_batch`](https://solari.sh/docs/tools/tiktok-content-batch.md?lang=ko)
- [`solari_tiktok_account_posts`](https://solari.sh/docs/tools/tiktok-account-posts.md?lang=ko)