# solari fetch tiktok account search

> TikTok アカウントを名前でライブ検索します。

- **CLI**: `solari fetch tiktok account search`
- **MCP ツール**: `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、最初の候補を読むか追加するコマンドです。

## パラメータ

- `query` (string, 必須, ≤ 100 chars) — 名前またはハンドルの一部。@ はあってもなくても構いません。
- `limit` (integer, 任意, 既定値 10, 1–30) — 1 ページあたり最大何件まで。
- `cursor` (string, 任意, ≤ 1024 chars) — 同じ query の前のページで受け取った next_cursor。最初のページでは省略します。

## レスポンス

### `Response`

- `query` (string) — 検索に使った文字列。@ を除いた値。
- `items` (object[]) — 一致したアカウント。TikTok の順序。
- `total` (integer) — このページの候補の数。
- `has_more` (boolean) — TikTok に次のページがあれば true。
- `next_cursor` (string | null) — 同じ query と一緒に cursor として渡す値。最後のページなら null。
- `next` (string) — 最初の候補に対するコマンド。収集済みなら catalog のプロフィール、そうでなければ fetch tiktok account。候補があるときだけ。

### `items[]`

- `username` (string) — ハンドル。@ なし。
- `nickname` (string | null) — 表示名。
- `bio` (string | null) — bio のテキスト。
- `is_verified` (boolean | null) — 認証バッジ。
- `follower_count` (integer | null) — TikTok が現在表示しているフォロワー数。
- `profile_pic_url` (string | null) — プロフィール画像の URL。
- `url` (string) — 公開プロフィールの URL。
- `account_id` (uuid | null) — カタログにすでにあるアカウントなら TikTok の account_id、なければ null。

## 例

```console
$ solari fetch tiktok account search query=innisfree limit=1
```

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

```json
{
  "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 で呼び出す場合

```json
{
  "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 に一致するアカウントがありません。

## 関連ツール

- [`solari_fetch_tiktok_account`](https://pub.brandazine.ai/docs/tools/fetch-tiktok-account.md?lang=ja)
- [`solari_catalog_tiktok_account_search`](https://pub.brandazine.ai/docs/tools/catalog-tiktok-account-search.md?lang=ja)
- [`solari_catalog_tiktok_account_profile`](https://pub.brandazine.ai/docs/tools/catalog-tiktok-account-profile.md?lang=ja)
- [`solari_fetch_tiktok_post_search`](https://pub.brandazine.ai/docs/tools/fetch-tiktok-post-search.md?lang=ja)