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

solari fetch instagram post assets

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

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

개요

Instagram 게시물 하나의 미디어 파일을 모두, Instagram이 제공하는 가장 큰 크기로 내려받을 수 있는 새 링크를 돌려줍니다. 릴스, 사진이나 영상 한 개, 캐러셀의 모든 슬라이드가 대상입니다. 호출할 때마다 Instagram에서 바로 읽어 옵니다.

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

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

파라미터

urlstring선택
게시물 공개 URL(/p/, /reel/, /tv/).≤ 512 chars
slugstring선택
Instagram shortcode. url보다 우선입니다.pattern ^[A-Za-z0-9_-]{3,20}$

응답

Response

foundboolean
Instagram에 해당하는 공개 게시물이 없으면 false.
slugstring | null
게시물 shortcode.
urlstring | null
공개 고유 링크.
usernamestring | null
작성자 핸들.
post_typestring | null
reel, video, photo, 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 instagram post assets slug=DcyMAmUh6FZ

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

{
  "found": true,
  "slug": "DcyMAmUh6FZ",
  "video_id": null,
  "url": "https://www.instagram.com/p/DcyMAmUh6FZ/",
  "username": "innisfreeofficial",
  "post_type": "reel",
  "media_count": 1,
  "assets": [
    {
      "index": 1,
      "media_type": "video",
      "asset_url": "https://scontent-cph2-1.cdninstagram.com/….mp4?…",
      "fallback_urls": [],
      "width": 720,
      "height": 1280,
      "video_duration": 23.868,
      "file_extension": "mp4",
      "size_bytes": null,
      "referer": null
    }
  ],
  "note": null
}

MCP 호출

{
  "name": "solari_fetch_instagram_post_assets",
  "arguments": {
    "slug": "DcyMAmUh6FZ"
  }
}

주의사항

  • 파일을 한 번에 저장하려면 solari instagram download content slugs=… dir=…를 실행하세요. 이 도구를 호출하고 모든 파일을 내려받습니다.
  • 링크는 임시 서명 링크입니다. 바로 내려받고, 다시 필요하면 새로 호출하세요.
  • 호출할 때마다 Instagram에 요청하므로 몇 초 걸립니다.

관련 도구

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