# solari catalog tiktok account search

> 追跡中の TikTok アカウントを username や名前で探します。account_id を調べるときに使います。

- **CLI**: `solari catalog tiktok account search`
- **MCP ツール**: `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 から始めます。

**返される内容** — 一致したアカウント（近い順）。

## パラメータ

- `query` (string, 必須) — 名前または TikTok の username。
- `limit` (integer, 任意, 既定値 8, 1–50) — 返すアカウント数。
- `region` (string, 任意, ≤ 8 chars) — KR、JP などの国コード。省略するとすべての地域を検索します。

## レスポンス

### `Response`

- `found` (boolean) — 一致するアカウントがあったかどうか。
- `items` (object[]) — 一致したアカウント（近い順）。

### `items[]`

- `account_id` (uuid) — TikTok の account_id。Instagram の ID とは互換性がありません。
- `username` (string) — TikTok の username。
- `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 catalog 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_catalog_tiktok_account_search",
  "arguments": {
    "query": "innisfree",
    "limit": 5
  }
}
```

## 注意点

- region を指定すると、その国のアカウントだけが残り、地域が未設定のアカウントは除外されます。必要な場合以外は省略してください。
- SOLARI がまだ確認していない username は、ここには表示されません。fetch tiktok account search で探すか、正確なハンドルを solari fetch tiktok account に渡してから、カタログの TikTok アカウントのプロフィールで読み取ってください。

## 関連ツール

- [`solari_catalog_tiktok_account_profile`](https://clip-pub.bzine.co/docs/tools/catalog-tiktok-account-profile.md?lang=ja)
- [`solari_catalog_tiktok_account_posts`](https://clip-pub.bzine.co/docs/tools/catalog-tiktok-account-posts.md?lang=ja)
- [`solari_catalog_instagram_account_search`](https://clip-pub.bzine.co/docs/tools/catalog-instagram-account-search.md?lang=ja)