tiktok · catalog · accountsolari:read

solari catalog tiktok account search

틱톡 사용자명이나 이름으로 TikTok 사용자를 찾아요. account_id를 확보하는 데 사용할 수 있어요.

MCP 도구: solari_catalog_tiktok_account_search
CLI: solari catalog tiktok account search
권한: solari:read로그인한 SOLARI 계정이면 쓸 수 있어요.로그인한 SOLARI 계정이면 쓸 수 있어요.
Required plan: Free
Credit: 0

개요

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

언제 쓰나 — 틱톡 이름이나 사용자명만 있고, account_id는 아직 없을 때 사용해요.

무엇이 나오나 — 맞는 계정 목록이에요. 가장 가까운 결과가 맨 앞에 와요.

파라미터

querystring필수: 이름 또는 TikTok 사용자명
limitinteger선택: 몇 명까지≥ 1
regionstring선택: KR, JP 같은 국가 코드. 비우면 전체를 찾아요≤ 8 chars

응답

Response

foundboolean: 맞는 계정이 있는지예요
itemsobject[]: 맞는 계정이에요. 가장 가까운 결과가 맨 앞이에요

items[]

account_iduuid: TikTok account_id예요. Instagram 것과는 서로 바꿔 쓸 수 없어요
usernamestring: TikTok 사용자명
nicknamestring: 표시 이름
follower_count / video_countinteger: 팔로워 수와 영상 수예요
regionstring | null: 국가 코드예요. 추적 중인 계정 중에도 없는 경우가 많아요
is_verified / is_privateboolean: 인증과 비공개 여부예요
is_commerce_userboolean: 커머스 계정인지예요
commerce_user_categorystring | null: 커머스 카테고리예요. Beauty 같은 값이에요
profile_urlstring: 공개 프로필 URL

예시

요청

$ solari catalog tiktok account search query=innisfree limit=5

응답 · 읽기 편하도록 긴 문자열과 반복되는 배열 항목을 줄였어요.

{
  "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 호출로 쓰면

{
  "name": "solari_catalog_tiktok_account_search",
  "arguments": {
    "query": "innisfree",
    "limit": 5
  }
}

주의사항

region을 넣으면 지정한 국가만 남고, region이 없는 계정은 빠져요. 특정 국가가 아니면 비워 두세요.
아직 수집되지 않은 사용자명은 여기에 안 나와요. catalog tiktok account profile에 넣으면 바로 가져와요.

기계가 읽는 형식: /docs/tools/catalog-tiktok-account-search.md

개요

파라미터

응답

예시

주의사항

관련 도구