tiktok · catalog · accountsolari:read

solari catalog tiktok account posts

TikTok 계정이 올린 포스트예요.

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

개요

TikTok 계정의 포스트를 보여 줘요. 말한 내용이 필요할 때만 include_transcript를 켜 주세요.

언제 쓰나 — 프로필 미리보기보다 더 많은 포스트가 필요하거나, 기간·형식으로 나누고 싶을 때 사용해요.

무엇이 나오나 — 포스트 목록이에요. 요청하면 대본도 붙어요.

파라미터

account_idstring선택: TikTok account_id 또는 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 사용자명. account_id가 있으면 무시돼요≤ 64 chars
limitinteger선택: 한 페이지에 몇 개까지≥ 1
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에 없는 사용자명이면 false예요.
account_id / usernamestring: 찾은 계정이에요
totalinteger: 필터에 맞는 포스트예요
has_moreboolean: 다음 페이지가 있는지예요
itemsobject[]: 포스트예요. 최신순이에요
fetched_on_demandboolean: 아직 가장 최근 포스트만 있으면 true예요

items[]

post_iduuid: TikTok 포스트 id예요. Instagram 것과는 서로 바꿔 쓸 수 없어요
video_idstring: TikTok URL에 있는 공개 숫자 id예요
urlstring: 공개 링크예요
account_iduuid: 작성자 account_id
usernamestring: 작성자 사용자명
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[]: 캡션에서 멘션된 사용자명이에요
transcriptstring | null: 말한 대본이에요. include_transcript=true일 때만 와요

예시

요청

$ 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는 기본이 꺼져 있어요.
This reads the catalog only. If the username is missing, call solari fetch tiktok posts username=… then retry.

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

개요

파라미터

응답

예시

주의사항

관련 도구