# solari catalog instagram content search

> Instagram 캡션, Bio, 영상 대본을 검색할 때 사용해요.

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

KR, JP, US, TW에서 추적 중인 Instagram 포스트를 키워드로 찾아요. 대략 최근 6개월이에요.

**언제 쓰나** — 어떤 주제의 포스트가 필요할 때 사용해요. 개수가 답이면 content aggregate를 쓰세요.

**무엇이 나오나** — 관련 있는 순으로 포스트가 나와요. 맞는 문구는 하이라이트돼요.

## 파라미터

- `query` (string, 필수) — 찾을 단어
- `region` (enum, 선택, 기본값 "KR") — KR, JP, US, TW 값: `KR`, `JP`, `US`, `TW`.
- `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)

## 응답

### `Response`

- `query / region` (string) — 이번에 쓴 query와 국가예요
- `total` (integer) — 맞는 개수예요. 10,000까지는 정확하고, 그다음엔 멈춰요
- `took_ms` (integer) — 검색에 걸린 시간이에요
- `items` (object[]) — 검색 결과예요. 점수 높은 순이에요

### `items[]`

- `post_id` (uuid) — SOLARI 포스트 id
- `slug` (string) — Instagram 숏코드
- `account_id / author_id / username` (string) — 작성 계정이에요
- `caption` (string) — 캡션
- `user_bio` (string) — 작성자 Bio예요. 검색한 텍스트의 일부예요
- `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) — 영상 포스트인지예요

## 예시

```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까지 세고 그다음엔 멈춰요.

## 관련 도구

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