for agents
← 전체 도구
instagram · catalog · accountsolari:read

solari catalog instagram account posts

Instagram 계정의 게시물.

MCP 도구
solari_catalog_instagram_account_posts
CLI
solari catalog instagram account posts
권한
solari:read
이용 가능 플랜
  • 무료 체험
  • Plus
  • Pro
  • Enterprise
크레딧
1

개요

Instagram 계정의 게시물을 미디어, 태그, 좋아요 수와 함께 보여 줍니다. 날짜나 형식으로 거를 수 있습니다.

언제 쓰나요 — 프로필 미리보기보다 많은 게시물이 필요하거나, 날짜 범위나 형식을 정해야 할 때.

돌려주는 값 — 게시물. 캐러셀 슬라이드와 태그된 계정·해시태그도 들어 있습니다.

파라미터

account_idstring선택
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선택
Instagram 사용자 이름. account_id를 넣으면 무시됩니다.≤ 64 chars
limitinteger선택
한 페이지에 가져올 게시물 수.기본값 121–200
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선택
reel, video, photo, carousel 중 하나로 좁힙니다.값reelvideophotocarousel

응답

Response

foundboolean
Instagram에 없는 username이면 false.
account_id / usernamestring
찾은 계정.
totalinteger
필터에 맞는 게시물 수.
has_moreboolean
다음 페이지가 있는지 여부.
itemsobject[]
게시물. 최신순입니다.
fetched_on_demandboolean
아직 최근 게시물만 볼 수 있으면 true.
collected_attimestamp
Instagram에서 프로필을 마지막으로 수집한 시각(UTC).
posts_collected_attimestamp
저장된 게시물이 어디까지 수집됐는지(UTC). 그 뒤 게시물은 아직 카탈로그에 없습니다.
refreshes_regularlyboolean
정해진 주기로 다시 수집되는 계정인지 여부.
stored_post_count / profile_post_countinteger
카탈로그에 저장된 게시물 수와 프로필에 표시된 게시물 수. 저장된 수가 훨씬 적으면 수집이 덜 된 것입니다.
refreshedboolean
하루 넘게 지난 저장본을 이번 호출에서 다시 수집했으면 true.
notestring | null
결과가 덜 찼을 수 있는 이유, 또는 found가 false인 이유(이름이 바뀌었거나 삭제됨).

items[]

post_iduuid
SOLARI 게시물 id.
slugstring
Instagram shortcode.
urlstring
공개 고유 링크.
post_typestring
reel, video, photo, carousel 중 하나.
posted_attimestamp
게시 시각(UTC).
textstring
캡션.
like_count / comment_count / play_countinteger
참여 지표.
media_countinteger
미디어 수.
is_paid_partnershipboolean | null
Instagram 유료 파트너십 표시.
mediasobject[]
캐러셀 순서대로 나열한 모든 미디어.
medias[].tagsobject[]
미디어에 태그된 계정과 해시태그.
thumbnail_urlstring
썸네일.
assetsobject[]
미디어 파일 목록(순서대로). 파일마다 asset_url, media_type, video_duration이 있습니다.
assets[].asset_urlstring | null
원본 크기 이미지나 영상을 바로 내려받는 링크. 저장된 파일이 없으면 null입니다.

예시

요청

$ solari catalog instagram account posts username=innisfreeofficial limit=2

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

{
  "found": true,
  "account_id": "018cabce-14cc-7544-8890-7811ec33ef74",
  "username": "innisfreeofficial",
  "fetched_on_demand": false,
  "total": 4196,
  "has_more": true,
  "items": [
    {
      "post_id": "01a06275-d974-7fda-98ee-dd3ee15b4dcf",
      "slug": "DcyMAmUh6FZ",
      "url": "https://www.instagram.com/p/DcyMAmUh6FZ/",
      "post_type": "reel",
      "posted_at": "2026-09-02T12:00:06+00:00",
      "text": "Deeply hydrated skin—NO OFF HOURS. 💚\nwherever the day takes MINGYU (@min9yu_k)—his hydration stays SUPERCHARGED ⚡️\n\nGreen Tea Ceramide Milk: Lightweight milky toner that won‘t clog your pores\nGreen Tea Ceramide Mist: Tou …",
      "like_count": 3224,
      "comment_count": 57,
      "play_count": 22467,
      "likes_hidden": false,
      "media_count": 1,
      "is_paid_partnership": false,
      "medias": [
        {
          "media_type": "video",
          "media_url": "https://smr-images-b.bzine.co/users/018cabce-14cc-7544-8890-7811ec33ef74/posts/01a06275-d974-7fda-98ee-dd3ee15b4dcf/medias/01a06275-db2b-77f7-a020-b4beb744771f.mp4",
          "thumbnail_url": "https://bzine.co/cdn-cgi/media/width=480,mode=frame,time=0ms/https://smr-images.bzine.co/users/018cabce-14cc-7544-8890-7811ec33ef74/posts/01a06275-d974-7fda-98ee-dd3ee15b4dcf/medias/01a06275-db2b-77f7-a020-b4beb744771f.m …",
          "video_duration": 23.868000030517578,
          "tags": []
        }
      ],
      "thumbnail_url": "https://bzine.co/cdn-cgi/media/width=480,mode=frame,time=0ms/https://smr-images.bzine.co/users/018cabce-14cc-7544-8890-7811ec33ef74/posts/01a06275-d974-7fda-98ee-dd3ee15b4dcf/medias/01a06275-db2b-77f7-a020-b4beb744771f.m …"
    },
    "… 1 more"
  ]
}

MCP 호출

{
  "name": "solari_catalog_instagram_account_posts",
  "arguments": {
    "username": "innisfreeofficial",
    "limit": 2
  }
}

주의사항

  • since와 until은 UTC 날짜이고, 두 날짜 모두 포함합니다.
  • post_type=reel은 짧은 영상(릴스)입니다. video는 릴스가 아닌 영상입니다.
  • 카탈로그에는 빠진 게시물이 있거나 오래된 정보가 있을 수 있습니다. solari fetch instagram posts username=…(조회수는 type=reels)로 실시간 수집하면 게시물을 바로 돌려받습니다.
  • 요청한 날짜가 posts_collected_at보다 뒤라면 결과가 비어 있어도 게시물이 없다는 뜻이 아닙니다. solari fetch instagram posts username=…으로 최신 게시물을 실시간 수집하세요.
  • likes_hidden이 true면 like_count를 쓰지 마세요. 작성자가 좋아요를 숨겨서 null이거나 실제 값이 아닐 수 있습니다.

관련 도구

에이전트용 문서: /docs/tools/catalog-instagram-account-posts.md