tiktok · fetch · accountsolari:read
solari fetch tiktok account search
TikTok アカウントを名前でライブ検索します。
- MCP ツール
- solari_fetch_tiktok_account_search
- CLI
- solari fetch tiktok account search
- アクセス権
- solari:read
- 対象プラン
- 無料トライアル
- Plus
- Pro
- Enterprise
- クレジット
- 1
概要
名前やハンドルの一部で TikTok 自体にアカウントを問い合わせます。ヒットはハンドル、表示名、bio、認証バッジ、フォロワー数、プロフィール画像、URL だけの薄い一覧で、TikTok の順序どおりです。カタログにすでにあるアカウントには account_id が付き、それ以外は選んだアカウントを fetch tiktok account で追加します。
どんなときに使うか — catalog account search が名前を知らないとき、または名前は分かるが正確な TikTok ハンドルが分からないときに使います。
返される内容 — TikTok の順序で最大 limit 件の候補、次のページ用の cursor、最初の候補を読むか追加するコマンドです。
パラメータ
- querystring必須
- 名前またはハンドルの一部。@ はあってもなくても構いません。≤ 100 chars
- limitinteger任意
- 1 ページあたり最大何件まで。既定値
101–30 - cursorstring任意
- 同じ query の前のページで受け取った next_cursor。最初のページでは省略します。≤ 1024 chars
レスポンス
Response
- querystring
- 検索に使った文字列。@ を除いた値。
- itemsobject[]
- 一致したアカウント。TikTok の順序。
- totalinteger
- このページの候補の数。
- has_moreboolean
- TikTok に次のページがあれば true。
- next_cursorstring | null
- 同じ query と一緒に cursor として渡す値。最後のページなら null。
- nextstring
- 最初の候補に対するコマンド。収集済みなら catalog のプロフィール、そうでなければ fetch tiktok account。候補があるときだけ。
items[]
- usernamestring
- ハンドル。@ なし。
- nicknamestring | null
- 表示名。
- biostring | null
- bio のテキスト。
- is_verifiedboolean | null
- 認証バッジ。
- follower_countinteger | null
- TikTok が現在表示しているフォロワー数。
- profile_pic_urlstring | null
- プロフィール画像の URL。
- urlstring
- 公開プロフィールの URL。
- account_iduuid | null
- カタログにすでにあるアカウントなら TikTok の account_id、なければ null。
例
リクエスト
$ solari fetch tiktok account search query=innisfree limit=1レスポンス · 読みやすさのため、長い文字列と繰り返しの配列要素を省略しています。
{
"query": "innisfree",
"items": [
{
"username": "innisfree_official",
"nickname": "Innisfreeofficial",
"bio": "NATURE MEETS KOREAN SKIN SCIENCE",
"is_verified": true,
"follower_count": 143900,
"profile_pic_url": "https://p16-common-sign.tiktokcdn-eu.com/tos-alisg-avt-0068/3f8e48dc4a284a8ead37e93175ebdb86~tplv-tiktokx-cropcenter:720:720.jpeg?…",
"url": "https://www.tiktok.com/@innisfree_official",
"account_id": "019b2137-f76e-7b33-9437-26044fa7b1ed"
}
],
"total": 1,
"has_more": true,
"next_cursor": "eyJjIjoiMSIsInMiOiIyMDI2MDkyOTA2NDMxMkE3QzRFMTlCMkQzRjVBOEM2RTAxIn0",
"next": "solari catalog tiktok account profile username=innisfree_official"
}MCP で呼び出す場合
{
"name": "solari_fetch_tiktok_account_search",
"arguments": {
"query": "innisfree",
"limit": 1
}
}注意点
- 順序とランキングは TikTok 自身のものなので、公式アカウントが常に先頭とは限りません。選ぶ前に is_verified と follower_count を確認してください。
- 何も保存しません。account_id があるヒットはすでにカタログにあるので、catalog tiktok ツールで読めます。account_id がないヒットは、その username で fetch tiktok account を呼ぶと追加されます。
- has_more が true なら、next_cursor を同じ query と一緒に cursor として渡すと次のページを受け取れます。cursor は別の query には使えません。
- 呼び出しごとに TikTok へライブで問い合わせます。数秒かかり、cache はありません。items が空なら TikTok に一致するアカウントがありません。