# solari catalog instagram account posts

> Instagram 계정의 게시물.

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

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

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

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

## 파라미터

- `account_id` (string, 선택, 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)$) — account_id나 username을 넣으세요.
- `username` (string, 선택, ≤ 64 chars) — Instagram 사용자 이름. account_id를 넣으면 무시됩니다.
- `limit` (integer, 선택, 기본값 12, 1–200) — 한 페이지에 가져올 게시물 수.
- `offset` (integer, 선택, 기본값 0, ≥ 0) — 건너뛸 게시물 수.
- `since` (string, 선택, pattern ^\d{4}-\d{2}-\d{2}$) — 이 날짜(UTC, YYYY-MM-DD)부터 올라온 게시물만 가져옵니다.
- `until` (string, 선택, pattern ^\d{4}-\d{2}-\d{2}$) — 이 날짜(UTC, YYYY-MM-DD)까지 올라온 게시물만 가져옵니다.
- `post_type` (enum, 선택) — reel, video, photo, carousel 중 하나로 좁힙니다. 값: `reel`, `video`, `photo`, `carousel`.

## 응답

### `Response`

- `found` (boolean) — Instagram에 없는 username이면 false.
- `account_id / username` (string) — 찾은 계정.
- `total` (integer) — 필터에 맞는 게시물 수.
- `has_more` (boolean) — 다음 페이지가 있는지 여부.
- `items` (object[]) — 게시물. 최신순입니다.
- `fetched_on_demand` (boolean) — 아직 최근 게시물만 볼 수 있으면 true.
- `collected_at` (timestamp) — Instagram에서 프로필을 마지막으로 수집한 시각(UTC).
- `posts_collected_at` (timestamp) — 저장된 게시물이 어디까지 수집됐는지(UTC). 그 뒤 게시물은 아직 카탈로그에 없습니다.
- `refreshes_regularly` (boolean) — 정해진 주기로 다시 수집되는 계정인지 여부.
- `stored_post_count / profile_post_count` (integer) — 카탈로그에 저장된 게시물 수와 프로필에 표시된 게시물 수. 저장된 수가 훨씬 적으면 수집이 덜 된 것입니다.
- `refreshed` (boolean) — 하루 넘게 지난 저장본을 이번 호출에서 다시 수집했으면 true.
- `note` (string | null) — 결과가 덜 찼을 수 있는 이유, 또는 found가 false인 이유(이름이 바뀌었거나 삭제됨).

### `items[]`

- `post_id` (uuid) — SOLARI 게시물 id.
- `slug` (string) — Instagram shortcode.
- `url` (string) — 공개 고유 링크.
- `post_type` (string) — reel, video, photo, carousel 중 하나.
- `posted_at` (timestamp) — 게시 시각(UTC).
- `text` (string) — 캡션.
- `like_count / comment_count / play_count` (integer) — 참여 지표.
- `media_count` (integer) — 미디어 수.
- `is_paid_partnership` (boolean | null) — Instagram 유료 파트너십 표시.
- `medias` (object[]) — 캐러셀 순서대로 나열한 모든 미디어.
- `medias[].tags` (object[]) — 미디어에 태그된 계정과 해시태그.
- `thumbnail_url` (string) — 썸네일.
- `assets` (object[]) — 미디어 파일 목록(순서대로). 파일마다 asset_url, media_type, video_duration이 있습니다.
- `assets[].asset_url` (string | null) — 원본 크기 이미지나 영상을 바로 내려받는 링크. 저장된 파일이 없으면 null입니다.

## 예시

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

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

```json
{
  "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 호출

```json
{
  "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이거나 실제 값이 아닐 수 있습니다.

## 관련 도구

- [`solari_catalog_instagram_account_profile`](https://clip-pub.bzine.co/docs/tools/catalog-instagram-account-profile.md?lang=ko)
- [`solari_catalog_instagram_content_detail`](https://clip-pub.bzine.co/docs/tools/catalog-instagram-content-detail.md?lang=ko)
- [`solari_catalog_instagram_content_history`](https://clip-pub.bzine.co/docs/tools/catalog-instagram-content-history.md?lang=ko)
- [`solari_catalog_tiktok_account_posts`](https://clip-pub.bzine.co/docs/tools/catalog-tiktok-account-posts.md?lang=ko)