for agents
← 전체 도구
instagram · insight · contentsolari:read

solari insight instagram content aggregate

Instagram 게시물 수를 셀 때 씁니다.

MCP 도구
solari_insight_instagram_content_aggregate
CLI
solari insight instagram content aggregate
권한
solari:read
이용 가능 플랜
  • 무료 체험
  • Plus
  • Pro
  • Enterprise
크레딧
1

개요

수집한 게시물을 계정, 형식, 해시태그, 멘션, 키워드별로 합산합니다. 숫자로 답해야 하는 질문에 씁니다.

언제 쓰나요 — 게시량, 평균, 가장 많이 쓰인 해시태그를 알고 싶을 때. 게시물 자체가 필요하면 콘텐츠 검색을 쓰세요.

돌려주는 값 — 그룹별 개수를 큰 순서로 돌려줍니다. 다른 지표는 요청할 때만 들어갑니다.

파라미터

regionenum선택
KR, JP, US, TW 중 하나.기본값 "KR"값KRJPUSTW
group_byenum선택
개수를 나눌 기준.값accountpost_typehashtagmentioncaption_keywordtranscription_keyword
intervalenum선택
이 달력 단위로 시계열을 추가합니다.값dayweekmonth
metricsstring[]선택
post_count 외에 받을 지표.값like_sumlike_avgcomment_sumcomment_avgview_sumview_avgfollower_avgaccount_count
querystring선택
캡션과 영상 자막에서 찾을 키워드.
usernamesstring[]선택
이 Instagram username만.
hashtagsstring[]선택
이 해시태그를 모두 단 게시물만.
mentionsstring[]선택
이 username을 모두 멘션한 게시물만.
post_typesstring[]선택
이 형식만.
sincestring선택
이 UTC 날짜(YYYY-MM-DD) 당일이나 이후 게시물만.pattern ^\d{4}-\d{2}-\d{2}$
untilstring선택
이 UTC 날짜(YYYY-MM-DD) 당일이나 이전 게시물만.pattern ^\d{4}-\d{2}-\d{2}$
limitinteger선택
받을 그룹 수.기본값 201–50

응답

Response

regionstring
합산한 지역.
sincedate
실제로 쓴 시작일.
untildate | null
실제로 쓴 종료일.
group_bystring | null
적용된 그룹 기준.
intervalstring | null
적용된 시간 단위.
total_postsinteger
필터에 맞는 게시물 수.
truncatedboolean
그룹이 limit보다 많았으면 true.
bucketsobject[]
큰 순서로 정렬한 그룹.

buckets[]

keystring
그룹 값. group_by를 빼면 전체 합계 하나만 옵니다.
metrics.post_countinteger
게시물 수. 항상 들어 있습니다.
metrics.like_sum / like_avgnumber | null
좋아요 합계와 평균. 요청했을 때만.
metrics.comment_sum / comment_avgnumber | null
댓글 합계와 평균. 요청했을 때만.
metrics.view_sum / view_avgnumber | null
조회수 합계와 평균. 요청했을 때만.
metrics.share_sum / collect_sumnumber | null
TikTok 전용. 여기서는 항상 null.
metrics.follower_avgnumber | null
작성자 평균 팔로워 수.
metrics.account_countinteger | null
그룹 안의 서로 다른 계정 수.
seriesobject[] | null
기간별 세부 값. interval을 넣었을 때만.

예시

요청

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

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

{
  "region": "KR",
  "since": "2026-03-04",
  "until": null,
  "group_by": "hashtag",
  "interval": null,
  "total_posts": 1647,
  "truncated": true,
  "buckets": [
    {
      "key": "이니스프리",
      "metrics": {
        "post_count": 772,
        "like_sum": null,
        "like_avg": 320.7240932642487,
        "comment_sum": null,
        "comment_avg": null,
        "view_sum": 9400953,
        "view_avg": null,
        "share_sum": null,
        "share_avg": null,
        "collect_sum": null,
        "collect_avg": null,
        "follower_avg": null,
        "account_count": 587
      },
      "series": null
    },
    {
      "key": "광고",
      "metrics": {
        "post_count": 548,
        "like_sum": null,
        "like_avg": 373.04021937842776,
        "comment_sum": null,
        "comment_avg": null,
        "view_sum": 5463711,
        "view_avg": null,
        "share_sum": null,
        "share_avg": null,
        "collect_sum": null,
        "collect_avg": null,
        "follower_avg": null,
        "account_count": 381
      },
      "series": null
    },
    "… 3 more"
  ]
}

MCP 호출

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

주의사항

  • 다른 지표를 지정하지 않으면 post_count만 채워집니다.
  • KR·JP·US·TW 지역의 최근 약 6개월을 다룹니다. since가 그보다 이르면 가장 오래된 날짜로 맞춥니다.
  • interval만 넣으면 기간마다 구간이 하나씩 생깁니다. group_by와 함께 쓰면 그룹마다 시계열이 생깁니다.

관련 도구

에이전트용 문서: /docs/tools/insight-instagram-content-aggregate.md