instagram · accountsolari:read

solari instagram account collabs

크리에이터가 어느 브랜드의 광고를 진행했는지, 브랜드별로 묶어서.

MCP 도구: solari_instagram_account_collabs
CLI: solari instagram account collabs
권한: solari:read로그인한 SOLARI 계정이면 쓸 수 있어요.로그인한 SOLARI 계정이면 쓸 수 있어요.

개요

크리에이터 한 명이 지정한 개월 수 안에 진행한 최근 광고 협업. 각 항목은 대상 브랜드(target_account_id, target_username)와 collab_count, last_posted_at, 그리고 샘플 협업 포스트로 이루어져요. items, has_more, total을 반환하며 limit/offset으로 페이지를 넘겨요. 크리에이터는 account_id(SOLARI 계정 UUID) 또는 username(Instagram 핸들)으로 지정해요. 알 수 없는 값을 주면 not-found 에러가 나요. 브랜드에서 출발하는 반대 방향 뷰는 solari_instagram_brand_top_collaborators예요. 로그인한 모든 SOLARI 계정에서 사용할 수 있어요.

언제 쓰나 — "이 크리에이터는 누구와 일하는가?" 브랜드에서 출발하는 반대 방향 뷰는 brand top collaborators예요.

무엇이 돌아오나 — 대상 브랜드마다 한 행. 각 행은 샘플 협업 포스트를 담아요.

파라미터

account_idstring선택: 크리에이터의 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
monthsinteger선택: 조회 기간(개월), 기본값 3. 12를 넘는 값은 12로 잘려요.≥ 1
limitinteger선택: 페이지당 최대 항목 수, 기본값 5. 200을 넘는 값은 200으로 잘려요.≥ 1
offsetinteger선택: 페이지네이션 offset, 기본값 0.기본값 0≥ 0

응답

Response

totalinteger: 필터에 맞는 전체 행 수.
has_moreboolean: offset + limit 뒤에도 행이 있는지 여부.
itemsobject[]: 협업 요약. 대상 브랜드마다 하나.

items[]

target_account_iduuid: 대상 브랜드의 account_id.
target_usernamestring: 대상 브랜드 핸들.
collab_countinteger: 이 브랜드와의 협업 포스트 수.
last_posted_attimestamp: 가장 최근 협업.
post_id / slugstring: 샘플 포스트의 식별자.
textstring: 샘플 포스트 캡션.
like_count / play_countinteger: 샘플 포스트 인게이지먼트.
media_typestring: 샘플 포스트 포맷.
thumbnail_url / media_urlstring: 샘플 포스트 미디어.
biostring: 대상 브랜드 bio.

예시

요청

$ solari instagram account collabs username=beinny_motd months=6 limit=3

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

{
  "items": [
    {
      "post_id": "01a05575-7c9b-7232-8519-4a38fa061389",
      "target_user_id": "018cab85-8ef8-7dc9-ab0a-7044d463f65e",
      "target_username": "dasique_official",
      "collab_count": 2,
      "last_posted_at": "2026-08-30T05:08:56+00:00",
      "slug": "DcpugJ2kzv8",
      "text": "#광고 무겁지 않은 가을 데일리 팔레트 로즈밀크티 . .🫖🤎\n차분하고 미지근한 로즈핑크 팔레트인데\n부드러운 밀크티 무드라서 분위기가 넘 예뻐요..🥺\n\n데이지크에서 올리브영 X 산리오 콜라보\n시티팝 에디션으로 미니섀도우팔레트 4종이 출시되는데\n그 중 자주 추천드렸던 로즈밀크티, 밀크라떼가 있더라구요 !\n\nNEW 컬러 피치레코드, 모브카세트도 출시되어요🤍\n도시의 아침과 저녁 무드를 담은 데일리한 …",
      "play_count": 0,
      "media_type": "8",
      "like_count": 878,
      "video_media_count": 0,
      "media_count": 15,
      "bio": "🫒올영세일 08.30 – 09.05\nUP TO 37% SALE\n올리브영X산리오,\n🌠데이지크 🆕 미니 섀도우",
      "thumbnail_url": "https://bzine.co/cdn-cgi/image/fit=scale-down,width=480/https://smr-images-c.bzine.co/users/018ecc75-55d8-70a7-a348-d370aa504ed9/posts/01a05575-7c9b-7232-8519-4a38fa061389/medias/01a05575-7dd3-779e-9050-a6cb59578cb9.jpg",
      "media_url": "https://bzine.co/cdn-cgi/image/fit=scale-down,width=480/https://smr-images-c.bzine.co/users/018ecc75-55d8-70a7-a348-d370aa504ed9/posts/01a05575-7c9b-7232-8519-4a38fa061389/medias/01a05575-7dd3-779e-9050-a6cb59578cb9.jpg",
      "target_account_id": "018cab85-8ef8-7dc9-ab0a-7044d463f65e"
    },
    "… 2 more"
  ],
  "has_more": true,
  "total": 7
}

MCP 호출로 쓰면

{
  "name": "solari_instagram_account_collabs",
  "arguments": {
    "username": "beinny_motd",
    "months": 6,
    "limit": 3
  }
}

주의사항

target_user_id는 target_account_id와 같은 값의 예전 이름이에요. 새 코드는 target_account_id를 읽어야 해요.
months의 기본값은 3이고 12에서 상한이 걸려요.
브랜드별 집계가 아니라 행 단위 이력이 필요하면 account ad posts를 쓰세요.

기계가 읽는 형식: /docs/tools/instagram-account-collabs.md

개요

파라미터

응답

예시

주의사항

관련 도구