# solari tiktok account search

> ブランド名やクリエイター名をTikTokのaccount_idに変換します。

- **CLI**: `solari tiktok account search`
- **MCP ツール**: `solari_tiktok_account_search`
- **アクセス権**: `solari:read` — サインイン済みの SOLARI アカウントであれば利用できます。

ブランド名・クリエイター名またはTikTokハンドルを、追跡中のTikTokアカウント候補に解決します。高速で決定的なインデックス検索をtypeahead形式で行い、ハンドルは前方一致、表示用のnicknameはテキスト一致で照合し、一致の質とフォロワー数でランク付けします。foundと、最良のものから順に並んだitems（items[0]が最上位の一致）を返します。各itemはaccount_id（他のsolari_tiktok_*系ツールが受け取るSOLARIアカウントのUUID。TikTokのaccount_idはInstagramのaccount_idとは別の値であり、両者は決して互換ではありません）、username（TikTokハンドル）、nickname、follower_count、video_count、region、is_verified、is_private、is_commerce_user、commerce_user_category、profile_urlを持ちます。found=falseでitemsが空の場合は、一致がなかったことを意味します。queryはハンドルまたはnicknameに実際に含まれている必要があるため、音写のエイリアスで解決できない場合はネイティブの綴りで再試行してください。ユーザーが特定の1か国を指定した場合を除き、regionは未設定のままにしてください。追跡中のTikTokアカウントの多くはregionを持たず、regionフィルタを掛けるとそれらが除外されます。未追跡のハンドルはここには現れません。solari_tiktok_account_profileまたはsolari_tiktok_account_postsにそのまま渡せば、ライブ取得されます。サインイン済みのSOLARIアカウントであれば利用できます。

**どんなときに使うか** — TikTokに関する問いでの最初の呼び出し。Instagramのaccount_idはここでは使えません。

**何が返るか** — 最良のものから順に並んだアカウント候補。items[0]が最上位の一致。

## パラメータ

- `query` (string, 必須) — 解決したいブランド名・クリエイター名またはTikTokハンドル。
- `limit` (integer, 任意, ≥ 1) — 返す候補の最大数。デフォルトは8。50を超える値は50に切り詰められます。
- `region` (string, 任意, ≤ 8 chars) — KR、JP、USなどの任意のリージョンコード。ユーザーが特定の1か国を指定した場合を除き、未設定のままにしてください。regionを指定すると、リージョンが判明していないアカウントは除外されます。

## レスポンス

### `Response`

- `found` (boolean) — 候補が1件以上一致した場合にtrue。
- `items` (object[]) — 候補。

### `items[]`

- `account_id` (uuid) — TikTokのaccount_id。同じブランドであっても、Instagramのaccount_idと互換になることは決してありません。
- `username` (string) — TikTokのハンドル。
- `nickname` (string) — 表示名。
- `follower_count / video_count` (integer) — フォロワー数と動画数。
- `region` (string | null) — リージョンコード。追跡中のアカウントの多くは持ちません。
- `is_verified / is_private` (boolean) — 認証と非公開のフラグ。
- `is_commerce_user` (boolean) — コマースアカウントかどうか。
- `commerce_user_category` (string | null) — コマースのカテゴリ。例: Beauty。
- `profile_url` (string) — 公開プロフィールのURL。

## 例

```console
$ solari tiktok account search query=innisfree limit=5
```

_読みやすさのため、長い文字列と繰り返しの配列要素を省略しています。_

```json
{
  "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 呼び出しとして

```json
{
  "name": "solari_tiktok_account_search",
  "arguments": {
    "query": "innisfree",
    "limit": 5
  }
}
```

## 注意点

- ユーザーが特定の1か国を指定した場合を除き、regionは未設定のままにしてください。追跡中のアカウントの多くはregionを持たず、regionを指定するとそれらが完全に除外されます。
- 未追跡のハンドルはここには現れません。tiktok account profileまたはtiktok account postsにそのまま渡せば、ライブ取得されます。

## 関連ツール

- [`solari_tiktok_account_profile`](https://solari.sh/docs/tools/tiktok-account-profile.md?lang=ja)
- [`solari_tiktok_account_posts`](https://solari.sh/docs/tools/tiktok-account-posts.md?lang=ja)
- [`solari_instagram_account_search`](https://solari.sh/docs/tools/instagram-account-search.md?lang=ja)