for agents
← 전체 도구
tiktok · fetchsolari:read

solari fetch tiktok post

URL로 TikTok 게시물 하나를 수집하고 작성자를 알려 줍니다.

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

개요

공개 URL로 TikTok 게시물 하나를 SOLARI 카탈로그에 수집하고, 누가 올렸는지 알려 줍니다. 이미 저장된 게시물이면 새로 수집하지 않습니다.

언제 쓰나요 — 게시물 링크는 있는데 catalog content detail이 item=null을 돌려주고, 작성자도 모를 때 쓰세요.

돌려주는 값 — 수집됐는지 여부, 작성자 정보가 붙은 게시물, 그 작성자를 수집하는 fetch 명령.

파라미터

urlstring필수
게시물 공개 URL. vm.tiktok.com, vt.tiktok.com 단축 링크도 됩니다.≤ 512 chars

응답

Response

ingestedboolean
이번 호출에서 바로 수집했으면 true.
already_trackedboolean
이미 카탈로그에 있었으면 true.
fetched_on_demandboolean
ingested와 같은 값.
foundboolean
그 URL에 TikTok 공개 게시물이 없으면 false.
post_iduuid
저장된 게시물.
account_iduuid
작성자 계정.
usernamestring
작성자 핸들.
itemobject | null
미디어 파일이 붙은 게시물.
notestring
다음에 일어날 일.
nextstring
작성자를 수집하는 fetch 명령.

item

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 fetch tiktok post url=https://www.tiktok.com/@innisfree_official/video/7680375687139642645

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

{
  "ingested": true,
  "already_tracked": false,
  "fetched_on_demand": true,
  "found": true,
  "post_id": "01a0631e-f0df-7e9d-a09b-d84bc31d3900",
  "account_id": "01a0631e-f0df-7e9d-a09b-d84bc31d3834",
  "username": "innisfree_official",
  "item": {
    "account_id": "01a0631e-f0df-7e9d-a09b-d84bc31d3834",
    "post_id": "01a0631e-f0df-7e9d-a09b-d84bc31d3900",
    "video_id": "7680375687139642645",
    "url": "https://www.tiktok.com/@innisfree_official/video/7680375687139642645",
    "username": "innisfree_official",
    "post_type": "video",
    "posted_at": "2026-09-01T09:00:00Z",
    "play_count": 12000,
    "like_count": 800
  },
  "note": "Collected live and stored now. The author is known by name only: run next to crawl their profile and posts.",
  "next": "solari fetch tiktok account username=innisfree_official"
}

MCP 호출

{
  "name": "solari_fetch_tiktok_post",
  "arguments": {
    "url": "https://www.tiktok.com/@innisfree_official/video/7680375687139642645"
  }
}

주의사항

  • 작성자는 이름만 등록된 계정으로 옵니다. 프로필과 게시물을 수집하려면 next에 있는 명령(fetch tiktok account)을 실행하세요.
  • 처음 수집할 때는 몇 초 걸립니다.

관련 도구

에이전트용 문서: /docs/tools/fetch-tiktok-post.md