Pluggzy문서

분석

get_insights 도구 하나로 각 플랫폼이 주는 계정 수치를 읽어요. 조회수, 도달, 참여, 팔로워, 인기 게시물, 게시하기 좋은 시간까지요. 평소 말투로 물어보세요. 알맞은 리포트와 계정은 AI 앱이 골라요.

7수치를 제공하는 플랫폼
8도구 하나에 담긴 리포트
365최대 조회 일수 · 계정 수치는 89일
읽기 전용게시하거나 바꾸는 일 없음

리포트

AI 앱이 report를 골라요. 기본값은 overview예요. 모든 플랫폼에 모든 리포트가 있는 건 아니에요. 아래 표에서 확인하세요.

개요overview 기본최근 days일 동안의 조회수, 도달, 참여, 팔로워를 보여 줘요. 플랫폼 고유 지표와 모든 플랫폼에 공통인 헤드라인 수치가 함께 나와요. account를 지정하지 않으면 모든 분석 계정을 나란히 보여 줘요.
팔로워followers 팔로워 수의 일별 추이(YouTube는 구독자)와 늘어난 팔로워, 줄어든 팔로워를 보여 줘요.
오디언스audience 국가별·도시별 팔로워, 그리고 플랫폼이 제공하는 경우 연령별·성별 팔로워를 보여 줘요.
인기 게시물top_posts 기간 중 가장 반응이 좋았던 게시물을 참여 기준 또는 sort(조회수, 도달, 좋아요, 댓글, 공유, 날짜) 기준으로 정렬해요. account를 지정하지 않으면 모든 분석 계정을 대상으로 해요.
게시하기 좋은 시간timing 내 게시물 성과가 가장 좋은 요일과 시간대(UTC), 게시 빈도 대비 참여도, 게시물이 최고치에 도달하는 속도를 보여 줘요. Instagram은 팔로워가 접속해 있는 시간도 보여 줘요.
메시지 활동inbox 받은 메시지와 보낸 메시지 수, 첫 답장까지 걸린 시간의 중앙값, 가장 바쁜 시간대를 보여 줘요.
검색 키워드search_keywords 내 비즈니스 프로필이 노출된 Google 검색어를 월별로 보여 줘요.
게시물 1개post list_posts, 인기 게시물 또는 create_post에서 받은 post_id로 게시물 1개의 수치를 보여 줘요. details: true를 넣으면 일별 추이와 플랫폼별 추가 지표도 함께 나와요.

플랫폼별

플랫폼마다 제공하는 리포트예요. 실서버 기준이에요.

채널개요팔로워오디언스인기 게시물게시하기 좋은 시간메시지 활동검색 키워드게시물 1개
Threads리포트 4개————
TikTok리포트 6개——
YouTube리포트 6개——
Pinterest리포트 5개———
Google Business Profile리포트 5개———
Instagram Business리포트 7개—
LinkedIn Pages리포트 5개———
8개 열 · 표를 밀어서 보세요
  • Threads: 수치는 계정이 아니라 게시물에서 집계해요.
  • 최대 365일 전까지 조회할 수 있고, 계정 수치는 89일까지예요.
  • LinkedIn, WhatsApp, Telegram, Instagram, Facebook, WordPress의 수치는 여기서 제공하지 않아요.

AI에게 이렇게 물어보세요

리포트 이름을 말할 필요는 없어요. 동료에게 묻듯 물어보면 AI 앱이 알아서 호출로 바꿔요.

“이번 달 내 SNS 성과 어땠어?”get_insights({ report: "overview", days: 30 })
최근 30일 동안의 모든 분석 계정을 나란히 보여 줘요.
“TikTok에서 제일 잘된 영상 뭐야?”get_insights({ report: "top_posts", provider: "tiktok" })
내 TikTok 게시물을 참여 기준으로 정렬해요. 조회수나 공유를 물어보면 그 기준으로 정렬해요.
“Instagram에 언제 올리는 게 좋아?”get_insights({ report: "timing", provider: "instagrambusiness" })
내 게시물 기준으로 가장 좋은 요일과 시간대, 그리고 팔로워가 접속해 있는 시간을 알려 줘요.
읽기 전용get_insights는 각 플랫폼이 제공하는 수치를 읽기만 하고, 게시하거나 좋아요를 누르거나 무언가를 바꾸지 않아요. View profiles 권한이 필요해요.

예시

모든 계정의 개요를 요청하면 이렇게 돌아와요. 플랫폼 고유 수치와, 어디서나 같은 형태의 헤드라인이에요.

metrics플랫폼이 붙인 이름 그대로의 수치(reach, saves, page_media_view…). 이름을 바꾸면서 사라지는 정보가 없어요.
headline모든 플랫폼에서 같은 형태인 조회수, 도달, 참여, 팔로워. 플랫폼이 제공하지 않는 값은 null이에요.
source플랫폼이 계정 수치를 제공하면 account, 계정의 게시물에서 합산하면 posts예요(Threads).
텍스트 응답 시작“Instagram Business (Northwind Studio): views 48,210, reach 12,480, engagement 2,876; Facebook Pages (Northwind Studio): views 21,340, reach 8,120, engagement 1,120, followers 3,420, followers gained 58, followers lost 9; Pinterest (Northwind Studio): views 30,900, engagement 1,460, followers 1,288, followers gained 41, followers lost 6.”
overview, 모든 계정
{
  "report": "overview",
  "from": "2026-10-11",
  "to": "2026-11-09",
  "accounts": [
    {
      "account_id": "e2c4a6b8-1d3f-4a5c-9e7b-2f4d6a8c0e13",
      "provider": "instagrambusiness",
      "name": "Northwind Studio",
      "source": "account",
      "metrics": {
        "reach": 12480,
        "views": 48210,
        "accounts_engaged": 1034,
        "total_interactions": 2876,
        "likes": 2310,
        "comments": 184,
        "saves": 212,
        "shares": 97,
        "profile_views": 1920,
        "website_clicks": 61
      },
      "headline": {
        "views": 48210,
        "reach": 12480,
        "engagement": 2876,
        "followers": null,
        "followers_gained": null,
        "followers_lost": null
      }
    },
    {
      "account_id": "f1a3c5e7-9b2d-4f6a-8c0e-5d7b9f1a3c48",
      "provider": "facebookpages",
      "name": "Northwind Studio",
      "source": "account",
      "metrics": {
        "page_media_view": 21340,
        "page_total_media_view_unique": 8120,
        "page_views_total": 640,
        "page_post_engagements": 1120,
        "page_video_views": 3010,
        "page_follows": 3420,
        "followers_gained": 58,
        "followers_lost": 9
      },
      "headline": {
        "views": 21340,
        "reach": 8120,
        "engagement": 1120,
        "followers": 3420,
        "followers_gained": 58,
        "followers_lost": 9
      }
    },
    {
      "account_id": "a4c6e8f0-2b4d-4f6a-9c1e-3d5f7b9a1c72",
      "provider": "pinterest",
      "name": "Northwind Studio",
      "source": "account",
      "metrics": {
        "impressions": 30900,
        "engagements": 1460,
        "saves": 380,
        "pin_clicks": 610,
        "outbound_clicks": 205,
        "follower_count": 1288,
        "followers_gained": 41,
        "followers_lost": 6
      },
      "headline": {
        "views": 30900,
        "reach": null,
        "engagement": 1460,
        "followers": 1288,
        "followers_gained": 41,
        "followers_lost": 6
      }
    }
  ]
}

도구

AI 앱이 tools/list에서 받는 내용 그대로예요.

도구 1개 · 읽기 1개 · 쓰기 0개
분석1

How an account is doing, as its network reports it (Instagram Business, LinkedIn Pages, TikTok, YouTube, Pinterest, Google Business Profile, Threads). report: overview (default): the account's figures over the last `days` (views, reach, engagement, followers… as the network reports them, plus a comparable headline); without account, every analytics account side by side; followers: the follower (YouTube: subscriber) count day by day, with gained and lost; audience: followers by country, city, age and gender, as far as the network reports them; top_posts: the best posts of the last `days` by `sort` (engagement by default), with their figures; without account, across every analytics account; timing: when to post, from the account's own posts (best weekday × hour slots in UTC, posts per week vs engagement, how fast posts reach their final engagement; Instagram: when followers are online); inbox: messages received and sent, median time to first reply and the busiest hours; search_keywords: the Google searches that showed the Business Profile, by month; post: one post's figures (post_id from list_posts, top_posts or create_post); details=true adds its day-by-day curve and the network's extras (Facebook earnings, YouTube retention and daily views). Not every network has every report (followers: Instagram Business, LinkedIn Pages, TikTok, YouTube, Pinterest; audience: Instagram Business, TikTok, YouTube; inbox: Instagram Business; search_keywords: Google Business Profile). The personal LinkedIn, WhatsApp, Telegram and the personal Instagram and Facebook logins have no insights here. Read-only.

권한 View profiles한도 읽기 · 하루 3,000
입력파라미터 9개 · 필수 0개
accountstring
account_id from list_accounts. Leave it out for overview or top_posts to cover every analytics account; the other reports need it when several are connected.
providerenum
only this network's accounts (instead of account)
instagrambusinesslinkedinpagestiktokyoutubepinterestgooglebusinessthreads
reportenum
기본값 "overview"overviewfollowersaudiencetop_poststiminginboxsearch_keywordspost
daysinteger
how many days back, ending today (account figures: at most 89)
기본값 301–365
post_idstring
report post: the post's post_id (or the scheduled_post_id create_post gave)
detailsboolean
report post: also the day-by-day curve and the network's extras (more reads)
기본값 false
sortenum
report top_posts: what ranks the posts
기본값 "engagement"engagementviewsreachlikescommentssharesdate
limitinteger
report top_posts: how many posts
기본값 101–25
cursorstring
report search_keywords: next_cursor from the previous page
출력structuredContent
{
  "structuredContent": {
    "report": "overview",
    "from": "2026-10-11",
    "to": "2026-11-09",
    "accounts": [
      {
        "account_id": "e2c4a6b8-1d3f-4a5c-9e7b-2f4d6a8c0e13",
        "provider": "instagrambusiness",
        "name": "Northwind Studio",
        "source": "account",
        "metrics": {
          "reach": 12480,
          "views": 48210,
          "accounts_engaged": 1034,
          "total_interactions": 2876,
          "likes": 2310,
          "comments": 184,
          "saves": 212,
          "shares": 97,
          "profile_views": 1920,
          "website_clicks": 61
        },
        "headline": {
          "views": 48210,
          "reach": 12480,
          "engagement": 2876,
          "followers": null,
          "followers_gained": null,
          "followers_lost": null
        }
      },
      {
        "account_id": "f1a3c5e7-9b2d-4f6a-8c0e-5d7b9f1a3c48",
        "provider": "facebookpages",
        "name": "Northwind Studio",
        "source": "account",
        "metrics": {
          "page_media_view": 21340,
          "page_total_media_view_unique": 8120,
          "page_views_total": 640,
          "page_post_engagements": 1120,
          "page_video_views": 3010,
          "page_follows": 3420,
          "followers_gained": 58,
          "followers_lost": 9
        },
        "headline": {
          "views": 21340,
          "reach": 8120,
          "engagement": 1120,
          "followers": 3420,
          "followers_gained": 58,
          "followers_lost": 9
        }
      },
      {
        "account_id": "a4c6e8f0-2b4d-4f6a-9c1e-3d5f7b9a1c72",
        "provider": "pinterest",
        "name": "Northwind Studio",
        "source": "account",
        "metrics": {
          "impressions": 30900,
          "engagements": 1460,
          "saves": 380,
          "pin_clicks": 610,
          "outbound_clicks": 205,
          "follower_count": 1288,
          "followers_gained": 41,
          "followers_lost": 6
        },
        "headline": {
          "views": 30900,
          "reach": null,
          "engagement": 1460,
          "followers": 1288,
          "followers_gained": 41,
          "followers_lost": 6
        }
      }
    ]
  },
  "content": [
    {
      "type": "text",
      "text": "Instagram Business (Northwind Studio): views 48,210, reach 12,480, engagement 2,876; Facebook Pages (Northwind Studio): views 21,340, reach 8,120, engagement 1,120, followers 3,420, followers gained 58, followers lost 9; Pinterest (Northwind Studio): views 30,900, engagement 1,460, followers 1,288, followers gained 41, followers lost 6."
    }
  ]
}
게이트가 한 일예시09:41:02 → 09:41:03
  1. 수신09:41:02
  2. 한도 이내오늘 3,000회 중 840회
  3. 전송09:41:03
오늘 읽기: 3,000회 중 840회 사용 · UTC 00:00 초기화
텍스트 응답 시작 “Instagram Business (Northwind Studio): views 48,210, reach 12,480, engagement 2,876; Facebook Pages (Northwind Studio): views 21,340, reach 8,120, engagement 1,120, followers 3,420, followers gained 58, followers lost 9; Pinterest (Northwind Studio): views 30,900, engagement 1,460, followers 1,288, followers gained 41, followers lost 6.” · 거절 코드gaplimitcooldownpermission
pluggzy.com/api/docs에서 생성 · 도구 42개헷갈리는 부분이 있나요? 고객 지원에 문의하기 · 서비스 상태