← 전체 도구
tiktok · catalog · accountsolari:read

solari catalog tiktok account profile

TikTok 계정 프로필과 최근 게시물.

MCP 도구
solari_catalog_tiktok_account_profile
CLI
solari catalog tiktok account profile
권한
solari:read
이용 가능 플랜
  • 무료 체험
  • Plus
  • Pro
  • Enterprise
크레딧
1

개요

TikTok 계정 프로필과 최근 게시물 미리보기.

언제 쓰나요 — TikTok 계정을 전체적으로 파악하고 싶을 때.

돌려주는 값 — 프로필, 최근 게시물, 계정 수집 여부.

파라미터

account_idstring선택
TikTok account_id(SOLARI 계정 UUID). 이 값이나 username 중 하나를 넣으세요.uuid, pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
usernamestring선택
TikTok username. account_id가 있으면 무시합니다.≤ 64 chars

응답

Response

account_iduuid
TikTok account_id.
username / nickname / biostring
username, 표시 이름, 소개글.
bio_linksstring[]
소개글에 있는 링크.
follower_count / following_countinteger
팔로워 수와 팔로잉 수.
heart_countinteger
계정 전체의 누적 좋아요 수.
video_countinteger
게시한 영상 수.
is_verified / is_privateboolean
인증 여부와 비공개 여부.
is_commerce_user / commerce_user_categoryboolean · string
커머스 여부와 카테고리.
region / languagestring | null
지역 코드와 언어 코드.
avatar_url / profile_urlstring
프로필 사진과 공개 프로필 링크.
trackedboolean
정기 수집 대상인지 여부.
sync_statusstring
수집 상태.
synced_attimestamp
마지막 수집 시각.
recent_postsobject[]
최근 게시물 미리보기.
fetched_on_demandboolean
이번 호출에서 계정을 실시간으로 가져왔으면 true.

recent_posts[]

post_iduuid
TikTok 게시물 id. Instagram 값과 바꿔 쓸 수 없습니다.
video_idstring
TikTok URL에 있는 공개 숫자 id.
urlstring
공개 고유 링크.
account_iduuid
작성자 account_id.
usernamestring
작성자 username.
post_typestring
video 또는 carousel.
posted_attimestamp
게시 시각(UTC).
captionstring
캡션.
duration_secondsinteger
영상 길이.
width / heightinteger
해상도.
play_countinteger
재생 수.
like_countinteger
좋아요 수.
comment_countinteger
댓글 수.
share_countinteger
공유 수.
collect_countinteger
저장 수.
is_adboolean
TikTok 광고 표시.
is_pinnedboolean
프로필 상단 고정 여부.
aigc_label_typestring | null
AI 생성 콘텐츠 라벨. TikTok이 붙였을 때만 있습니다.
original_language_codestring | null
원본 언어.
cover_urlstring
커버 이미지 URL.
video_urlstring
영상 파일 URL.
imagesstring[]
캐러셀 슬라이드. 영상이면 비어 있습니다.
hashtagsstring[]
캡션에 있는 해시태그.
mentionsstring[]
캡션에서 멘션한 username.
transcriptstring | null
영상 자막. account posts와 content batch에서는 include_transcript=true일 때만 옵니다.
assetsobject[]
순서대로 담긴 미디어 파일. 각 파일에 asset_url, media_type, video_duration이 있습니다.
assets[].asset_urlstring | null
원본 크기 이미지나 영상을 바로 받는 다운로드 링크. 저장된 파일이 없으면 null.

예시

요청

$ solari catalog tiktok account profile username=innisfree_official

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

{
  "account_id": "019b2137-f76e-7b33-9437-26044fa7b1ed",
  "username": "innisfree_official",
  "nickname": "Innisfreeofficial",
  "bio": "NATURE MEETS KOREAN SKIN SCIENCE",
  "bio_links": [
    "https://linktr.ee/innisfree_official"
  ],
  "follower_count": 143900,
  "following_count": 14,
  "heart_count": 2200000,
  "video_count": 767,
  "is_verified": true,
  "is_private": false,
  "is_commerce_user": true,
  "commerce_user_category": "Beauty",
  "region": "KR",
  "language": null,
  "avatar_url": "https://p16-common-sign.tiktokcdn-eu.com/tos-alisg-avt-0068/3f8e48dc4a284a8ead37e93175ebdb86~tplv-tiktokx-cropcenter:720:720.jpeg?dr=10399&refresh_token=04b90255&x-expires=1788541200&x-signature=Gd3gJu4HyBZPCr%2FqEevyDs6 …",
  "profile_url": "https://www.tiktok.com/@innisfree_official",
  "sync_status": "OK",
  "tracked": true,
  "synced_at": "2026-09-02T17:16:05.835000Z",
  "recent_posts": [
    {
      "post_id": "01a0631e-f0df-7e9d-a09b-d84bc31d3834",
      "video_id": "7680375687139642645",
      "url": "https://www.tiktok.com/@innisfree_official/video/7680375687139642645",
      "account_id": "019b2137-f76e-7b33-9437-26044fa7b1ed",
      "username": "innisfree_official",
      "post_type": "video",
      "posted_at": "2026-09-02T12:00:00Z",
      "caption": "Deeply hydrated skin—NO OFF HOURS. 💚  wherever the day takes MINGYU—his hydration stays SUPERCHARGED ⚡️ Green Tea Ceramide Milk: Lightweight milky toner that won't clog your pores  Green Tea Ceramide Mist: Touch-free, fa …",
      "duration_seconds": 23,
      "width": 1080,
      "height": 1920,
      "play_count": 493,
      "like_count": 37,
      "comment_count": 2,
      "share_count": 0,
      "collect_count": 3,
      "is_ad": false,
      "is_pinned": false,
      "aigc_label_type": null,
      "original_language_code": null,
      "cover_url": "https://smr-images-a.bzine.co/tiktok/users/019b2137-f76e-7b33-9437-26044fa7b1ed/posts/01a0631e-f0df-7e9d-a09b-d84bc31d3834/medias/cover.jpg",
      "video_url": "https://smr-images-a.bzine.co/tiktok/users/019b2137-f76e-7b33-9437-26044fa7b1ed/posts/01a0631e-f0df-7e9d-a09b-d84bc31d3834/medias/origin.mp4",
      "images": [],
      "hashtags": [],
      "mentions": [],
      "transcript": null
    },
    "… 5 more"
  ],
  "fetched_on_demand": false
}

MCP 호출

{
  "name": "solari_catalog_tiktok_account_profile",
  "arguments": {
    "username": "innisfree_official"
  }
}

주의사항

  • 카탈로그만 읽습니다. 계정이 아직 카탈로그에 없으면 solari fetch tiktok account username=… 을 실행한 뒤 다시 시도하세요.
  • 찾을 수 없다는 오류가 오면 그 핸들이 카탈로그에 없다는 뜻입니다.

에이전트용 문서: /docs/tools/catalog-tiktok-account-profile.md