# 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 값과 바꿔 쓸 수 없습니다.
- `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=ko)
- [`solari_catalog_tiktok_account_posts`](https://clip-pub.bzine.co/docs/tools/catalog-tiktok-account-posts.md?lang=ko)
- [`solari_catalog_instagram_account_search`](https://clip-pub.bzine.co/docs/tools/catalog-instagram-account-search.md?lang=ko)