# solari fetch tiktok post assets

> TikTok 게시물 하나의 원본 크기 다운로드 링크.

- **CLI**: `solari fetch tiktok post assets`
- **MCP 도구**: `solari_fetch_tiktok_post_assets`
- **권한**: `solari:read`
- **이용 가능 플랜**: 무료 체험 · Plus · Pro · Enterprise
- **크레딧**: 1

TikTok 게시물 하나의 미디어를 TikTok이 제공하는 가장 큰 크기로 내려받을 수 있는 새 링크를 돌려줍니다. 영상 하나, 또는 사진 게시물의 모든 사진이 대상입니다. 호출할 때마다 TikTok에서 바로 읽어 옵니다.

**언제 쓰나요** — 게시물의 원본 파일이 필요할 때 쓰세요. 다른 도구의 assets는 저장된 사본을 가리키며, 원본보다 작을 수 있습니다.

**돌려주는 값** — 작성자와 게시물 유형, 그리고 미디어 파일마다 순서대로 다운로드 링크 하나.

## 파라미터

- `url` (string, 선택, ≤ 512 chars) — 게시물 공개 URL. vm.tiktok.com, vt.tiktok.com 단축 링크도 됩니다. video_id보다 우선입니다.
- `video_id` (string, 선택, pattern ^\d{15,20}$) — 숫자 video id. 이미 카탈로그에 있는 게시물만 됩니다. 그 외에는 url을 쓰세요.

## 응답

### `Response`

- `found` (boolean) — 그 참조에 TikTok 공개 게시물이 없으면 false.
- `video_id` (string | null) — 게시물의 공개 숫자 id.
- `url` (string | null) — 공개 고유 링크.
- `username` (string | null) — 작성자 핸들.
- `post_type` (string | null) — video 또는 carousel.
- `media_count` (integer) — assets에 들어 있는 파일 수.
- `assets` (object[]) — 미디어 파일 목록(순서대로).
- `note` (string | null) — 내려받을 파일이 없을 때 그 이유.

### `assets[]`

- `index` (integer) — 게시물 안에서 파일의 순서. 1부터 시작합니다.
- `media_type` (string) — video 또는 image.
- `asset_url` (string) — 플랫폼이 제공하는 가장 큰 크기의 파일 다운로드 링크. 임시 링크라 바로 내려받아야 합니다.
- `fallback_urls` (string[]) — 같은 파일의 다른 링크. asset_url이 실패하면 순서대로 시도합니다.
- `width` (integer | null) — 가로 픽셀 수. 알 수 있을 때만 있습니다.
- `height` (integer | null) — 세로 픽셀 수. 알 수 있을 때만 있습니다.
- `video_duration` (number | null) — 영상 길이(초).
- `file_extension` (string) — 저장할 때 쓸 파일 확장자. 예: mp4, jpg.
- `size_bytes` (integer | null) — 파일 크기(바이트). 알 수 있을 때만 있습니다.
- `referer` (string | null) — 내려받을 때 Referer 헤더로 보내야 하는 값. 필요 없으면 null입니다.

## 예시

```console
$ solari fetch tiktok post assets url=https://www.tiktok.com/@innisfree_official/video/7680375687139642645
```

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

```json
{
  "found": true,
  "slug": null,
  "video_id": "7680375687139642645",
  "url": "https://www.tiktok.com/@innisfree_official/video/7680375687139642645",
  "username": "innisfree_official",
  "post_type": "video",
  "media_count": 1,
  "assets": [
    {
      "index": 1,
      "media_type": "video",
      "asset_url": "https://www.tiktok.com/aweme/v1/play/?…",
      "fallback_urls": [
        "https://www.tiktok.com/aweme/v1/play/?…"
      ],
      "width": 1080,
      "height": 1920,
      "video_duration": 23,
      "file_extension": "mp4",
      "size_bytes": 2775677,
      "referer": "https://www.tiktok.com/"
    }
  ],
  "note": null
}
```

## MCP 호출

```json
{
  "name": "solari_fetch_tiktok_post_assets",
  "arguments": {
    "url": "https://www.tiktok.com/@innisfree_official/video/7680375687139642645"
  }
}
```

## 주의사항

- 파일을 한 번에 저장하려면 solari tiktok download content urls=… dir=…를 실행하세요. 이 도구를 호출하고 모든 파일을 내려받습니다.
- TikTok은 Referer 헤더가 없는 영상 다운로드를 거부합니다. 요청에 referer 값을 함께 보내세요.
- 링크는 임시 서명 링크입니다. 바로 내려받고, 다시 필요하면 새로 호출하세요.

## 관련 도구

- [`solari tiktok download content`](https://solari.sh/docs/tools/tiktok-download-content.md?lang=ko)
- [`solari_fetch_tiktok_post`](https://solari.sh/docs/tools/fetch-tiktok-post.md?lang=ko)
- [`solari_catalog_tiktok_content_detail`](https://solari.sh/docs/tools/catalog-tiktok-content-detail.md?lang=ko)
- [`solari_fetch_instagram_post_assets`](https://solari.sh/docs/tools/fetch-instagram-post-assets.md?lang=ko)