← 전체 도구
tiktok · contentsolari:read로그인한 SOLARI 계정이면 쓸 수 있어요.

solari tiktok content aggregate

TikTok 포스트를 나열하는 대신 집계해요.

MCP 도구
solari_tiktok_content_aggregate
CLI
solari tiktok content aggregate
권한
solari:read로그인한 SOLARI 계정이면 쓸 수 있어요.로그인한 SOLARI 계정이면 쓸 수 있어요.

개요

추적 중인 TikTok 포스트에 대한 건수와 인게이지먼트 집계로, 개별 포스트가 아니라 숫자로 답하는 질문에 써요: 계정별 월간 포스트 수, 특정 주제를 지배하는 해시태그, 포맷별 평균 재생 수. account, post_type, hashtag, mention, caption_keyword로 그룹핑하고, 각 그룹을 day, week, month 단위로 나눌 수 있어요. post_count는 항상 반환돼요. metrics로 like/comment/view/share/collect의 합계와 평균(view_* 지표는 재생 수를 세어요), 평균 팔로워 수, 고유 계정 수를 요청해요. 자유 텍스트 query(캡션과 영상 전사문), usernames, hashtags, mentions, post_types (video, carousel)로 대상을 좁혀요. mentions로 필터링하고 account로 그룹핑하면 특정 핸들을 태그한 계정이 무엇인지 알 수 있어요. 커버리지: KR, JP, US, TW 리전이며 대략 최근 6개월치를 보유해요. 그보다 오래된 since는 잘리며, 실제 적용된 값이 응답에 그대로 실려요. 버킷은 큰 것부터 정렬돼요. truncated=true는 limit이 반환한 것보다 더 많은 그룹이 있었다는 뜻이에요. 건수가 아니라 포스트 자체가 필요하면 solari_tiktok_content_search를 사용하세요. 로그인된 SOLARI 계정이면 누구나 사용할 수 있어요.

언제 쓰나 — 수치 질문: 계정별 업로드 주기, 주제 내 해시태그 분포, 포맷별 평균 재생 수.

무엇이 돌아오나 — 그룹별 건수와 인게이지먼트 집계, 큰 그룹부터.

파라미터

regionenum선택
집계할 리전. 이 네 개 리전만 인덱싱되어 있어요.기본값 "KR"값KRJPUSTW
group_byenum선택
그룹핑 기준 차원. 생략하면 필터링된 전체를 단일 total 버킷으로 집계해요.값accountpost_typehashtagmentioncaption_keyword
intervalenum선택
나눌 캘린더 간격. 단독으로 쓰면 기간당 버킷 하나를 반환하고, group_by와 함께 쓰면 각 그룹이 시계열을 가져요.값dayweekmonth
metricsstring[]선택
항상 반환되는 post_count 외에 추가로 받을 지표. view_* 지표는 재생 수를 세어요. 지표 값은 스냅샷이라 실시간 수치보다 늦을 수 있어요.값like_sumlike_avgcomment_sumcomment_avgview_sumview_avgshare_sumshare_avgcollect_sumcollect_avgfollower_avgaccount_count
querystring선택
캡션과 영상 전사문에 매칭되는 자유 텍스트 필터.
usernamesstring[]선택
이 TikTok 핸들들로 제한해요.
hashtagsstring[]선택
이 해시태그를 모두 가진 포스트로 제한해요.
mentionsstring[]선택
이 핸들들을 모두 태그한 포스트로 제한해요. group_by=account와 함께 쓰면 특정 핸들을 태그한 계정의 순위를 낼 수 있어요.
post_typesstring[]선택
이 포스트 포맷들로 제한해요.값videocarousel
sincestring선택
이 UTC 날짜 이후의 포스트만, YYYY-MM-DD 형식이며 해당일 포함. 기본값은 183일 전이고, 이 값이 허용되는 가장 이른 경계이기도 해요.pattern ^\d{4}-\d{2}-\d{2}$
untilstring선택
이 UTC 날짜 이전의 포스트만, YYYY-MM-DD 형식이며 해당일 포함.pattern ^\d{4}-\d{2}-\d{2}$
limitinteger선택
group_by가 지정됐을 때 반환되는 최대 그룹 수, 기본값 20. 50을 넘는 값은 50으로 잘려요.≥ 1

응답

Response

regionstring
집계가 수행된 리전.
sincedate
실제로 적용된 시작 날짜. 보관 기간보다 오래된 요청은 잘려서 여기에 그대로 실려요.
untildate | null
실제로 적용된 종료 날짜.
group_bystring | null
적용된 그룹핑 차원.
intervalstring | null
적용된 캘린더 간격.
total_postsinteger
필터에 매칭된 포스트 수. 그룹이 겹치면 버킷 건수의 합과 다를 수 있어요.
truncatedboolean
limit이 반환한 것보다 더 많은 그룹이 있었을 때 true.
bucketsobject[]
그룹당 항목 하나, 큰 것부터.

buckets[]

keystring
그룹 값 — 핸들, 해시태그, 포맷 등. group_by를 생략하면 단일 total 버킷이에요.
metrics.post_countinteger
포스트 수. 항상 반환돼요.
metrics.like_sum / like_avgnumber | null
좋아요 합계와 평균. metrics로 요청했을 때만.
metrics.comment_sum / comment_avgnumber | null
댓글 합계와 평균.
metrics.view_sum / view_avgnumber | null
재생 수 합계와 평균.
metrics.share_sum / collect_sumnumber | null
공유와 저장 합계, 그리고 대응하는 _avg 변형.
metrics.follower_avgnumber | null
작성 계정들의 평균 팔로워 수.
metrics.account_countinteger | null
그룹 내 고유 계정 수.
seriesobject[] | null
기간별 분해. interval이 지정됐을 때 존재해요.

예시

요청

$ solari tiktok content aggregate group_by=account query="이니스프리" metrics='["view_sum","like_avg","account_count"]' limit=5

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

{
  "region": "KR",
  "since": "2026-03-04",
  "until": null,
  "group_by": "account",
  "interval": null,
  "total_posts": 20,
  "truncated": true,
  "buckets": [
    {
      "key": "merryview_",
      "metrics": {
        "post_count": 2,
        "like_sum": null,
        "like_avg": 2378.5,
        "comment_sum": null,
        "comment_avg": null,
        "view_sum": 179504,
        "view_avg": null,
        "share_sum": null,
        "share_avg": null,
        "collect_sum": null,
        "collect_avg": null,
        "follower_avg": null,
        "account_count": 1
      },
      "series": null
    },
    {
      "key": "_kimdayun_",
      "metrics": {
        "post_count": 1,
        "like_sum": null,
        "like_avg": 1829,
        "comment_sum": null,
        "comment_avg": null,
        "view_sum": 102000,
        "view_avg": null,
        "share_sum": null,
        "share_avg": null,
        "collect_sum": null,
        "collect_avg": null,
        "follower_avg": null,
        "account_count": 1
      },
      "series": null
    },
    "… 3 more"
  ]
}

MCP 호출로 쓰면

{
  "name": "solari_tiktok_content_aggregate",
  "arguments": {
    "group_by": "account",
    "query": "이니스프리",
    "metrics": [
      "view_sum",
      "like_avg",
      "account_count"
    ],
    "limit": 5
  }
}

주의사항

  • view_* 지표는 재생 수를 세어요.
  • Instagram 버전과 달리 share_*와 collect_*에 실제로 값이 채워지며, transcription_keyword 그룹핑은 없어요.
  • 인덱스는 KR, JP, US, TW를 대략 최근 6개월치 커버해요. since의 하한은 183일 전이며, 그보다 오래된 값은 잘려서 응답에 그대로 실려요.

관련 도구

기계가 읽는 형식: /docs/tools/tiktok-content-aggregate.md