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

solari catalog tiktok account posts

TikTok 계정의 게시물.

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

개요

TikTok 계정의 게시물 목록을 가져옵니다. 영상에서 말한 내용이 필요할 때만 include_transcript를 켜세요.

언제 쓰나요 — 프로필 미리보기보다 많은 게시물이 필요하거나, 기간이나 형식으로 거르고 싶을 때 쓰세요.

돌려주는 값 — 게시물 목록. 요청하면 영상 자막도 함께 옵니다.

파라미터

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
limitinteger선택
한 페이지에 가져올 게시물 수.기본값 121–200
offsetinteger선택
건너뛸 게시물 수.기본값 0≥ 0
sincestring선택
이 날짜(UTC, YYYY-MM-DD) 이후에 올라온 게시물만 가져옵니다. 당일 포함.pattern ^\d{4}-\d{2}-\d{2}$
untilstring선택
이 날짜(UTC, YYYY-MM-DD) 이전에 올라온 게시물만 가져옵니다. 당일 포함.pattern ^\d{4}-\d{2}-\d{2}$
post_typeenum선택
video나 carousel 중 하나로 좁힙니다.값videocarousel
include_transcriptboolean선택
영상 자막을 함께 가져옵니다.기본값 false

응답

Response

foundboolean
TikTok에 없는 username이면 false.
account_id / usernamestring
찾은 계정.
totalinteger
필터에 맞는 게시물 수.
has_moreboolean
다음 페이지가 있는지 여부.
itemsobject[]
게시물 목록. 최신순.
fetched_on_demandboolean
아직 최근 게시물만 수집돼 있으면 true.

items[]

post_iduuid
TikTok 게시물 id. Instagram 게시물 id와 섞어 쓸 수 없습니다.
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 posts username=innisfree_official limit=2

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

{
  "found": true,
  "account_id": "019b2137-f76e-7b33-9437-26044fa7b1ed",
  "username": "innisfree_official",
  "total": 87,
  "has_more": true,
  "items": [
    {
      "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-b.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
    },
    "… 1 more"
  ],
  "fetched_on_demand": false
}

MCP 호출

{
  "name": "solari_catalog_tiktok_account_posts",
  "arguments": {
    "username": "innisfree_official",
    "limit": 2
  }
}

주의사항

  • 영상 자막은 용량이 커서 include_transcript는 기본으로 꺼져 있습니다.
  • 카탈로그만 읽습니다. 계정이 아직 카탈로그에 없으면 solari fetch tiktok posts username=… 을 실행한 뒤 다시 시도하세요.

관련 도구

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