tiktok · fetch · postsolari:read
solari fetch tiktok post assets
TikTok の投稿 1 件の元サイズのダウンロードリンク。
- MCP ツール
- solari_fetch_tiktok_post_assets
- CLI
- solari fetch tiktok post assets
- アクセス権
- solari:read
- 対象プラン
- 無料トライアル
- Plus
- Pro
- Enterprise
- クレジット
- 1
概要
TikTok の投稿 1 件のメディアについて、TikTok が配信する最大サイズの新しいダウンロードリンクを返します。動画 1 本、または写真投稿のすべての写真が対象です。呼び出すたびに TikTok からその場で読み込みます。
どんなときに使うか — 投稿の元ファイルが必要なときに使います。他のツールの assets は保存済みのコピーを指していて、元より小さいことがあります。
返される内容 — 投稿者と投稿の種類、そしてメディアファイルごとのダウンロードリンク（順番どおり）。
パラメータ
- urlstring任意
- 投稿の公開 URL。vm.tiktok.com、vt.tiktok.com の短縮リンクも使えます。video_id より優先されます。≤ 512 chars
- video_idstring任意
- 数字の video id。すでにカタログにある投稿のみ対応します。それ以外は url を使ってください。pattern ^\d{15,20}$
レスポンス
Response
- foundboolean
- その参照先に TikTok の公開投稿がなければ false。
- video_idstring | null
- 投稿の公開数値 id。
- urlstring | null
- 公開パーマリンク。
- usernamestring | null
- 投稿者のハンドル。
- post_typestring | null
- video または carousel。
- media_countinteger
- assets に含まれるファイル数。
- assetsobject[]
- メディアファイルの一覧（順番どおり）。
- notestring | null
- ダウンロードできるファイルがない場合の理由。
assets[]
- indexinteger
- 投稿内でのファイルの順番。1 から始まります。
- media_typestring
- video または image。
- asset_urlstring
- プラットフォームが配信する最大サイズのファイルのダウンロードリンク。一時的なリンクなので、すぐにダウンロードしてください。
- fallback_urlsstring[]
- 同じファイルの別リンク。asset_url が失敗したときに順番に試します。
- widthinteger | null
- 幅（ピクセル）。分かる場合のみ。
- heightinteger | null
- 高さ（ピクセル）。分かる場合のみ。
- video_durationnumber | null
- 動画の長さ（秒）。
- file_extensionstring
- 保存時に使うファイル拡張子。例：mp4、jpg。
- size_bytesinteger | null
- ファイルサイズ（バイト）。分かる場合のみ。
- refererstring | null
- ダウンロード時に Referer ヘッダーとして送る値。不要な場合は null です。
例
リクエスト
$ solari fetch tiktok post assets url=https://www.tiktok.com/@innisfree_official/video/7680375687139642645レスポンス · 読みやすさのため、長い文字列と繰り返しの配列要素を省略しています。
{
"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 で呼び出す場合
{
"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 の値を付けて送ってください。
- リンクは一時的な署名付きリンクです。すぐにダウンロードし、再度必要なら呼び出し直してください。