tiktok · catalog · accountsolari:read
solari catalog tiktok account search
追跡中の TikTok アカウントを username や名前で探します。account_id を調べるときに使います。
- MCP ツール
- solari_catalog_tiktok_account_search
- CLI
- solari catalog tiktok account search
- アクセス権
- solari:read
- 対象プラン
- 無料トライアル
- Plus
- Pro
- Enterprise
- クレジット
- 1
概要
SOLARI がすでに追跡している TikTok アカウントから、username または表示名でブランドやクリエイターを探します。TikTok のカタログは小さいので、まず fetch tiktok account search から始めてください。Instagram の account_id はここでは使えません。
どんなときに使うか — すでに追跡中のアカウントの account_id が必要なとき。初めての名前は fetch tiktok account search から始めます。
返される内容 — 一致したアカウント（近い順）。
パラメータ
- querystring必須
- 名前または TikTok の username。
- limitinteger任意
- 返すアカウント数。既定値
81–50 - regionstring任意
- KR、JP などの国コード。省略するとすべての地域を検索します。≤ 8 chars
レスポンス
Response
- foundboolean
- 一致するアカウントがあったかどうか。
- itemsobject[]
- 一致したアカウント（近い順）。
items[]
- account_iduuid
- TikTok の account_id。Instagram の ID とは互換性がありません。
- usernamestring
- TikTok の username。
- nicknamestring
- 表示名。
- follower_count / video_countinteger
- フォロワー数と動画数。
- regionstring | null
- 地域コード。収集済みのアカウントの多くは未設定です。
- is_verified / is_privateboolean
- 認証済み・非公開の状態。
- is_commerce_userboolean
- コマース用アカウントかどうか。
- commerce_user_categorystring | null
- コマースのカテゴリ（例：Beauty）。
- profile_urlstring
- 公開プロフィールの URL。
例
リクエスト
$ solari catalog tiktok account search query=innisfree limit=5レスポンス · 読みやすさのため、長い文字列と繰り返しの配列要素を省略しています。
{
"found": true,
"items": [
{
"account_id": "019b2137-f76e-7b33-9437-26044fa7b1ed",
"username": "innisfree_official",
"nickname": "Innisfreeofficial",
"follower_count": 143800,
"video_count": 767,
"region": "KR",
"is_verified": true,
"is_private": false,
"is_commerce_user": true,
"commerce_user_category": "Beauty",
"profile_url": "https://www.tiktok.com/@innisfree_official"
}
]
}MCP で呼び出す場合
{
"name": "solari_catalog_tiktok_account_search",
"arguments": {
"query": "innisfree",
"limit": 5
}
}注意点
- region を指定すると、その国のアカウントだけが残り、地域が未設定のアカウントは除外されます。必要な場合以外は省略してください。
- SOLARI がまだ確認していない username は、ここには表示されません。fetch tiktok account search で探すか、正確なハンドルを solari fetch tiktok account に渡してから、カタログの TikTok アカウントのプロフィールで読み取ってください。