instagram · brandsolari:read

solari instagram brand lookalike content

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

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

개요

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

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

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

파라미터

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

응답

Response

itemsobject[]: 유사(lookalike) 포스트.
basisobject[]: 시드로 쓰인 브랜드 자신의 광고 포스트.
regionstring: 검색 범위로 적용된 리전.

items[] · basis[]

post_iduuid: SOLARI 포스트 id. 다른 콘텐츠 툴에 그대로 넣으면 돼요.
slugstring: Instagram shortcode — 공개 URL에서 /p/ 또는 /reel/ 뒤에 오는 구간.
author_iduuid: 작성 계정의 account_id.
usernamestring: 작성자 핸들.
full_namestring | null: 프로필 표시 이름.
profile_pic_urlstring | null: 프로필 사진 URL.
follower_countinteger | null: 스냅샷 시점의 작성자 팔로워 수.
regionstring | null: 작성자에게 지정된 리전 코드.
posted_attimestamp: 게시 시각(UTC).
media_typestring: image, video, 또는 carousel.
play_countinteger | null: 영상 재생 수. image 포스트에서는 null.
like_countinteger | null: 스냅샷 시점의 좋아요 수.
textstring | null: 캡션 텍스트.
media_urlstring: 원본 미디어 URL.
thumbnail_urlstring: 썸네일 URL.
scorenumber | null: 피드 랭킹 점수. 한 응답 안에서만 비교할 수 있어요.
efficiency_scorenumber | null: 작성자 팔로워 수 대비 성과.
est_percentilenumber | null: 리전 내 추정 백분위, 0–1.
total_views_3minteger | null: 최근 3개월 동안 작성자의 누적 조회 수.
median_views_3minteger | null: 최근 3개월 동안 작성자의 조회 수 중앙값.
recent_collab_brandsstring[]: 작성자가 최근 협업한 브랜드.
item_typestring: 항목 종류 태그. 콘텐츠 피드에서는 post.
content_sourcestring | null: 이 항목을 노출시킨 파이프라인.
is_savedboolean | null: 이 항목이 SOLARI 앱에 저장되어 있는지 여부.
updated_attimestamp | null: 지표 스냅샷이 마지막으로 갱신된 시각.

예시

요청

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

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

{
  "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 호출로 쓰면

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

주의사항

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

기계가 읽는 형식: /docs/tools/instagram-brand-lookalike-content.md

개요

파라미터

응답

예시

주의사항

관련 도구