# solari instagram brand lookalike content

> 브랜드의 성과 최상위 광고처럼 보이고 읽히는 포스트.

- **CLI**: `solari instagram brand lookalike content`
- **MCP 도구**: `solari_instagram_brand_lookalike_content`
- **권한**: `solari:read` — 로그인한 SOLARI 계정이면 쓸 수 있어요.

브랜드의 성과 상위 광고 포스트와 시각적·의미적으로 비슷한 Instagram 포스트. 브랜드 자신의 광고 포스트를 시드로 삼은 벡터 이웃 검색으로 찾아요. 브랜드는 account_id(solari_instagram_account_search가 주는 SOLARI 계정 UUID) 또는 username(Instagram 핸들)으로 지정해요. 알 수 없는 값을 주면 not-found 에러가 나요. 로그인한 모든 SOLARI 계정에서 사용할 수 있어요.

**언제 쓰나** — 레퍼런스를 찾을 때. 브랜드 자신의 상위 광고를 시드로 삼은 벡터 이웃 검색.

**무엇이 돌아오나** — 유사(lookalike) 포스트와, 검색의 시드가 된 브랜드 자신의 광고 포스트.

## 파라미터

- `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)$) — 유사(lookalike) 검색의 시드가 되는 광고 포스트를 가진 브랜드의 account_id(SOLARI 계정 UUID). 이 값 또는 username 중 하나를 주세요.
- `username` (string, 선택, ≤ 64 chars) — 브랜드 Instagram 핸들. 앞의 @는 있어도 없어도 돼요. account_id가 설정되면 무시돼요.
- `limit` (integer, 선택, ≥ 1) — 반환되는 유사(lookalike) 포스트 최대 개수, 기본값 30. 50을 넘는 값은 50으로 잘려요.
- `region` (string, 선택, 기본값 "KR") — 검색 범위를 정하는 리전 코드. KR, JP, US 등.

## 응답

### `Response`

- `items` (object[]) — 유사(lookalike) 포스트.
- `basis` (object[]) — 시드로 쓰인 브랜드 자신의 광고 포스트.
- `region` (string) — 검색 범위로 적용된 리전.

### `items[] · basis[]`

- `post_id` (uuid) — SOLARI 포스트 id. 다른 콘텐츠 툴에 그대로 넣으면 돼요.
- `slug` (string) — Instagram shortcode — 공개 URL에서 /p/ 또는 /reel/ 뒤에 오는 구간.
- `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) — 영상 재생 수. image 포스트에서는 null.
- `like_count` (integer | null) — 스냅샷 시점의 좋아요 수.
- `text` (string | null) — 캡션 텍스트.
- `media_url` (string) — 원본 미디어 URL.
- `thumbnail_url` (string) — 썸네일 URL.
- `score` (number | 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) — 항목 종류 태그. 콘텐츠 피드에서는 post.
- `content_source` (string | null) — 이 항목을 노출시킨 파이프라인.
- `is_saved` (boolean | null) — 이 항목이 SOLARI 앱에 저장되어 있는지 여부.
- `updated_at` (timestamp | null) — 지표 스냅샷이 마지막으로 갱신된 시각.

## 예시

```console
$ solari instagram brand lookalike content username=innisfreeofficial limit=3
```

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

```json
{
  "items": [
    {
      "item_type": "content",
      "post_id": "019ecb92-a677-7421-8ed6-752efe3d99d0",
      "author_id": "0196cb39-870a-7a76-9773-0b95789c877d",
      "username": "boo_rookie",
      "full_name": null,
      "profile_pic_url": null,
      "follower_count": null,
      "region": null,
      "posted_at": "2026-06-11T08:14:37Z",
      "media_type": "video",
      "play_count": 427258,
      "like_count": null,
      "score": null,
      "efficiency_score": null,
      "est_percentile": null,
      "updated_at": null,
      "media_url": "https://smr-images-b.bzine.co/users/0196cb39-870a-7a76-9773-0b95789c877d/posts/019ecb92-a677-7421-8ed6-752efe3d99d0/medias/019ecb92-a92e-7fc8-b644-69b930f2e197.mp4",
      "thumbnail_url": "https://bzine.co/cdn-cgi/media/width=480,mode=frame,time=100ms/https://smr-images-a.bzine.co/users/0196cb39-870a-7a76-9773-0b95789c877d/posts/019ecb92-a677-7421-8ed6-752efe3d99d0/medias/019ecb92-a92e-7fc8-b644-69b930f2e1 …",
      "slug": "DZcD8KXxKwd",
      "text": null,
      "brand_match_score": null,
      "recent_collab_brands": [],
      "total_views_3m": null,
      "median_views_3m": null,
      "is_saved": null,
      "content_source": "lookalikes_by_top_ad"
    },
    "… 2 more"
  ],
  "basis": [
    {
      "item_type": "content",
      "post_id": "01a04c73-3ec3-7873-9e84-334c644abfe4",
      "author_id": "0196c474-c96e-71ad-aceb-61af051c81d3",
      "username": "hwitto_",
      "full_name": null,
      "profile_pic_url": null,
      "follower_count": null,
      "region": null,
      "posted_at": null,
      "media_type": "video",
      "play_count": 155729,
      "like_count": null,
      "score": null,
      "efficiency_score": null,
      "est_percentile": null,
      "updated_at": null,
      "media_url": "https://smr-images-a.bzine.co/users/0196c474-c96e-71ad-aceb-61af051c81d3/posts/01a04c73-3ec3-7873-9e84-334c644abfe4/medias/01a04c73-4036-7a83-a52a-97b0058e6732.mp4",
      "thumbnail_url": "https://bzine.co/cdn-cgi/media/width=480,mode=frame,time=100ms/https://smr-images.bzine.co/users/0196c474-c96e-71ad-aceb-61af051c81d3/posts/01a04c73-3ec3-7873-9e84-334c644abfe4/medias/01a04c73-4036-7a83-a52a-97b0058e6732 …",
      "slug": "DckGrZ6vZiU",
      "text": null,
      "brand_match_score": null,
      "recent_collab_brands": [],
      "total_views_3m": null,
      "median_views_3m": null,
      "is_saved": null,
      "content_source": "lookalikes_by_top_ad"
    },
    "… 5 more"
  ],
  "region": "KR"
}
```

## MCP 호출로 쓰면

```json
{
  "name": "solari_instagram_brand_lookalike_content",
  "arguments": {
    "username": "innisfreeofficial",
    "limit": 3
  }
}
```

## 주의사항

- limit은 50에서 상한이 걸려요.
- basis가 비어 있으면 아직 시드로 쓸 광고 포스트가 그 브랜드에 없다는 뜻이에요.

## 관련 도구

- [`solari_instagram_brand_ad_posts`](https://solari.sh/docs/tools/instagram-brand-ad-posts.md?lang=ko)
- [`solari_instagram_content_search`](https://solari.sh/docs/tools/instagram-content-search.md?lang=ko)