# solari fetch instagram post

> URL로 Instagram 게시물 하나를 수집하고 작성자를 알려 줍니다.

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

공개 URL이나 shortcode로 Instagram 게시물 하나를 SOLARI 카탈로그에 수집하고, 누가 올렸는지 알려 줍니다. 이미 저장된 게시물이면 새로 수집하지 않습니다.

**언제 쓰나요** — 게시물 링크는 있는데 catalog content detail이 item=null을 돌려주고, 작성자도 모를 때 쓰세요.

**돌려주는 값** — 수집됐는지 여부, 작성자 정보가 붙은 게시물, 그 작성자를 수집하는 fetch 명령.

## 파라미터

- `url` (string, 선택, ≤ 512 chars) — 게시물 공개 URL(/p/, /reel/, /tv/).
- `slug` (string, 선택, pattern ^[A-Za-z0-9_-]{3,20}$) — Instagram shortcode. url보다 우선입니다.

## 응답

### `Response`

- `ingested` (boolean) — 이번 호출에서 바로 수집했으면 true.
- `already_tracked` (boolean) — 이미 카탈로그에 있었으면 true.
- `fetched_on_demand` (boolean) — ingested와 같은 값.
- `found` (boolean) — Instagram에 해당하는 공개 게시물이 없으면 false.
- `post_id` (uuid) — 저장된 게시물.
- `account_id` (uuid) — 작성자 계정.
- `username` (string) — 작성자 핸들.
- `item` (object | null) — 미디어 파일이 붙은 게시물.
- `note` (string) — 다음에 일어날 일.
- `next` (string) — 작성자를 수집하는 fetch 명령.

### `item`

- `post_id` (uuid) — 다른 콘텐츠 도구에 넣을 게시물 id.
- `slug` (string) — 공개 URL에 들어 있는 shortcode.
- `author_id` (uuid) — 작성자 account_id.
- `username` (string) — 작성자 username.
- `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 fetch instagram post url=https://www.instagram.com/p/DcyMAmUh6FZ/
```

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

```json
{
  "ingested": true,
  "already_tracked": false,
  "fetched_on_demand": true,
  "found": true,
  "post_id": "01a06275-d974-7fda-98ee-dd3ee15b4dcf",
  "account_id": "018cabce-14cc-7544-8890-7811ec33ef74",
  "username": "innisfreeofficial",
  "item": {
    "account_id": "018cabce-14cc-7544-8890-7811ec33ef74",
    "item_type": "content",
    "post_id": "01a06275-d974-7fda-98ee-dd3ee15b4dcf",
    "author_id": "018cabce-14cc-7544-8890-7811ec33ef74",
    "username": "innisfreeofficial",
    "slug": "DcyMAmUh6FZ",
    "posted_at": "2026-09-02T12:00:06Z",
    "media_type": "video",
    "play_count": 22467,
    "like_count": 3224
  },
  "note": "Collected live and stored now. The author is known by name only: run next to crawl their profile and posts.",
  "next": "solari fetch instagram account username=innisfreeofficial"
}
```

## MCP 호출

```json
{
  "name": "solari_fetch_instagram_post",
  "arguments": {
    "url": "https://www.instagram.com/p/DcyMAmUh6FZ/"
  }
}
```

## 주의사항

- 작성자는 이름만 등록된 계정으로 옵니다. 프로필과 게시물을 수집하려면 next에 있는 명령(fetch instagram account)을 실행하세요.
- 처음 수집할 때는 몇 초 걸립니다.

## 관련 도구

- [`solari_fetch_instagram_post_assets`](https://clip-pub.bzine.co/docs/tools/fetch-instagram-post-assets.md?lang=ko)
- [`solari_catalog_instagram_content_detail`](https://clip-pub.bzine.co/docs/tools/catalog-instagram-content-detail.md?lang=ko)
- [`solari_fetch_instagram_account`](https://clip-pub.bzine.co/docs/tools/fetch-instagram-account.md?lang=ko)
- [`solari_fetch_instagram_posts`](https://clip-pub.bzine.co/docs/tools/fetch-instagram-posts.md?lang=ko)