posterly-mcp-server 0.19.0 → 0.19.1

package/dist/generated/platform-manifest.d.ts

@@ -33,7 +33,7 @@ export declare const PLATFORM_MANIFEST: {
         readonly youtube: "youtube";
     };
     readonly helperNames: readonly ["linkedin.recent_mentions", "pinterest.boards", "tiktok.creator_info", "x.quota", "youtube.playlists"];
-    readonly analyticsPlatformIds: readonly ["instagram", "linkedin", "youtube", "pinterest", "google_business"];
+    readonly analyticsPlatformIds: readonly ["instagram", "facebook", "linkedin", "youtube", "pinterest", "google_business"];
     readonly connectTargetIds: readonly ["instagram", "meta", "facebook", "youtube", "tiktok", "linkedin", "linkedin_page", "threads", "google_business", "pinterest", "twitter", "telegram", "bluesky", "reddit", "wordpress", "mastodon", "medium", "devto", "hashnode", "discord", "slack", "skool", "whop"];
     readonly connectInputs: readonly ["bluesky", "devto", "discord", "facebook", "facebook_instagram", "facebook_pages", "gmb", "google-business", "google_business", "google_business_profile", "hashnode", "instagram", "instagram-standalone", "instagram_direct", "linkedin", "linkedin-company", "linkedin-page", "linkedin_company", "linkedin_page", "linkedin_personal", "mastodon", "medium", "meta", "meta_business", "pinterest", "reddit", "skool", "slack", "telegram", "threads", "tiktok", "twitter", "whop", "wordpress", "x", "x_twitter", "youtube"];
     readonly connectAliases: {
@@ -86,7 +86,7 @@ export declare const PLATFORM_MANIFEST: {
         readonly status: "supported";
         readonly aliases: readonly [];
         readonly postTypes: readonly ["text", "image", "video", "carousel", "reel", "story", "cover_photo"];
-        readonly analyticsSupported: false;
+        readonly analyticsSupported: true;
         readonly helpers: readonly [];
     }, {
         readonly id: "tiktok";
@@ -389,4 +389,4 @@ export declare const ALL_PLATFORM_INPUTS: readonly ["bluesky", "devto", "discord
 export declare const PLATFORM_HELPER_NAMES: readonly ["linkedin.recent_mentions", "pinterest.boards", "tiktok.creator_info", "x.quota", "youtube.playlists"];
 export declare const CONNECT_TARGET_IDS: readonly ["instagram", "meta", "facebook", "youtube", "tiktok", "linkedin", "linkedin_page", "threads", "google_business", "pinterest", "twitter", "telegram", "bluesky", "reddit", "wordpress", "mastodon", "medium", "devto", "hashnode", "discord", "slack", "skool", "whop"];
 export declare const CONNECT_INPUTS: readonly ["bluesky", "devto", "discord", "facebook", "facebook_instagram", "facebook_pages", "gmb", "google-business", "google_business", "google_business_profile", "hashnode", "instagram", "instagram-standalone", "instagram_direct", "linkedin", "linkedin-company", "linkedin-page", "linkedin_company", "linkedin_page", "linkedin_personal", "mastodon", "medium", "meta", "meta_business", "pinterest", "reddit", "skool", "slack", "telegram", "threads", "tiktok", "twitter", "whop", "wordpress", "x", "x_twitter", "youtube"];
-export declare const ANALYTICS_PLATFORM_IDS: readonly ["instagram", "linkedin", "youtube", "pinterest", "google_business"];
+export declare const ANALYTICS_PLATFORM_IDS: readonly ["instagram", "facebook", "linkedin", "youtube", "pinterest", "google_business"];

package/dist/generated/platform-manifest.js

@@ -131,6 +131,7 @@ export const PLATFORM_MANIFEST = {
     ],
     "analyticsPlatformIds": [
         "instagram",
+        "facebook",
         "linkedin",
         "youtube",
         "pinterest",
@@ -268,7 +269,7 @@ export const PLATFORM_MANIFEST = {
                 "story",
                 "cover_photo"
             ],
-            "analyticsSupported": false,
+            "analyticsSupported": true,
             "helpers": []
         },
         {
@@ -692,4 +693,4 @@ export const ALL_PLATFORM_INPUTS = ["bluesky", "devto", "discord", "facebook", "
 export const PLATFORM_HELPER_NAMES = ["linkedin.recent_mentions", "pinterest.boards", "tiktok.creator_info", "x.quota", "youtube.playlists"];
 export const CONNECT_TARGET_IDS = ["instagram", "meta", "facebook", "youtube", "tiktok", "linkedin", "linkedin_page", "threads", "google_business", "pinterest", "twitter", "telegram", "bluesky", "reddit", "wordpress", "mastodon", "medium", "devto", "hashnode", "discord", "slack", "skool", "whop"];
 export const CONNECT_INPUTS = ["bluesky", "devto", "discord", "facebook", "facebook_instagram", "facebook_pages", "gmb", "google-business", "google_business", "google_business_profile", "hashnode", "instagram", "instagram-standalone", "instagram_direct", "linkedin", "linkedin-company", "linkedin-page", "linkedin_company", "linkedin_page", "linkedin_personal", "mastodon", "medium", "meta", "meta_business", "pinterest", "reddit", "skool", "slack", "telegram", "threads", "tiktok", "twitter", "whop", "wordpress", "x", "x_twitter", "youtube"];
-export const ANALYTICS_PLATFORM_IDS = ["instagram", "linkedin", "youtube", "pinterest", "google_business"];
+export const ANALYTICS_PLATFORM_IDS = ["instagram", "facebook", "linkedin", "youtube", "pinterest", "google_business"];

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

@@ -147,6 +147,7 @@ export interface Whoami {
 export interface AccountAnalyticsSummary {
     current_followers: number;
     followers_change: number;
+    current_media_count?: number;
     total_reach: number | null;
     total_views: number | null;
     total_profile_views?: number | null;
@@ -162,6 +163,7 @@ export interface AccountAnalyticsSummary {
     total_bookings: number | null;
     total_watch_minutes?: number | null;
     total_likes?: number | null;
+    platform_metrics?: Record<string, number | null | undefined>;
 }
 export interface AccountAnalyticsSnapshot {
     date: string;

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, Pinterest, and YouTube. 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, Facebook, 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()
@@ -23,49 +23,32 @@ export const getAccountAnalyticsTool = {
             `Range: ${range.from} → ${range.to} (${snapshots.length} daily snapshots)`,
             '',
             'Summary:',
-            `• Followers: ${summary.current_followers.toLocaleString()} (${formatDelta(summary.followers_change)} in range)`,
-            `• Follows gained / lost: +${summary.total_follows_gained} / -${summary.total_follows_lost}`,
         ];
-        if (summary.total_reach !== null)
-            lines.push(`• Total reach: ${summary.total_reach.toLocaleString()}`);
-        if (summary.total_views !== null)
-            lines.push(`• Total views: ${summary.total_views.toLocaleString()}`);
-        if (summary.total_profile_views != null) {
-            lines.push(`• Profile views: ${summary.total_profile_views.toLocaleString()}`);
-        }
-        if (summary.total_accounts_engaged !== null) {
-            lines.push(`• Total accounts engaged: ${summary.total_accounts_engaged.toLocaleString()}`);
-        }
-        lines.push(`• Engagement rate (by reach): ${summary.engagement_rate}%`, `• Engagement rate (by followers): ${summary.engagement_rate_by_followers}%`);
         if (account.platform === 'google_business') {
-            if (summary.total_website_clicks !== null) {
-                lines.push(`• Website clicks: ${summary.total_website_clicks.toLocaleString()}`);
-            }
-            if (summary.total_call_clicks !== null) {
-                lines.push(`• Call clicks: ${summary.total_call_clicks.toLocaleString()}`);
-            }
-            if (summary.total_direction_requests !== null) {
-                lines.push(`• Direction requests: ${summary.total_direction_requests.toLocaleString()}`);
-            }
-            if (summary.total_conversations !== null) {
-                lines.push(`• Conversations: ${summary.total_conversations.toLocaleString()}`);
-            }
-            if (summary.total_bookings !== null) {
-                lines.push(`• Bookings: ${summary.total_bookings.toLocaleString()}`);
-            }
+            const metrics = summary.platform_metrics || {};
+            pushMetric(lines, 'Profile views', metrics.profile_views ?? summary.total_views);
+            pushMetric(lines, 'Search views', metrics.search_views ?? summary.total_reach);
+            pushMetric(lines, 'Maps views', metrics.maps_views ?? summary.total_profile_views);
+            pushMetric(lines, 'Customer actions', metrics.customer_actions ?? summary.total_accounts_engaged);
+            pushMetric(lines, 'Posts', metrics.posts ?? summary.current_media_count);
+            lines.push(`• Engagement rate (actions / profile views): ${summary.engagement_rate}%`);
+            pushMetric(lines, 'Website clicks', metrics.website_clicks ?? summary.total_website_clicks);
+            pushMetric(lines, 'Call clicks', metrics.call_clicks ?? summary.total_call_clicks);
+            pushMetric(lines, 'Direction requests', metrics.direction_requests ?? summary.total_direction_requests);
+            pushMetric(lines, 'Conversations', metrics.conversations ?? summary.total_conversations);
+            pushMetric(lines, 'Bookings', metrics.bookings ?? summary.total_bookings);
         }
         else if (account.platform === 'pinterest') {
-            if (summary.total_website_clicks !== null) {
-                lines.push(`• Outbound clicks: ${summary.total_website_clicks.toLocaleString()}`);
-            }
+            pushGenericSummary(lines, summary);
+            pushMetric(lines, 'Outbound clicks', summary.total_website_clicks);
         }
         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()}`);
-            }
+            pushGenericSummary(lines, summary);
+            pushMetric(lines, 'Watch minutes', summary.total_watch_minutes);
+            pushMetric(lines, 'Likes', summary.total_likes);
+        }
+        else {
+            pushGenericSummary(lines, summary);
         }
         return lines.join('\n');
     },
@@ -73,3 +56,16 @@ export const getAccountAnalyticsTool = {
 function formatDelta(n) {
     return n >= 0 ? `+${n.toLocaleString()}` : n.toLocaleString();
 }
+function pushGenericSummary(lines, summary) {
+    lines.push(`• Followers: ${summary.current_followers.toLocaleString()} (${formatDelta(summary.followers_change)} in range)`, `• Follows gained / lost: +${summary.total_follows_gained} / -${summary.total_follows_lost}`);
+    pushMetric(lines, 'Total reach', summary.total_reach);
+    pushMetric(lines, 'Total views', summary.total_views);
+    pushMetric(lines, 'Profile views', summary.total_profile_views);
+    pushMetric(lines, 'Total accounts engaged', summary.total_accounts_engaged);
+    lines.push(`• Engagement rate (by reach): ${summary.engagement_rate}%`, `• Engagement rate (by followers): ${summary.engagement_rate_by_followers}%`);
+}
+function pushMetric(lines, label, value) {
+    if (value != null) {
+        lines.push(`• ${label}: ${value.toLocaleString()}`);
+    }
+}

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, watch time) for a connected social account. Supports Instagram, LinkedIn, Google Business Profile, Pinterest, and YouTube. 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, Facebook, LinkedIn, Google Business Profile, Pinterest, and YouTube. Returns the most recent posts first.',
     inputSchema: z.object({
         account_id: z
             .number()

package/package.json

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

package/src/generated/platform-manifest.ts

@@ -131,6 +131,7 @@ export const PLATFORM_MANIFEST = {
   ],
   "analyticsPlatformIds": [
     "instagram",
+    "facebook",
     "linkedin",
     "youtube",
     "pinterest",
@@ -268,7 +269,7 @@ export const PLATFORM_MANIFEST = {
         "story",
         "cover_photo"
       ],
-      "analyticsSupported": false,
+      "analyticsSupported": true,
       "helpers": []
     },
     {
@@ -692,4 +693,4 @@ export const ALL_PLATFORM_INPUTS = ["bluesky","devto","discord","facebook","gmb"
 export const PLATFORM_HELPER_NAMES = ["linkedin.recent_mentions","pinterest.boards","tiktok.creator_info","x.quota","youtube.playlists"] as const;
 export const CONNECT_TARGET_IDS = ["instagram","meta","facebook","youtube","tiktok","linkedin","linkedin_page","threads","google_business","pinterest","twitter","telegram","bluesky","reddit","wordpress","mastodon","medium","devto","hashnode","discord","slack","skool","whop"] as const;
 export const CONNECT_INPUTS = ["bluesky","devto","discord","facebook","facebook_instagram","facebook_pages","gmb","google-business","google_business","google_business_profile","hashnode","instagram","instagram-standalone","instagram_direct","linkedin","linkedin-company","linkedin-page","linkedin_company","linkedin_page","linkedin_personal","mastodon","medium","meta","meta_business","pinterest","reddit","skool","slack","telegram","threads","tiktok","twitter","whop","wordpress","x","x_twitter","youtube"] as const;
-export const ANALYTICS_PLATFORM_IDS = ["instagram","linkedin","youtube","pinterest","google_business"] as const;
+export const ANALYTICS_PLATFORM_IDS = ["instagram","facebook","linkedin","youtube","pinterest","google_business"] as const;

package/src/lib/api-client.ts

@@ -135,6 +135,7 @@ export interface Whoami {
 export interface AccountAnalyticsSummary {
   current_followers: number;
   followers_change: number;
+  current_media_count?: number;
   total_reach: number | null;
   total_views: number | null;
   total_profile_views?: number | null;
@@ -150,6 +151,7 @@ export interface AccountAnalyticsSummary {
   total_bookings: number | null;
   total_watch_minutes?: number | null;
   total_likes?: number | null;
+  platform_metrics?: Record<string, number | null | undefined>;
 }
 
 export interface AccountAnalyticsSnapshot {

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

@@ -1,10 +1,10 @@
 import { z } from 'zod';
-import type { PosterlyClient } from '../lib/api-client.js';
+import type { AccountAnalyticsSummary, 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, Pinterest, and YouTube. 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, Facebook, 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()
@@ -31,50 +31,30 @@ export const getAccountAnalyticsTool = {
       `Range: ${range.from} → ${range.to} (${snapshots.length} daily snapshots)`,
       '',
       'Summary:',
-      `• Followers: ${summary.current_followers.toLocaleString()} (${formatDelta(summary.followers_change)} in range)`,
-      `• Follows gained / lost: +${summary.total_follows_gained} / -${summary.total_follows_lost}`,
     ];
 
-    if (summary.total_reach !== null) lines.push(`• Total reach: ${summary.total_reach.toLocaleString()}`);
-    if (summary.total_views !== null) lines.push(`• Total views: ${summary.total_views.toLocaleString()}`);
-    if (summary.total_profile_views != null) {
-      lines.push(`• Profile views: ${summary.total_profile_views.toLocaleString()}`);
-    }
-    if (summary.total_accounts_engaged !== null) {
-      lines.push(`• Total accounts engaged: ${summary.total_accounts_engaged.toLocaleString()}`);
-    }
-    lines.push(
-      `• Engagement rate (by reach): ${summary.engagement_rate}%`,
-      `• Engagement rate (by followers): ${summary.engagement_rate_by_followers}%`
-    );
-
     if (account.platform === 'google_business') {
-      if (summary.total_website_clicks !== null) {
-        lines.push(`• Website clicks: ${summary.total_website_clicks.toLocaleString()}`);
-      }
-      if (summary.total_call_clicks !== null) {
-        lines.push(`• Call clicks: ${summary.total_call_clicks.toLocaleString()}`);
-      }
-      if (summary.total_direction_requests !== null) {
-        lines.push(`• Direction requests: ${summary.total_direction_requests.toLocaleString()}`);
-      }
-      if (summary.total_conversations !== null) {
-        lines.push(`• Conversations: ${summary.total_conversations.toLocaleString()}`);
-      }
-      if (summary.total_bookings !== null) {
-        lines.push(`• Bookings: ${summary.total_bookings.toLocaleString()}`);
-      }
+      const metrics = summary.platform_metrics || {};
+      pushMetric(lines, 'Profile views', metrics.profile_views ?? summary.total_views);
+      pushMetric(lines, 'Search views', metrics.search_views ?? summary.total_reach);
+      pushMetric(lines, 'Maps views', metrics.maps_views ?? summary.total_profile_views);
+      pushMetric(lines, 'Customer actions', metrics.customer_actions ?? summary.total_accounts_engaged);
+      pushMetric(lines, 'Posts', metrics.posts ?? summary.current_media_count);
+      lines.push(`• Engagement rate (actions / profile views): ${summary.engagement_rate}%`);
+      pushMetric(lines, 'Website clicks', metrics.website_clicks ?? summary.total_website_clicks);
+      pushMetric(lines, 'Call clicks', metrics.call_clicks ?? summary.total_call_clicks);
+      pushMetric(lines, 'Direction requests', metrics.direction_requests ?? summary.total_direction_requests);
+      pushMetric(lines, 'Conversations', metrics.conversations ?? summary.total_conversations);
+      pushMetric(lines, 'Bookings', metrics.bookings ?? summary.total_bookings);
     } else if (account.platform === 'pinterest') {
-      if (summary.total_website_clicks !== null) {
-        lines.push(`• Outbound clicks: ${summary.total_website_clicks.toLocaleString()}`);
-      }
+      pushGenericSummary(lines, summary);
+      pushMetric(lines, 'Outbound clicks', summary.total_website_clicks);
     } 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()}`);
-      }
+      pushGenericSummary(lines, summary);
+      pushMetric(lines, 'Watch minutes', summary.total_watch_minutes);
+      pushMetric(lines, 'Likes', summary.total_likes);
+    } else {
+      pushGenericSummary(lines, summary);
     }
 
     return lines.join('\n');
@@ -84,3 +64,24 @@ export const getAccountAnalyticsTool = {
 function formatDelta(n: number): string {
   return n >= 0 ? `+${n.toLocaleString()}` : n.toLocaleString();
 }
+
+function pushGenericSummary(lines: string[], summary: AccountAnalyticsSummary) {
+  lines.push(
+    `• Followers: ${summary.current_followers.toLocaleString()} (${formatDelta(summary.followers_change)} in range)`,
+    `• Follows gained / lost: +${summary.total_follows_gained} / -${summary.total_follows_lost}`
+  );
+  pushMetric(lines, 'Total reach', summary.total_reach);
+  pushMetric(lines, 'Total views', summary.total_views);
+  pushMetric(lines, 'Profile views', summary.total_profile_views);
+  pushMetric(lines, 'Total accounts engaged', summary.total_accounts_engaged);
+  lines.push(
+    `• Engagement rate (by reach): ${summary.engagement_rate}%`,
+    `• Engagement rate (by followers): ${summary.engagement_rate_by_followers}%`
+  );
+}
+
+function pushMetric(lines: string[], label: string, value: number | null | undefined) {
+  if (value != null) {
+    lines.push(`• ${label}: ${value.toLocaleString()}`);
+  }
+}

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, watch time) for a connected social account. Supports Instagram, LinkedIn, Google Business Profile, Pinterest, and YouTube. 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, Facebook, LinkedIn, Google Business Profile, Pinterest, and YouTube. Returns the most recent posts first.',
   inputSchema: z.object({
     account_id: z
       .number()