# solari catalog instagram account posts

> Instagram 계정이 올린 포스트예요.

- **CLI**: `solari catalog instagram account posts`
- **MCP 도구**: `solari_catalog_instagram_account_posts`
- **권한**: `solari:read` — 로그인한 SOLARI 계정이면 쓸 수 있어요.
- **Required plan**: Free
- **Credit**: 0

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, 선택, ≥ 1) — 한 페이지에 몇 개까지
- `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에 없는 사용자명이면 false예요.
- `account_id / username` (string) — 찾은 계정이에요
- `total` (integer) — 필터에 맞는 포스트예요
- `has_more` (boolean) — 다음 페이지가 있는지예요
- `items` (object[]) — 포스트예요. 최신순이에요
- `fetched_on_demand` (boolean) — 아직 가장 최근 포스트만 있으면 true예요

### `items[]`

- `post_id` (uuid) — SOLARI 포스트 id
- `slug` (string) — Instagram 숏코드
- `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) — 썸네일

## 예시

```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,
      "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는 reel이 아닌 영상이에요.
- This reads the catalog only. If the username is missing, call solari fetch instagram posts username=… then retry.

## 관련 도구

- [`solari_catalog_instagram_account_profile`](https://solari.sh/docs/tools/catalog-instagram-account-profile.md?lang=ko)
- [`solari_catalog_instagram_content_detail`](https://solari.sh/docs/tools/catalog-instagram-content-detail.md?lang=ko)
- [`solari_catalog_tiktok_account_posts`](https://solari.sh/docs/tools/catalog-tiktok-account-posts.md?lang=ko)