for agents
← 전체 도구
tiktok · fetch · postsolari:read

solari fetch tiktok post assets

TikTok 게시물 하나의 원본 크기 다운로드 링크.

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

개요

TikTok 게시물 하나의 미디어를 TikTok이 제공하는 가장 큰 크기로 내려받을 수 있는 새 링크를 돌려줍니다. 영상 하나, 또는 사진 게시물의 모든 사진이 대상입니다. 호출할 때마다 TikTok에서 바로 읽어 옵니다.

언제 쓰나요 — 게시물의 원본 파일이 필요할 때 쓰세요. 다른 도구의 assets는 저장된 사본을 가리키며, 원본보다 작을 수 있습니다.

돌려주는 값 — 작성자와 게시물 유형, 그리고 미디어 파일마다 순서대로 다운로드 링크 하나.

파라미터

urlstring선택
게시물 공개 URL. vm.tiktok.com, vt.tiktok.com 단축 링크도 됩니다. video_id보다 우선입니다.≤ 512 chars
video_idstring선택
숫자 video id. 이미 카탈로그에 있는 게시물만 됩니다. 그 외에는 url을 쓰세요.pattern ^\d{15,20}$

응답

Response

foundboolean
그 참조에 TikTok 공개 게시물이 없으면 false.
video_idstring | null
게시물의 공개 숫자 id.
urlstring | null
공개 고유 링크.
usernamestring | null
작성자 핸들.
post_typestring | null
video 또는 carousel.
media_countinteger
assets에 들어 있는 파일 수.
assetsobject[]
미디어 파일 목록(순서대로).
notestring | null
내려받을 파일이 없을 때 그 이유.

assets[]

indexinteger
게시물 안에서 파일의 순서. 1부터 시작합니다.
media_typestring
video 또는 image.
asset_urlstring
플랫폼이 제공하는 가장 큰 크기의 파일 다운로드 링크. 임시 링크라 바로 내려받아야 합니다.
fallback_urlsstring[]
같은 파일의 다른 링크. asset_url이 실패하면 순서대로 시도합니다.
widthinteger | null
가로 픽셀 수. 알 수 있을 때만 있습니다.
heightinteger | null
세로 픽셀 수. 알 수 있을 때만 있습니다.
video_durationnumber | null
영상 길이(초).
file_extensionstring
저장할 때 쓸 파일 확장자. 예: mp4, jpg.
size_bytesinteger | null
파일 크기(바이트). 알 수 있을 때만 있습니다.
refererstring | null
내려받을 때 Referer 헤더로 보내야 하는 값. 필요 없으면 null입니다.

예시

요청

$ solari fetch tiktok post assets url=https://www.tiktok.com/@innisfree_official/video/7680375687139642645

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

{
  "found": true,
  "slug": null,
  "video_id": "7680375687139642645",
  "url": "https://www.tiktok.com/@innisfree_official/video/7680375687139642645",
  "username": "innisfree_official",
  "post_type": "video",
  "media_count": 1,
  "assets": [
    {
      "index": 1,
      "media_type": "video",
      "asset_url": "https://www.tiktok.com/aweme/v1/play/?…",
      "fallback_urls": [
        "https://www.tiktok.com/aweme/v1/play/?…"
      ],
      "width": 1080,
      "height": 1920,
      "video_duration": 23,
      "file_extension": "mp4",
      "size_bytes": 2775677,
      "referer": "https://www.tiktok.com/"
    }
  ],
  "note": null
}

MCP 호출

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

주의사항

  • 파일을 한 번에 저장하려면 solari tiktok download content urls=… dir=…를 실행하세요. 이 도구를 호출하고 모든 파일을 내려받습니다.
  • TikTok은 Referer 헤더가 없는 영상 다운로드를 거부합니다. 요청에 referer 값을 함께 보내세요.
  • 링크는 임시 서명 링크입니다. 바로 내려받고, 다시 필요하면 새로 호출하세요.

관련 도구

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