# solari catalog instagram content detail

> id, shortcode, URL로 찾는 Instagram 게시물.

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

post_id, shortcode, 공개 URL로 Instagram 게시물 하나를 불러옵니다.

**언제 쓰나요** — 게시물 하나가 필요할 때. id가 여러 개면 content batch 도구를 쓰세요.

**돌려주는 값** — 캡션과 지표가 담긴 게시물.

## 파라미터

- `post_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)$) — post_id. 이 값이나 slug, url 중 하나를 넣으세요.
- `slug` (string, 선택, pattern ^[A-Za-z0-9_-]{3,20}$) — Instagram shortcode.
- `url` (string, 선택, ≤ 512 chars) — Instagram 게시물 공개 URL.

## 응답

### `Response`

- `item` (object | null) — 게시물. 없거나 공개되지 않은 게시물이면 null.
- `fetched_on_demand` (boolean) — 이번 호출에서 게시물을 실시간으로 가져왔으면 true.
- `note` (string) — item이 null일 때만 있습니다. 다음에 할 일.
- `next` (string) — item이 null이고 게시물을 URL이나 shortcode로 넣었을 때만 있습니다. 그 게시물을 수집하는 fetch post 명령어.

### `item`

- `post_id` (uuid) — 다른 콘텐츠 도구에 넣을 게시물 id.
- `slug` (string) — 공개 URL에 들어 있는 shortcode.
- `author_id` (uuid) — 작성자 account_id.
- `username` (string) — 작성자 사용자 이름.
- `full_name` (string | null) — 표시 이름.
- `profile_pic_url` (string | null) — 프로필 사진 URL.
- `follower_count` (integer | null) — 작성자 팔로워 수.
- `region` (string | null) — 작성자 지역.
- `posted_at` (timestamp) — 게시 시각(UTC).
- `media_type` (string) — image, video, carousel 중 하나.
- `play_count` (integer | null) — 영상 재생 수. 이미지면 null입니다.
- `like_count` (integer | null) — 좋아요 수.
- `text` (string | null) — 캡션.
- `media_url` (string) — 미디어 URL.
- `thumbnail_url` (string) — 썸네일 URL.
- `score` (number | null) — 순위 점수. 순위가 매겨진 목록이 아니면 null.
- `efficiency_score` (number | null) — 작성자 팔로워 수 대비 성과.
- `est_percentile` (number | null) — 지역 안 백분위(0~1).
- `total_views_3m` (integer | null) — 작성자의 최근 3개월 조회수.
- `median_views_3m` (integer | null) — 작성자의 최근 3개월 조회수 중앙값.
- `recent_collab_brands` (string[]) — 작성자가 최근 협업한 브랜드.
- `item_type` (string) — 항목 종류. 항상 "content".
- `content_source` (string | null) — 게시물이 나온 피드. 피드에서 온 게 아니면 null.
- `is_saved` (boolean | null) — SOLARI에 이 게시물을 저장했는지. 알 수 없으면 null.
- `updated_at` (timestamp | null) — 지표를 마지막으로 갱신한 시각.
- `assets` (object[]) — 미디어 파일 목록(순서대로). 파일마다 asset_url, media_type, video_duration이 있습니다.
- `assets[].asset_url` (string | null) — 원본 크기 이미지나 영상을 바로 내려받는 링크. 저장된 파일이 없으면 null입니다.

## 예시

```console
$ solari catalog instagram content detail slug=DcyMAmUh6FZ
```

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

```json
{
  "item": {
    "item_type": "content",
    "post_id": "01a06275-d974-7fda-98ee-dd3ee15b4dcf",
    "author_id": "018cabce-14cc-7544-8890-7811ec33ef74",
    "username": "innisfreeofficial",
    "full_name": "INNISFREE | 이니스프리",
    "profile_pic_url": "https://dcr.bzine.co/instagram/users/innisfreeofficial/profile-picture",
    "follower_count": 847619,
    "region": null,
    "posted_at": "2026-09-02T12:00:06Z",
    "media_type": "video",
    "play_count": 22467,
    "like_count": 3224,
    "score": null,
    "efficiency_score": null,
    "est_percentile": null,
    "updated_at": null,
    "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 …",
    "slug": "DcyMAmUh6FZ",
    "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 …",
    "brand_match_score": null,
    "recent_collab_brands": [],
    "total_views_3m": null,
    "median_views_3m": null,
    "is_saved": null,
    "content_source": null
  },
  "fetched_on_demand": false
}
```

## MCP 호출

```json
{
  "name": "solari_catalog_instagram_content_detail",
  "arguments": {
    "slug": "DcyMAmUh6FZ"
  }
}
```

## 주의사항

- url에는 /p/, /reel/, /tv/ 링크를 아무거나 넣으면 됩니다. shortcode는 알아서 뽑습니다.
- SOLARI에 모아 둔 데이터만 읽습니다. 아직 수집하지 않은 게시물은 solari fetch instagram post url=…로 가져오세요. 작성자도 함께 알려 줍니다. 작성자를 이미 알면 solari fetch instagram posts username=…를 쓰세요.
- likes_hidden이 true면 like_count를 쓰지 마세요. 작성자가 좋아요를 숨겨서 null이거나 실제 값이 아닐 수 있습니다.

## 관련 도구

- [`solari_fetch_instagram_post`](https://clip-pub.bzine.co/docs/tools/fetch-instagram-post.md?lang=ko)
- [`solari_catalog_instagram_content_batch`](https://clip-pub.bzine.co/docs/tools/catalog-instagram-content-batch.md?lang=ko)
- [`solari_catalog_instagram_content_history`](https://clip-pub.bzine.co/docs/tools/catalog-instagram-content-history.md?lang=ko)
- [`solari_catalog_instagram_account_posts`](https://clip-pub.bzine.co/docs/tools/catalog-instagram-account-posts.md?lang=ko)
