posterly-mcp-server 0.8.1 → 0.8.2

package/README.md

@@ -93,7 +93,7 @@ Add the same server definition to your Cursor MCP settings:
 
 ## Available tools
 
-`posterly-mcp-server@0.8.1` exposes 16 tools:
+`posterly-mcp-server@0.8.2` exposes 16 tools:
 
 - `whoami`
 - `list_accounts`
@@ -112,7 +112,7 @@ Add the same server definition to your Cursor MCP settings:
 - `get_account_analytics`
 - `get_post_analytics`
 
-Analytics tools currently support Instagram, LinkedIn, Google Business Profile, and Pinterest.
+Analytics tools currently support Instagram, LinkedIn, Google Business Profile, Pinterest, and YouTube.
 
 ## What the brand tools are for
 

package/dist/lib/api-client.d.ts

@@ -119,6 +119,8 @@ export interface AccountAnalyticsSummary {
     total_direction_requests: number | null;
     total_conversations: number | null;
     total_bookings: number | null;
+    total_watch_minutes?: number | null;
+    total_likes?: number | null;
 }
 export interface AccountAnalyticsSnapshot {
     date: string;
@@ -163,8 +165,11 @@ export interface PostAnalyticsRow {
     shares: number;
     plays: number;
     total_interactions: number;
+    avg_watch_time_ms?: number | null;
+    total_watch_time_ms?: number | null;
     url_link_clicks?: number;
     user_profile_clicks?: number;
+    engagements?: number;
     media_type: string | null;
     media_url: string | null;
     permalink: string | null;

package/dist/tools/get-account-analytics.js

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 export const getAccountAnalyticsTool = {
     name: 'get_account_analytics',
-    description: 'Get daily analytics snapshots and a period summary for a connected social account. Supports Instagram, LinkedIn, Google Business Profile, and Pinterest. Returns follower growth, reach, views, engagement rate, and platform-specific metrics.',
+    description: 'Get daily analytics snapshots and a period summary for a connected social account. Supports Instagram, LinkedIn, Google Business Profile, Pinterest, and YouTube. Returns follower growth, reach, views, engagement rate, and platform-specific metrics.',
     inputSchema: z.object({
         account_id: z
             .number()
@@ -59,6 +59,14 @@ export const getAccountAnalyticsTool = {
                 lines.push(`• Outbound clicks: ${summary.total_website_clicks.toLocaleString()}`);
             }
         }
+        else if (account.platform === 'youtube') {
+            if (summary.total_watch_minutes != null) {
+                lines.push(`• Watch minutes: ${summary.total_watch_minutes.toLocaleString()}`);
+            }
+            if (summary.total_likes != null) {
+                lines.push(`• Likes: ${summary.total_likes.toLocaleString()}`);
+            }
+        }
         return lines.join('\n');
     },
 };

package/dist/tools/get-post-analytics.js

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 export const getPostAnalyticsTool = {
     name: 'get_post_analytics',
-    description: 'Get per-post engagement metrics (likes, comments, reach, impressions, saves, shares, plays, clicks) for a connected social account. Supports Instagram, LinkedIn, Google Business Profile, and Pinterest. Returns the most recent posts first.',
+    description: 'Get per-post engagement metrics (likes, comments, reach, impressions, saves, shares, plays, clicks, watch time) for a connected social account. Supports Instagram, LinkedIn, Google Business Profile, Pinterest, and YouTube. Returns the most recent posts first.',
     inputSchema: z.object({
         account_id: z
             .number()
@@ -55,6 +55,12 @@ export const getPostAnalyticsTool = {
                 metrics.push(`${p.shares} shares`);
             if (p.plays)
                 metrics.push(`${p.plays.toLocaleString()} plays`);
+            if (account.platform === 'youtube' && p.total_watch_time_ms) {
+                metrics.push(`${Math.round(p.total_watch_time_ms / 60000).toLocaleString()} watch minutes`);
+            }
+            if (account.platform === 'youtube' && p.avg_watch_time_ms) {
+                metrics.push(`${Math.round(p.avg_watch_time_ms / 1000)}s avg view`);
+            }
             if (p.url_link_clicks) {
                 metrics.push(account.platform === 'pinterest'
                     ? `${p.url_link_clicks.toLocaleString()} outbound clicks`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "posterly-mcp-server",
-  "version": "0.8.1",
+  "version": "0.8.2",
   "description": "MCP server for posterly — schedule social media posts from Claude Desktop",
   "license": "MIT",
   "homepage": "https://www.poster.ly/mcp",

package/src/lib/api-client.ts

@@ -117,6 +117,8 @@ export interface AccountAnalyticsSummary {
   total_direction_requests: number | null;
   total_conversations: number | null;
   total_bookings: number | null;
+  total_watch_minutes?: number | null;
+  total_likes?: number | null;
 }
 
 export interface AccountAnalyticsSnapshot {
@@ -157,8 +159,11 @@ export interface PostAnalyticsRow {
   shares: number;
   plays: number;
   total_interactions: number;
+  avg_watch_time_ms?: number | null;
+  total_watch_time_ms?: number | null;
   url_link_clicks?: number;
   user_profile_clicks?: number;
+  engagements?: number;
   media_type: string | null;
   media_url: string | null;
   permalink: string | null;

package/src/tools/get-account-analytics.ts

@@ -4,7 +4,7 @@ import type { PosterlyClient } from '../lib/api-client.js';
 export const getAccountAnalyticsTool = {
   name: 'get_account_analytics',
   description:
-    'Get daily analytics snapshots and a period summary for a connected social account. Supports Instagram, LinkedIn, Google Business Profile, and Pinterest. Returns follower growth, reach, views, engagement rate, and platform-specific metrics.',
+    'Get daily analytics snapshots and a period summary for a connected social account. Supports Instagram, LinkedIn, Google Business Profile, Pinterest, and YouTube. Returns follower growth, reach, views, engagement rate, and platform-specific metrics.',
   inputSchema: z.object({
     account_id: z
       .number()
@@ -68,6 +68,13 @@ export const getAccountAnalyticsTool = {
       if (summary.total_website_clicks !== null) {
         lines.push(`• Outbound clicks: ${summary.total_website_clicks.toLocaleString()}`);
       }
+    } else if (account.platform === 'youtube') {
+      if (summary.total_watch_minutes != null) {
+        lines.push(`• Watch minutes: ${summary.total_watch_minutes.toLocaleString()}`);
+      }
+      if (summary.total_likes != null) {
+        lines.push(`• Likes: ${summary.total_likes.toLocaleString()}`);
+      }
     }
 
     return lines.join('\n');

package/src/tools/get-post-analytics.ts

@@ -4,7 +4,7 @@ import type { PosterlyClient } from '../lib/api-client.js';
 export const getPostAnalyticsTool = {
   name: 'get_post_analytics',
   description:
-    'Get per-post engagement metrics (likes, comments, reach, impressions, saves, shares, plays, clicks) for a connected social account. Supports Instagram, LinkedIn, Google Business Profile, and Pinterest. Returns the most recent posts first.',
+    'Get per-post engagement metrics (likes, comments, reach, impressions, saves, shares, plays, clicks, watch time) for a connected social account. Supports Instagram, LinkedIn, Google Business Profile, Pinterest, and YouTube. Returns the most recent posts first.',
   inputSchema: z.object({
     account_id: z
       .number()
@@ -67,6 +67,12 @@ export const getPostAnalyticsTool = {
       if (p.saved) metrics.push(`${p.saved} saved`);
       if (p.shares) metrics.push(`${p.shares} shares`);
       if (p.plays) metrics.push(`${p.plays.toLocaleString()} plays`);
+      if (account.platform === 'youtube' && p.total_watch_time_ms) {
+        metrics.push(`${Math.round(p.total_watch_time_ms / 60000).toLocaleString()} watch minutes`);
+      }
+      if (account.platform === 'youtube' && p.avg_watch_time_ms) {
+        metrics.push(`${Math.round(p.avg_watch_time_ms / 1000)}s avg view`);
+      }
       if (p.url_link_clicks) {
         metrics.push(
           account.platform === 'pinterest'