# solari catalog instagram content search

> Instagram 캡션, 소개글, 영상 자막을 검색할 때 쓰세요.

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

KR, JP, US, TW에서 수집한 Instagram 게시물을 키워드로 검색합니다. 대략 최근 6개월치가 대상입니다.

**언제 쓰나요** — 주제에 관한 게시물이 필요할 때. 개수가 필요하면 content aggregate 도구를 쓰세요.

**돌려주는 값** — 관련도 순으로 정렬한 게시물. 일치한 글자는 강조 표시됩니다.

## 파라미터

- `query` (string, 필수) — 검색할 단어.
- `region` (enum, 선택, 기본값 "KR") — KR, JP, US, TW 중 하나. 값: `KR`, `JP`, `US`, `TW`.
- `limit` (integer, 선택, 기본값 20, 1–100) — 한 페이지에 가져올 게시물 수.
- `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)까지 올라온 게시물만 가져옵니다.

## 응답

### `Response`

- `query / region` (string) — 적용한 검색어와 지역.
- `total` (integer) — 전체 일치 수. 10,000까지는 정확하고, 그 뒤로는 10,000에서 멈춥니다.
- `took_ms` (integer) — 검색에 걸린 시간.
- `items` (object[]) — 검색 결과. 점수가 높은 순서입니다.

### `items[]`

- `post_id` (uuid) — SOLARI 게시물 id.
- `slug` (string) — Instagram shortcode.
- `account_id / author_id / username` (string) — 게시물을 올린 계정.
- `caption` (string) — 캡션.
- `user_bio` (string) — 작성자 소개글. 검색 대상 텍스트에 들어갑니다.
- `transcription_text` (string | null) — 영상 음성 자막.
- `posted_at` (timestamp) — 게시 시각(UTC).
- `like_count / comment_count` (integer) — 참여 지표.
- `follower_count` (integer) — 작성자 팔로워 수.
- `score` (number) — 관련도 점수. 같은 응답 안에서만 비교할 수 있습니다.
- `highlight` (object) — 필드별 일치 부분. caption, user_bio, transcription_text.
- `is_video` (boolean) — 영상 게시물인지 여부.
- `assets` (object[]) — 미디어 파일 목록(순서대로). 파일마다 asset_url, media_type, video_duration이 있습니다.
- `assets[].asset_url` (string | null) — 원본 크기 이미지나 영상을 바로 내려받는 링크. 저장된 파일이 없으면 null입니다.

## 예시

```console
$ solari catalog instagram content search query="이니스프리 그린티" limit=3
```

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

```json
{
  "query": "이니스프리 그린티",
  "region": "KR",
  "total": 10000,
  "took_ms": 1586,
  "items": [
    {
      "post_id": "019f12d8-3e72-78e9-b7e5-39293bc56f23",
      "author_id": "019f12d8-3e0f-7c74-afc6-e14405bd1523",
      "username": "hanydiary",
      "caption": "[이니스프리에디터 4기 1-2 : 그린티 PDRN 아이&립 세럼] #이니스프리 #그린티PDRN 💚 자세한 포스팅은 프로필 링크 참고해주세요 :)",
      "user_bio": "대외활동 | 휴학생 | 취준일기 🪽과 학생회 2년 연임 🪽이니스프리 대학생 에디터 3기 / 4기",
      "transcription_text": null,
      "posted_at": "2026-02-16T05:44:45Z",
      "like_count": 3,
      "comment_count": 3,
      "follower_count": 972,
      "score": 140.43787,
      "slug": "DUzrl1UkoJb",
      "highlight": {
        "caption": [
          "[<mark>이니스프리</mark>에디터 4기 1-2 : <mark>그린티</mark> PDRN 아이&립 세럼] #이니스프리 #그린티PDRN 💚 자세한 포스팅은 프로필 링크 참고해주세요 :)"
        ],
        "user_bio": [
          "대외활동 | 휴학생 | 취준일기 🪽과 학생회 2년 연임 🪽<mark>이니스프리</mark> 대학생 에디터 3기 / 4기"
        ],
        "transcription_text": []
      },
      "is_video": false,
      "media_url": null,
      "thumbnail_url": null,
      "account_id": "019f12d8-3e0f-7c74-afc6-e14405bd1523"
    },
    "… 2 more"
  ]
}
```

## MCP 호출

```json
{
  "name": "solari_catalog_instagram_content_search",
  "arguments": {
    "query": "이니스프리 그린티",
    "limit": 3
  }
}
```

## 주의사항

- since를 약 6개월보다 이전으로 넣으면 결과가 없습니다.
- total은 10,000까지만 셉니다.
- likes_hidden이 true면 like_count를 쓰지 마세요. 작성자가 좋아요를 숨겨서 null이거나 실제 값이 아닐 수 있습니다.

## 관련 도구

- [`solari_insight_instagram_content_aggregate`](https://clip-pub.bzine.co/docs/tools/insight-instagram-content-aggregate.md?lang=ko)
- [`solari_catalog_instagram_content_batch`](https://clip-pub.bzine.co/docs/tools/catalog-instagram-content-batch.md?lang=ko)
- [`solari_catalog_tiktok_content_search`](https://clip-pub.bzine.co/docs/tools/catalog-tiktok-content-search.md?lang=ko)