tiktok · catalog · accountsolari:read
solari catalog tiktok account search
추적 중인 TikTok 계정을 username이나 이름으로 찾습니다. account_id를 얻을 때 씁니다.
- MCP 도구
- solari_catalog_tiktok_account_search
- CLI
- 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부터 쓰세요.
돌려주는 값 — 일치하는 계정. 가장 가까운 순서입니다.
파라미터
- querystring필수
- 이름 또는 TikTok username.
- limitinteger선택
- 받을 계정 수.기본값
81–50 - regionstring선택
- KR, JP 같은 국가 코드. 비워 두면 전체 지역에서 찾습니다.≤ 8 chars
응답
Response
- foundboolean
- 일치하는 계정이 있는지 여부.
- itemsobject[]
- 일치한 계정. 가장 가까운 순서입니다.
items[]
- account_iduuid
- TikTok account_id. Instagram 값과 바꿔 쓸 수 없습니다.
- usernamestring
- TikTok username.
- 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을 넣으면 그 국가 계정만 남고, 지역 정보가 없는 계정은 빠집니다. 꼭 필요할 때만 넣으세요.
- SOLARI가 아직 수집하지 않은 username은 여기 나오지 않습니다. fetch tiktok account search로 찾거나 정확한 핸들을 solari fetch tiktok account에 넘긴 다음, 카탈로그 TikTok 계정 프로필로 읽으세요.