instagram · accountsolari:read

solari instagram account posts

계정 하나의 포스트를 최신순으로 페이지 단위로 훑어요.

MCP 도구: solari_instagram_account_posts
CLI: solari instagram account posts
권한: solari:read로그인한 SOLARI 계정이면 쓸 수 있어요.로그인한 SOLARI 계정이면 쓸 수 있어요.

개요

추적 중인 Instagram 계정 하나의 포스트를 최신순으로, 페이지네이션과 필터와 함께 반환해요. 계정은 account_id(solari_instagram_account_search가 주는 UUID) 또는 username(Instagram 핸들)으로 지정해요. 각 항목에는 post_id(SOLARI 포스트 UUID), slug와 url(공개 Instagram 퍼머링크), post_type(reel, video, photo, carousel), posted_at, 캡션 텍스트, like/comment/play 카운트, media_count, is_paid_partnership, medias 배열(포스트의 모든 미디어를 캐러셀 순서로 담고, 각각 media_type, media/thumbnail URL, video_duration, 그리고 tags — 그 미디어에 태그된 계정과 해시태그를 가지며, 태그된 계정이 추적 중이면 account_id도 함께 담겨요), 대표 thumbnail_url이 담겨요. 응답에는 found, account_id, username, total, has_more, items가 실려요. limit과 offset으로 페이지를 넘기고, since/until(UTC 날짜, 양끝 포함)과 post_type으로 범위를 좁혀요. 아직 추적 중이 아닌 username은 첫 요청 때 실시간으로 수집되며(수 초 소요), fetched_on_demand=true는 지금까지 가장 최근 포스트만 사용할 수 있다는 표시예요. found=false는 그 핸들이 Instagram에 존재하지 않는다는 뜻이에요. 로그인한 모든 SOLARI 계정에서 사용할 수 있어요.

언제 쓰나 — 프로필 미리보기보다 더 깊이 파고들 때, 또는 기간과 포맷으로 좁힌 원본 행을 가져올 때.

무엇이 돌아오나 — 각 포스트의 모든 미디어를 포함한 포스트. 미디어에 태그된 계정과 해시태그도 함께.

파라미터

account_idstring선택: 계정의 account_id(SOLARI 계정 UUID). 이 값 또는 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선택: 페이지당 포스트 수, 기본값 12. 200을 넘는 값은 200으로 잘려요.≥ 1
offsetinteger선택: 페이지네이션 offset, 기본값 0.기본값 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는 reel이 아닌 영상이에요.값reelvideophotocarousel

응답

Response

foundboolean: false면 그 핸들이 Instagram에 존재하지 않는다는 뜻이에요.
account_id / usernamestring: 확인된 계정.
totalinteger: 필터에 맞는 포스트 수.
has_moreboolean: 다음 페이지가 있는지 여부.
itemsobject[]: 포스트. 최신순.
fetched_on_demandboolean: 지금까지 가장 최근 포스트만 사용할 수 있으면 true.

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[]: 캐러셀 순서의 모든 미디어 — 각각 media_type, media/thumbnail URL, video_duration을 가져요.
medias[].tagsobject[]: 그 미디어에 태그된 계정과 해시태그. 태그된 계정을 SOLARI가 추적 중이면 account_id가 함께 담겨요.
thumbnail_urlstring: 대표 썸네일.

예시

요청

$ solari 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,
      "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_instagram_account_posts",
  "arguments": {
    "username": "innisfreeofficial",
    "limit": 2
  }
}

주의사항

페이지당 최대 200개. 대량으로 가져올 때는 큰 페이지를 메모리에 올리기보다 --ndjson으로 파일에 이어 쓰는 편이 나아요.
since와 until은 UTC 날짜이며 양끝을 포함해요.
post_type=reel은 숏폼 단일 영상, video는 reel이 아닌 영상이에요.

기계가 읽는 형식: /docs/tools/instagram-account-posts.md

개요

파라미터

응답

예시

주의사항

관련 도구