tiktok · fetchsolari:read
solari fetch tiktok posts
TikTok アカウント 1 件の投稿をカタログに収集します。
- MCP ツール
- solari_fetch_tiktok_posts
- CLI
- solari fetch tiktok posts
- アクセス権
- solari:read
- 対象プラン
- 無料トライアル
- Plus
- Pro
- Enterprise
- クレジット
- 1
概要
正確なユーザー名を指定して、TikTok アカウント 1 件の投稿を SOLARI のカタログに収集します。投稿の一覧を返すツールではありません。すでに保存済みのハンドルの場合は何も取得しません。
どんなときに使うか — 正確なハンドルがわかっているのに、カタログの投稿一覧で見つからないとき。
返される内容 — 取り込んだかどうか、返ってきた投稿の件数、結果を読むためのカタログコマンド。
パラメータ
- usernamestring必須
- TikTok のユーザー名。≤ 64 chars
レスポンス
Response
- ingestedboolean
- この呼び出しでその場で収集した場合は true。
- already_trackedboolean
- すでにカタログにあった場合は true。
- fetched_on_demandboolean
- ingested と同じ。
- foundboolean
- ハンドルを収集できなかった場合は false。
- account_iduuid
- 取り込んだアカウント。
- usernamestring
- 特定したハンドル。
- totalinteger
- 現時点で取得できる投稿。
- notestring
- この後に起きること。
- nextstring
- 結果を読むためのカタログコマンド。
例
リクエスト
$ solari fetch tiktok posts username=innisfree_officialレスポンス · 読みやすさのため、長い文字列と繰り返しの配列要素を省略しています。
{
"ingested": false,
"already_tracked": true,
"fetched_on_demand": false,
"found": true,
"account_id": "01a0631e-f0df-7e9d-a09b-d84bc31d3834",
"username": "innisfree_official",
"total": 12,
"note": "Already in the SOLARI catalog. Nothing was scraped.",
"next": "solari catalog tiktok account posts username=innisfree_official"
}MCP で呼び出す場合
{
"name": "solari_fetch_tiktok_posts",
"arguments": {
"username": "innisfree_official"
}
}注意点
- 保存済みの投稿を一覧表示する用途には使わないでください。その場合は catalog tiktok account posts を使います。
- 初回の取り込みには 10〜40 秒かかることがあります。クロールが終わるまでは、最近の投稿しかありません。
関連ツール
- solari_fetch_tiktok_accountTikTok のハンドルを 1 件カタログに取り込みます。
- solari_catalog_tiktok_account_postsTikTok アカウントの投稿。
- solari_catalog_tiktok_account_search追跡中の TikTok アカウントを username や名前で探します。account_id を調べるときに使います。
機械可読な形式: /docs/tools/fetch-tiktok-posts.md