# solari catalog tiktok account search

> TikTok のユーザー名や名前からユーザーを探します。account_id を取るときに使えます。

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

ユーザー名または表示名で TikTok のブランドやクリエイターを探します。Instagram の account_id はここでは使えません。

**どんなときに使うか** — TikTok の名前やユーザー名だけで、まだ account_id がないときに使います。

**何が返るか** — 一致したアカウントの一覧です。いちばん近い結果が先頭に来ます。

## パラメータ

- `query` (string, 必須) — 名前、または TikTok のユーザー名。
- `limit` (integer, 任意, ≥ 1) — 返すアカウントの数。
- `region` (string, 任意, ≤ 8 chars) — KR や JP などの国コード。空なら全体を探します。

## レスポンス

### `Response`

- `found` (boolean) — 一致したアカウントがあるか。
- `items` (object[]) — 一致したアカウントです。いちばん近い結果が先頭です。

### `items[]`

- `account_id` (uuid) — TikTok の account_id。Instagram のものとは互換しません。
- `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 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 を付けると指定した国だけになり、region のないアカウントは落ちます。特定の国でなければ空のままにしてください。
- 未収集のユーザー名はここには出ません。catalog tiktok account profile に渡すとその場で取りにいきます。

## 関連ツール

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