tiktok · contentsolari:read

solari tiktok content batch

한 번의 호출로 TikTok 포스트 id를 최대 100개까지 실제 데이터로 채워요.

MCP 도구: solari_tiktok_content_batch
CLI: solari tiktok content batch
권한: solari:read로그인한 SOLARI 계정이면 쓸 수 있어요.로그인한 SOLARI 계정이면 쓸 수 있어요.

개요

solari_tiktok_content_detail의 배치 버전. TikTok 포스트를 SOLARI 포스트 UUID로 한 번에 최대 100개까지 채워서 반환하며, 항목 형태는 solari_tiktok_account_posts의 항목과 같아요. 추적 중이 아닌 id는 빠지므로 found가 요청한 개수보다 적을 수 있어요. 전사문은 길기 때문에 include_transcript는 기본적으로 꺼져 있어요. solari_tiktok_account_posts, solari_tiktok_content_search, solari_tiktok_account_profile이 준 post_id 목록을 그대로 넣으면 돼요. TikTok post_ids는 Instagram post_ids와 별개예요. 로그인한 모든 SOLARI 계정에서 사용할 수 있어요.

언제 쓰나 — 검색이나 계정 포스트에서 얻은 id 목록을 한꺼번에 펼칠 때.

무엇이 돌아오나 — 요청한 id 중에서 찾은 포스트.

파라미터

post_idsuuid[]필수: 채울 SOLARI 포스트 UUID. 호출당 최대 100개. TikTok video id가 아니에요.1–100 items, uuid
sortenum선택: 항목 정렬: posted_at 내림차순(recent) 또는 engagement 내림차순.기본값 "recent"값recentengagement
include_transcriptboolean선택: 각 항목에 음성 전사문을 붙여요. 전사문이 길어서 기본값은 꺼짐.기본값 false

응답

Response

requestedinteger: 보낸 id 개수.
foundinteger: 찾아낸 개수.
itemsobject[]: 찾은 포스트.

items[]

post_iduuid: SOLARI 포스트 id. Instagram 포스트 id와는 다른 네임스페이스예요.
video_idstring: 공개 숫자 TikTok id — /video/ 또는 /photo/ 뒤에 오는 숫자.
urlstring: 공개 TikTok 퍼머링크.
account_iduuid: 작성자의 TikTok 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: TikTok이 붙인 경우의 AI 생성 콘텐츠 라벨.
original_language_codestring | null: 원본 언어 코드.
cover_urlstring: 커버 이미지 URL.
video_urlstring: 영상 파일 URL.
imagesstring[]: 캐러셀 슬라이드. video 포스트에서는 비어 있어요.
hashtagsstring[]: 캡션에서 파싱한 해시태그.
mentionsstring[]: 캡션에서 멘션된 핸들.
transcriptstring | null: 음성 전사문. include_transcript=true일 때만 채워져요.

예시

요청

$ solari tiktok content batch post_ids='["01a0631e-f0df-7e9d-a09b-d84bc31d3834"]'

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

{
  "requested": 1,
  "found": 1,
  "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-b.bzine.co/tiktok/users/019b2137-f76e-7b33-9437-26044fa7b1ed/posts/01a0631e-f0df-7e9d-a09b-d84bc31d3834/medias/origin.mp4",
      "images": [],
      "hashtags": [],
      "mentions": [],
      "transcript": null
    }
  ]
}

MCP 호출로 쓰면

{
  "name": "solari_tiktok_content_batch",
  "arguments": {
    "post_ids": [
      "01a0631e-f0df-7e9d-a09b-d84bc31d3834"
    ]
  }
}

주의사항

SOLARI 포스트 UUID만 받아요. 숫자로 된 TikTok video id는 여기 들어가지 않아요 — 그건 content detail에 video_id로 넣으세요.
TikTok 포스트 id와 Instagram 포스트 id는 별개의 네임스페이스예요.

기계가 읽는 형식: /docs/tools/tiktok-content-batch.md

개요

파라미터

응답

예시

주의사항

관련 도구