@cmo-so/mcp 0.3.0 → 0.4.0

package/dist/cmo-mcp.mjs

@@ -7199,7 +7199,7 @@ var require_dist = __commonJS({
 // package.json
 var package_default = {
   name: "@cmo-so/cli",
-  version: "0.3.0",
+  version: "0.4.0",
   description: "CMO.so on the command line: your websites, ideas, blog posts, LinkedIn queue and results, plus a local MCP server for Claude Desktop, Cursor and other MCP clients.",
   type: "module",
   license: "MIT",
@@ -7530,7 +7530,15 @@ function dataUrl(type, bytes) {
 }
 
 // ../../packages/api-client/src/domains.ts
-var MEMORY_CHANNELS = ["general", "blog", "linkedin", "facebook", "instagram", "google_business"];
+var MEMORY_CHANNELS = [
+  "general",
+  "blog",
+  "linkedin",
+  "facebook",
+  "instagram",
+  "google_business",
+  "youtube"
+];
 function addWebsite(api2, url) {
   return api2.request("/v1/domains", {
     method: "POST",
@@ -7763,7 +7771,24 @@ function domainApi(api2, domain) {
       `${base}/social/google_business/location`,
       { connection_id: connectionId }
     ),
+    /** How the Google Business Profile is doing: the last 28 days and the 28 before (Google lags 2-3 days). */
+    googleBusinessPerformance: (refresh = false) => api2.request(`${base}/social/google_business/performance${refresh ? "?refresh=true" : ""}`),
     disconnectGoogleBusiness: (connectionId) => api2.request(`${base}/social/google_business/${connectionId}`, { method: "DELETE" }),
+    /** A Google sign-in link for this website's YouTube channel (docs/prd/youtube.md §7); back with ?youtube=connected
+     *  (or none when the Google account has no channel, error&message=…). */
+    connectYouTube: (returnTo = "close") => post(`${base}/social/youtube/connect`, { return_to: returnTo }),
+    /** Your YouTube channels here (name, @handle, picture, subscribers), and the one this website posts to. */
+    youtubeChannels: () => api2.request(
+      `${base}/social/youtube/channels`
+    ),
+    chooseYouTubeChannel: (connectionId) => put(
+      `${base}/social/youtube/channel`,
+      {
+        connection_id: connectionId
+      }
+    ),
+    /** Disconnect: the token is deleted and Google's access revoked (YouTube's policy). */
+    disconnectYouTube: (connectionId) => api2.request(`${base}/social/youtube/${connectionId}`, { method: "DELETE" }),
     /** One channel's own pause switch (pauseSocial / resumeSocial hold every channel). */
     setChannelPaused: (channel, paused) => post(`${base}/social/channels/${channel}/${paused ? "pause" : "resume"}`),
     /** How often one channel posts. */
@@ -7928,7 +7953,34 @@ function domainApi(api2, domain) {
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify({ cta_type: ctaType })
     }),
+    /** Make a Google Business post an Event or Offer (or back to an update with { type: "STANDARD" }). */
+    setSocialGooglePost: (id, googlePost) => api2.request(`${base}/social/${id}`, {
+      method: "PATCH",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ google_post: googlePost })
+    }),
     resumeSocial: () => post(`${base}/social/resume`),
+    /** Start a video upload: PUT each part_size slice of the file to its url, keep the ETags, then completeVideoUpload. */
+    startVideoUpload: (file) => post(
+      `${base}/social/video/upload`,
+      file
+    ),
+    completeVideoUpload: (videoId, parts, edit) => post(`${base}/social/video/${videoId}/complete`, { parts, edit }),
+    /** A direct link to a video file (not a YouTube / TikTok page). */
+    videoFromLink: (url, edit) => post(`${base}/social/video/link`, { url, edit }),
+    video: (videoId) => api2.request(`${base}/social/video/${videoId}`),
+    /** Another part or framing; prepared again in the background. */
+    editVideo: (videoId, edit) => post(`${base}/social/video/${videoId}/edit`, { edit }),
+    /** A YouTube post from a ready video, waiting in Review; Maggie writes the details unless write is false. */
+    postFromVideo: (videoId, opts = {}) => post(`${base}/social/video/${videoId}/post`, opts),
+    youtubeSettings: () => api2.request(`${base}/social/youtube/settings`),
+    setYouTubeSettings: (s) => put(`${base}/social/youtube/settings`, s),
+    /** A YouTube post's title, tags, visibility, made-for-kids or altered-content answer. */
+    setSocialYouTube: (id, answers) => api2.request(`${base}/social/${id}`, {
+      method: "PATCH",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ youtube: answers })
+    }),
     pauseAutopilot: () => post(`${base}/autopilot/pause`),
     resumeAutopilot: () => post(`${base}/autopilot/resume`),
     // Reports (docs/18 §6): report:read with the user's own key.
@@ -8349,6 +8401,22 @@ var confirmCopy = {
     en: (a) => `Bring back LinkedIn post #${a.id}.`,
     "zh-Hant": (a) => `\u6062\u5FA9 LinkedIn \u8CBC\u6587 #${a.id}\u3002`
   },
+  youtube_connect_link: {
+    en: () => "Make a link to connect your YouTube channel.",
+    "zh-Hant": () => "\u7522\u751F\u9023\u63A5\u4F60 YouTube \u983B\u9053\u7684\u9023\u7D50\u3002"
+  },
+  social_video_add: {
+    en: (a) => `Make a YouTube post from ${a.url}${a.write === false ? "" : " (Maggie writes the title and description: one AI generation)"}; it waits for your OK.`,
+    "zh-Hant": (a) => `\u7528 ${a.url} \u505A\u4E00\u5247 YouTube \u5F71\u7247\u8CBC\u6587${a.write === false ? "" : "\uFF08Maggie \u5BEB\u6A19\u984C\u548C\u8AAA\u660E\uFF1A\u7528\u4E00\u6B21 AI \u751F\u6210\uFF09"}\uFF0C\u7B49\u4F60\u78BA\u8A8D\u5F8C\u624D\u767C\u3002`
+  },
+  social_youtube_set: {
+    en: (a) => `Change YouTube post #${a.id}: ${keys(a).filter((k) => k !== "id").join(", ") || "its details"}.`,
+    "zh-Hant": (a) => `\u4FEE\u6539 YouTube \u8CBC\u6587 #${a.id}\uFF1A${keys(a).filter((k) => k !== "id").join("\u3001") || "\u7D30\u7BC0"}\u3002`
+  },
+  youtube_settings_set: {
+    en: (a) => `Change your YouTube defaults: ${keys(a).join(", ") || "nothing"}.`,
+    "zh-Hant": (a) => `\u4FEE\u6539 YouTube \u9810\u8A2D\uFF1A${keys(a).join("\u3001") || "\u7121"}\u3002`
+  },
   social_image_new: {
     en: (a) => `Make a new picture for LinkedIn post #${a.id}${a.instruction ? `: ${String(a.instruction).slice(0, 300)}` : ""} (1 AI generation, in the background)${a.replace ? ", stopping the one being made for another post" : ""}.`,
     "zh-Hant": (a) => `\u70BA LinkedIn \u8CBC\u6587 #${a.id} \u751F\u6210\u65B0\u5716\u7247${a.instruction ? `\uFF1A${String(a.instruction).slice(0, 300)}` : ""}\uFF08\u7528 1 \u6B21 AI \u751F\u6210\uFF0C\u5728\u80CC\u666F\u9032\u884C\uFF09${a.replace ? "\uFF0C\u4E26\u505C\u6B62\u6B63\u5728\u70BA\u53E6\u4E00\u7BC7\u751F\u6210\u7684\u5716\u7247" : ""}\u3002`
@@ -10362,10 +10430,11 @@ var read5 = { resource: "autopilot", level: "read" };
 var write5 = { resource: "autopilot", level: "write" };
 var moves2 = ["up", "down", "top"];
 var CHANNEL_KEYS = ["linkedin", "facebook", "instagram", "google_business"];
+var ALL_CHANNEL_KEYS = [...CHANNEL_KEYS, "youtube"];
 var channelsParam = {
   type: "array",
   items: { type: "string", enum: CHANNEL_KEYS },
-  description: "Which channels to write for: linkedin, facebook. Leave out to write for every connected channel (one post each, one credit each); give one only when the user names it."
+  description: "Which channels to write for: linkedin, facebook, instagram, google_business. Leave out to write for every connected channel (one post each, one credit each); give one only when the user names it. YouTube takes a video: use social_video_add."
 };
 var channelsOf = (value) => {
   const list2 = Array.isArray(value) ? value.map((v) => String(v).toLowerCase()).filter((v) => CHANNEL_KEYS.includes(v)) : [];
@@ -10388,7 +10457,11 @@ var item = (i) => ({
   campaign: i.campaign ?? null,
   failure: i.failure_message ?? null,
   link: i.provider_permalink ?? null,
-  text: clip(i.social_copy, 300)
+  text: clip(i.social_copy, 300),
+  ...i.provider === "youtube" ? {
+    youtube: i.youtube ?? null,
+    video: i.video ? { status: i.video.status, seconds: i.video.duration, shape: i.video.shape, error: i.video.error } : null
+  } : {}
 });
 var socialTools = [
   tool({
@@ -10797,7 +10870,7 @@ var socialTools = [
     description: "Pause or resume the user's social posting: one channel (linkedin or facebook), or every channel when no channel is given.",
     parameters: {
       type: "object",
-      properties: { paused: { type: "boolean" }, channel: { type: "string", enum: CHANNEL_KEYS } },
+      properties: { paused: { type: "boolean" }, channel: { type: "string", enum: ALL_CHANNEL_KEYS } },
       required: ["paused"]
     },
     group: "social",
@@ -11353,6 +11426,174 @@ var socialTools = [
       return { id: out.id, button: out.cta_type ?? "LEARN_MORE", link: out.cta_url ?? null };
     }
   }),
+  tool({
+    name: "youtube_connect_link",
+    description: "A link for the user to connect their YouTube channel (or reconnect): they sign in with the Google account that owns the channel and allow Maggie to upload videos and see the channel. Give them the link to open; never ask for a password. YouTube posts are short videos (5-30 seconds now) that the user approves one by one.",
+    parameters: none,
+    group: "social",
+    need: write5,
+    risk: "W1",
+    gates: ["VER"],
+    run: async (ctx) => {
+      const out = await ws(ctx).connectYouTube("close");
+      return { url: out.url, expires_in_seconds: out.expires_in_seconds };
+    }
+  }),
+  tool({
+    name: "social_video_add",
+    description: "Make a YouTube post from a video: a DIRECT link to a video file (an .mp4 on their website, a public Dropbox link), never a YouTube / TikTok / Instagram page (we never download those; tell the user to upload the video in the app instead). The video must be 5-30 seconds: give start/end (seconds) to use a part of a longer one. vertical: make a wide video vertical (a Short) cropped at left, middle or right. Maggie writes the title, description and tags from the video and the note (one AI generation) unless write is false. The post waits in Review: YouTube posts are always approved by the user, who must also answer whether it's made for kids. Preview first.",
+    parameters: {
+      type: "object",
+      properties: {
+        url: { type: "string", description: "Direct https link to the video file" },
+        note: { type: "string", description: "What the video is about, in the user's words" },
+        write: { type: "boolean", description: "Let Maggie write the details (default true)" },
+        start: { type: "number", description: "Start of the part to use, seconds" },
+        end: { type: "number", description: "End of the part to use, seconds" },
+        vertical: { type: "string", enum: ["left", "middle", "right"] }
+      },
+      required: ["url"]
+    },
+    group: "social",
+    need: write5,
+    risk: "W2",
+    gates: ["VER", "LLM"],
+    run: async (ctx, a) => {
+      const d = ws(ctx);
+      const edit = {
+        ...a.start != null ? { start: Number(a.start) } : {},
+        ...a.end != null ? { end: Number(a.end) } : {},
+        ...a.vertical ? { aspect: "9:16", crop_x: a.vertical === "left" ? 0 : a.vertical === "right" ? 1 : 0.5 } : {}
+      };
+      let v = await d.videoFromLink(String(a.url), Object.keys(edit).length ? edit : void 0);
+      const until = Date.now() + 15e4;
+      while ((v.status === "checking" || v.status === "uploading") && Date.now() < until) {
+        await new Promise((r) => setTimeout(r, 3e3));
+        v = await d.video(v.id);
+      }
+      if (v.status !== "ready")
+        return { ok: false, video: { status: v.status, error: v.error, seconds: v.source_duration } };
+      const post = await d.postFromVideo(v.id, { note: a.note ?? "", write: a.write !== false });
+      return {
+        ok: true,
+        post: item(post),
+        next: "Show the title and description; ask whether it's made for kids and which visibility, then social_youtube_set; the user approves it."
+      };
+    }
+  }),
+  tool({
+    name: "social_youtube_set",
+    description: "Change a YouTube post that hasn't gone out: title (at most 100 characters, aim 40-60), tags, visibility (public, unlisted, private), made_for_kids (YouTube asks for every video: ask the user, never guess) or synthetic (realistic AI-made or altered content). The description is the post's text (social_update_copy). Preview first.",
+    parameters: {
+      type: "object",
+      properties: {
+        id: { type: "integer", description: "A YouTube post (from social_list)" },
+        title: { type: "string" },
+        tags: { type: "array", items: { type: "string" } },
+        privacy: { type: "string", enum: ["public", "unlisted", "private"] },
+        made_for_kids: { type: "boolean" },
+        synthetic: { type: "boolean" }
+      },
+      required: ["id"]
+    },
+    group: "social",
+    need: write5,
+    risk: "W1",
+    gates: ["VER"],
+    run: async (ctx, { id, ...rest }) => {
+      const answers = Object.fromEntries(
+        Object.entries(rest).filter(([, v]) => v !== void 0)
+      );
+      const out = await ws(ctx).setSocialYouTube(Number(id), answers);
+      return item(out);
+    }
+  }),
+  tool({
+    name: "youtube_settings",
+    description: "The user's YouTube defaults for new posts on this website: visibility, made_for_kids (null = asked each time), category and altered content.",
+    parameters: none,
+    group: "social",
+    need: read5,
+    risk: "R0",
+    run: async (ctx) => ws(ctx).youtubeSettings()
+  }),
+  tool({
+    name: "youtube_settings_set",
+    description: "Change the YouTube defaults for new posts: privacy (public, unlisted, private), made_for_kids (yes / no for every video, or ask per video) and synthetic. Only what the user says. Preview first.",
+    parameters: {
+      type: "object",
+      properties: {
+        privacy: { type: "string", enum: ["public", "unlisted", "private"] },
+        made_for_kids: {
+          type: "string",
+          enum: ["yes", "no", "ask"],
+          description: "yes / no for every new video, or ask (answer per video)"
+        },
+        synthetic: { type: "boolean" }
+      }
+    },
+    group: "social",
+    need: write5,
+    risk: "W1",
+    gates: ["VER"],
+    run: async (ctx, a) => ws(ctx).setYouTubeSettings({
+      ...a.privacy ? { privacy: a.privacy } : {},
+      ...a.made_for_kids ? { made_for_kids: a.made_for_kids === "ask" ? null : a.made_for_kids === "yes" } : {},
+      ...a.synthetic != null ? { synthetic: a.synthetic } : {}
+    })
+  }),
+  tool({
+    name: "google_business_performance",
+    description: "How the website's Google Business Profile is doing: views on Google Search and Maps, website clicks, calls and direction requests for the last 28 days next to the 28 before (Google's numbers lag 2-3 days). Use it when the user asks how their Google listing or local presence is doing, or to show what Google posts are worth. Compare with the previous 28 days; don't invent reasons for changes.",
+    parameters: {
+      type: "object",
+      properties: { refresh: { type: "boolean", description: "Read Google again now (else up to 6 hours old)" } }
+    },
+    group: "social",
+    need: read5,
+    risk: "R0",
+    run: async (ctx, { refresh }) => ws(ctx).googleBusinessPerformance(refresh === true)
+  }),
+  tool({
+    name: "social_google_post_type",
+    description: "Make a Google Business post that hasn't gone out an EVENT (an open day, a workshop: title up to 58 characters, start and end dates YYYY-MM-DD, optional times HH:MM) or an OFFER (title, dates, optional coupon code, terms and redeem link; Google adds a View offer button), or back to STANDARD (an update). Offers are refused for regulated categories (finance, health, alcohol, gambling) and hotels: use an update or an event. Only real dates and offers the user gave. Preview first.",
+    parameters: {
+      type: "object",
+      properties: {
+        id: { type: "integer", description: "A Google Business post (from social_list)" },
+        type: { type: "string", enum: ["STANDARD", "EVENT", "OFFER"] },
+        title: { type: "string", description: "Event or offer title, up to 58 characters" },
+        start: { type: "string", description: "YYYY-MM-DD" },
+        end: { type: "string", description: "YYYY-MM-DD (defaults to start)" },
+        start_time: { type: "string", description: "HH:MM (optional)" },
+        end_time: { type: "string", description: "HH:MM (optional)" },
+        coupon: { type: "string", description: "Offer code (optional)" },
+        terms: { type: "string", description: "Offer terms (optional)" },
+        redeem_url: { type: "string", description: "Where to redeem the offer online (optional)" }
+      },
+      required: ["id", "type"]
+    },
+    group: "social",
+    need: write5,
+    risk: "W1",
+    gates: ["VER"],
+    run: async (ctx, a) => {
+      const type = String(a.type).toUpperCase();
+      const body = type === "STANDARD" ? { type: "STANDARD" } : {
+        type,
+        title: String(a.title ?? ""),
+        start: String(a.start ?? ""),
+        ...a.end ? { end: a.end } : {},
+        ...a.start_time ? { start_time: a.start_time } : {},
+        ...a.end_time ? { end_time: a.end_time } : {},
+        ...a.coupon ? { coupon: a.coupon } : {},
+        ...a.terms ? { terms: a.terms } : {},
+        ...a.redeem_url ? { redeem_url: a.redeem_url } : {}
+      };
+      const out = await ws(ctx).setSocialGooglePost(Number(a.id), body);
+      return { id: out.id, google_post: out.google_post ?? null };
+    }
+  }),
   tool({
     name: "instagram_connect_link",
     description: "A link for the user to connect Instagram (or reconnect). Instagram connects through the Facebook sign-in: only an Instagram professional account (Business or Creator) linked to one of their Facebook Pages can be posted to, so tell them that first. Give them the link to open; never ask for a password. Every Instagram post goes out with its picture (no links in it).",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@cmo-so/mcp",
-	"version": "0.3.0",
+	"version": "0.4.0",
 	"description": "CMO.so's MCP server for Claude Desktop, Cursor, VS Code and other MCP clients: manage your websites, blog posts, LinkedIn queue and results with Maggie.",
 	"type": "module",
 	"license": "MIT",