tiktok · fetchsolari:read
solari fetch tiktok post
URL を指定して TikTok の投稿を 1 件収集し、投稿者を確認します。
- MCP ツール
- solari_fetch_tiktok_post
- CLI
- solari fetch tiktok post
- アクセス権
- solari:read
- 対象プラン
- 無料トライアル
- Plus
- Pro
- Enterprise
- クレジット
- 1
概要
公開 URL を指定して、TikTok の投稿を 1 件 SOLARI のカタログに収集し、投稿者も確認します。すでに保存済みの投稿の場合は何も取得しません。
どんなときに使うか — 投稿のリンクがあり、catalog content detail が item=null を返し、投稿者がわからないとき。
返される内容 — 収集したかどうか、投稿者付きの投稿、その投稿者をクロールする fetch コマンド。
パラメータ
- urlstring必須
- 投稿の公開 URL。vm.tiktok.com と vt.tiktok.com の短縮リンクも使えます。≤ 512 chars
レスポンス
Response
- ingestedboolean
- この呼び出しでその場で収集した場合は true。
- already_trackedboolean
- すでにカタログにあった場合は true。
- fetched_on_demandboolean
- ingested と同じ。
- foundboolean
- その URL に該当する公開投稿が TikTok にない場合は false。
- post_iduuid
- 保存された投稿。
- account_iduuid
- 投稿者のアカウント。
- usernamestring
- 投稿者のハンドル。
- itemobject | null
- メディアファイルを含む投稿。
- notestring
- この後に起きること。
- nextstring
- 投稿者をクロールする fetch コマンド。
item
- post_iduuid
- TikTok の投稿 ID。Instagram の投稿 ID とは別物です。
- video_idstring
- TikTok の URL に含まれる公開の数値 ID。
- urlstring
- 公開パーマリンク。
- account_iduuid
- 投稿者の account_id。
- usernamestring
- 投稿者のユーザー名。
- post_typestring
- video または carousel。
- posted_attimestamp
- 投稿日時(UTC)。
- captionstring
- キャプション。
- duration_secondsinteger
- 動画の長さ。
- width / heightinteger
- 解像度。
- play_countinteger
- 再生数。
- like_countinteger
- いいね数。
- comment_countinteger
- コメント数。
- share_countinteger
- シェア数。
- collect_countinteger
- 保存数。
- is_adboolean
- TikTok の広告フラグ。
- is_pinnedboolean
- プロフィールに固定されているかどうか。
- aigc_label_typestring | null
- AI 生成コンテンツのラベル(TikTok が付けている場合)。
- original_language_codestring | null
- 元の言語。
- cover_urlstring
- カバー画像の URL。
- video_urlstring
- 動画ファイルの URL。
- imagesstring[]
- カルーセルの各スライド。動画の場合は空です。
- hashtagsstring[]
- キャプション内のハッシュタグ。
- mentionsstring[]
- キャプションでメンションされているユーザー名。
- transcriptstring | null
- 動画の文字起こし。account posts と content batch では include_transcript=true のときだけ返ります。
- assetsobject[]
- メディアファイル(掲載順)。それぞれに asset_url、media_type、video_duration があります。
- assets[].asset_urlstring | null
- フルサイズの画像または動画の直接ダウンロードリンク。ファイルが保存されていない場合は null。
例
リクエスト
$ solari fetch tiktok post url=https://www.tiktok.com/@innisfree_official/video/7680375687139642645レスポンス · 読みやすさのため、長い文字列と繰り返しの配列要素を省略しています。
{
"ingested": true,
"already_tracked": false,
"fetched_on_demand": true,
"found": true,
"post_id": "01a0631e-f0df-7e9d-a09b-d84bc31d3900",
"account_id": "01a0631e-f0df-7e9d-a09b-d84bc31d3834",
"username": "innisfree_official",
"item": {
"account_id": "01a0631e-f0df-7e9d-a09b-d84bc31d3834",
"post_id": "01a0631e-f0df-7e9d-a09b-d84bc31d3900",
"video_id": "7680375687139642645",
"url": "https://www.tiktok.com/@innisfree_official/video/7680375687139642645",
"username": "innisfree_official",
"post_type": "video",
"posted_at": "2026-09-01T09:00:00Z",
"play_count": 12000,
"like_count": 800
},
"note": "Collected live and stored now. The author is known by name only: run next to crawl their profile and posts.",
"next": "solari fetch tiktok account username=innisfree_official"
}MCP で呼び出す場合
{
"name": "solari_fetch_tiktok_post",
"arguments": {
"url": "https://www.tiktok.com/@innisfree_official/video/7680375687139642645"
}
}注意点
- 投稿者は名前だけのアカウントとして登録されます。プロフィールと投稿をクロールするには、next(fetch tiktok account)を実行してください。
- 初回の収集には数秒かかります。
関連ツール
- solari_fetch_tiktok_post_assetsTikTok の投稿 1 件の元サイズのダウンロードリンク。
- solari_catalog_tiktok_content_detailID、video_id、URL で指定した TikTok の投稿。
- solari_fetch_tiktok_accountTikTok のハンドルを 1 件カタログに取り込みます。
- solari_fetch_tiktok_postsTikTok アカウント 1 件の投稿をカタログに収集します。
機械可読な形式: /docs/tools/fetch-tiktok-post.md