# 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

사용자명이나 이름으로 틱톡 브랜드·크리에이터를 찾아요. Instagram account_id는 여기서 쓸 수 없어요.

**언제 쓰나** — 틱톡 이름이나 사용자명만 있고, 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=ko)
- [`solari_catalog_tiktok_account_posts`](https://solari.sh/docs/tools/catalog-tiktok-account-posts.md?lang=ko)
- [`solari_catalog_instagram_account_search`](https://solari.sh/docs/tools/catalog-instagram-account-search.md?lang=ko)