# solari fetch tiktok post assets

> TikTok の投稿 1 件の元サイズのダウンロードリンク。

- **CLI**: `solari fetch tiktok post assets`
- **MCP ツール**: `solari_fetch_tiktok_post_assets`
- **アクセス権**: `solari:read`
- **対象プラン**: 無料トライアル · Plus · Pro · Enterprise
- **クレジット**: 1

TikTok の投稿 1 件のメディアについて、TikTok が配信する最大サイズの新しいダウンロードリンクを返します。動画 1 本、または写真投稿のすべての写真が対象です。呼び出すたびに 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://pub.brandazine.ai/docs/tools/tiktok-download-content.md?lang=ja)
- [`solari_fetch_tiktok_post`](https://pub.brandazine.ai/docs/tools/fetch-tiktok-post.md?lang=ja)
- [`solari_catalog_tiktok_content_detail`](https://pub.brandazine.ai/docs/tools/catalog-tiktok-content-detail.md?lang=ja)
- [`solari_fetch_instagram_post_assets`](https://pub.brandazine.ai/docs/tools/fetch-instagram-post-assets.md?lang=ja)