@cmo-so/mcp 0.7.5 → 0.7.7

package/dist/cmo-mcp.mjs

@@ -7199,7 +7199,7 @@ var require_dist = __commonJS({
 // package.json
 var package_default = {
   name: "@cmo-so/cli",
-  version: "0.7.5",
+  version: "0.7.7",
   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",
@@ -7526,11 +7526,12 @@ function createApi({ baseUrl, session: session2, fetch: fetchImpl = globalThis.f
         return request(`/v1/skills?${qs}`);
       },
       get: (id) => request(`/v1/skills/${encodeURIComponent(id)}`),
-      /** Like or save a skill (on: false undoes it). */
-      react: (id, kind, on2 = true) => request(
-        `/v1/skills/${encodeURIComponent(id)}/react`,
-        { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ kind, on: on2 }) }
-      ),
+      /** Vote on or save a skill (on: false undoes it). "like" is an upvote. */
+      react: (id, kind, on2 = true) => request(`/v1/skills/${encodeURIComponent(id)}/react`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ kind, on: on2 })
+      }),
       saved: () => request("/v1/skills/saved"),
       /** Suggest an open-source GitHub repo; Maggie researches it (3 a day). */
       submit: (repoUrl, note) => request("/v1/skills/submissions", {
@@ -8201,9 +8202,9 @@ function domainApi(api2, domain) {
     /** The last time posts delivered by API pull were found in the website's sitemap (gives them their address). */
     sitemapMatch: () => api2.request(`${base}/rewrites/sitemap-match`),
     /** Read the sitemap (found on its own when blank) and match API-pull posts to their live address. */
-    runSitemapMatch: (sitemapUrl) => post(
+    runSitemapMatch: (sitemapUrl2) => post(
       `${base}/rewrites/sitemap-match`,
-      sitemapUrl ? { sitemap_url: sitemapUrl } : {}
+      sitemapUrl2 ? { sitemap_url: sitemapUrl2 } : {}
     ),
     rewritePolicy: () => api2.request(`${base}/rewrite-policy`),
     setRewritePolicy: (p) => put(`${base}/rewrite-policy`, p),
@@ -8340,6 +8341,75 @@ function createSession({ oauth: oauth2, store, skewMs = 6e4, now = Date.now, onS
   };
 }
 
+// ../../packages/api-client/src/sitemaps.ts
+var SITEMAPS_MAX = 20;
+var SITEMAP_LABEL_MAX = 80;
+var SITEMAP_OWNERS = ["own", "competitor", "other"];
+var SITEMAP_USES = {
+  own: ["post_ideas", "channel_ideas", "internal_links", "post_matching"],
+  competitor: ["post_ideas", "channel_ideas"],
+  other: ["post_ideas", "channel_ideas"]
+};
+function sitemapUrl(input) {
+  let v = input.trim();
+  if (!v || /^[a-z][a-z0-9+.-]*:(?!\/\/|\d)/i.test(v)) return null;
+  if (!/^[a-z][a-z0-9+.-]*:\/\//i.test(v)) v = `https://${v}`;
+  let u;
+  try {
+    u = new URL(v);
+  } catch {
+    return null;
+  }
+  if (u.protocol !== "http:" && u.protocol !== "https:" || u.username || u.password) return null;
+  if (!u.hostname.includes(".") || /\s/.test(v)) return null;
+  u.protocol = "https:";
+  return u.toString();
+}
+function sitemapUses(owner, uses) {
+  const allowed2 = SITEMAP_USES[owner];
+  const kept = allowed2.filter((u) => uses?.includes(u));
+  return kept.length ? kept : [...allowed2];
+}
+function onWebsite(url, domain) {
+  let host;
+  try {
+    host = new URL(url).hostname.toLowerCase();
+  } catch {
+    return false;
+  }
+  const d = domain.trim().toLowerCase().replace(/^https?:\/\//, "").replace(/\/.*$/, "").replace(/^www\./, "");
+  return Boolean(d) && (host === d || host.endsWith(`.${d}`));
+}
+function cleanSitemap(entry, domain) {
+  const url = sitemapUrl(entry.url ?? "");
+  if (!url) return "The sitemap must be a web address starting with http:// or https://.";
+  let owner = SITEMAP_OWNERS.includes(entry.owner) ? entry.owner : "other";
+  if (owner === "own" && domain && !onWebsite(url, domain)) owner = "other";
+  const label = (entry.label ?? "").trim().slice(0, SITEMAP_LABEL_MAX);
+  const out = { ...entry, url, owner, label: label || null, uses: sitemapUses(owner, entry.uses) };
+  if (!out.id) delete out.id;
+  return out;
+}
+function checkSitemaps(list2) {
+  if (list2.length > SITEMAPS_MAX) return `Up to ${SITEMAPS_MAX} sitemaps. Remove one first.`;
+  const seen = /* @__PURE__ */ new Set();
+  for (const s of list2) {
+    const k = s.url.trim().toLowerCase();
+    if (seen.has(k)) return `${s.url} is already in the list.`;
+    seen.add(k);
+  }
+  return null;
+}
+function sitemapCheckLine(check) {
+  if (!check || check.status === "unchecked") return "Checked when you save";
+  if (check.status === "error") return check.error?.trim() || "Couldn't read this sitemap.";
+  const n = check.url_count;
+  const found = n == null ? "Read" : `Found ${n.toLocaleString("en-GB")} ${n === 1 ? "page" : "pages"}`;
+  const at = check.checked_at ? new Date(check.checked_at) : null;
+  const when = at && !Number.isNaN(at.getTime()) ? at.toLocaleDateString("en-GB", { day: "numeric", month: "short", year: "numeric" }) : null;
+  return when ? `${found} \xB7 checked ${when}` : found;
+}
+
 // ../../packages/domain/src/copy/maggie.ts
 var q = (s) => `\u201C${String(s ?? "").slice(0, 120)}\u201D`;
 var named = (title, id) => {
@@ -8391,6 +8461,10 @@ var confirmCopy = {
     en: (a) => `Remove the call-to-action for ${q(a.target_keyword)}.`,
     "zh-Hant": (a) => `\u522A\u9664 ${q(a.target_keyword)} \u7684\u884C\u52D5\u547C\u7C72\u3002`
   },
+  internal_links_set: {
+    en: (a) => Number(a.count) ? `Link each new post to ${a.count} of your latest articles.` : "Stop linking new posts to your other articles.",
+    "zh-Hant": (a) => Number(a.count) ? `\u6BCF\u7BC7\u65B0\u6587\u7AE0\u9023\u7D50\u5230\u4F60\u6700\u65B0\u7684 ${a.count} \u7BC7\u6587\u7AE0\u3002` : "\u65B0\u6587\u7AE0\u4E0D\u518D\u9023\u7D50\u5230\u4F60\u7684\u5176\u4ED6\u6587\u7AE0\u3002"
+  },
   testimonial_upsert: {
     en: (a) => `Save the testimonial from ${a.name}${a.use_in_posts ? " and use testimonials in posts" : ""}.`,
     "zh-Hant": (a) => `\u5132\u5B58 ${a.name} \u7684\u5BA2\u6236\u8A55\u50F9${a.use_in_posts ? "\uFF0C\u4E26\u5728\u6587\u7AE0\u88E1\u4F7F\u7528\u8A55\u50F9" : ""}\u3002`
@@ -8423,6 +8497,22 @@ var confirmCopy = {
     en: (a) => `Remove the competitor ${q(a.name)}.`,
     "zh-Hant": (a) => `\u522A\u9664\u7AF6\u722D\u5C0D\u624B ${q(a.name)}\u3002`
   },
+  sitemap_upsert: {
+    en: (a) => {
+      const whose = { own: "your site's ", competitor: "a competitor's ", other: "another site's " }[a.owner];
+      const label = a.label ? ` (${q(a.label)})` : "";
+      return a.url ? `Save ${whose ?? "the "}sitemap ${a.url}${label}.` : `Change the sitemap${label}: ${keys(a).filter((k) => k !== "id").join(", ")}.`;
+    },
+    "zh-Hant": (a) => {
+      const whose = { own: "\u81EA\u5DF1\u7DB2\u7AD9\u7684", competitor: "\u7AF6\u722D\u5C0D\u624B\u7684", other: "\u5176\u4ED6\u7DB2\u7AD9\u7684" }[a.owner];
+      const label = a.label ? `\uFF08${q(a.label)}\uFF09` : "";
+      return a.url ? `\u5132\u5B58${whose ?? ""} sitemap ${a.url}${label}\u3002` : `\u4FEE\u6539 sitemap${label}\uFF1A${keys(a).filter((k) => k !== "id").join("\u3001")}\u3002`;
+    }
+  },
+  sitemap_remove: {
+    en: (a) => a.url ?? a.id ? `Remove the sitemap ${a.url ?? a.id}.` : "Remove a sitemap.",
+    "zh-Hant": (a) => a.url ?? a.id ? `\u522A\u9664 sitemap ${a.url ?? a.id}\u3002` : "\u522A\u9664\u4E00\u500B sitemap\u3002"
+  },
   brand_research_update: {
     en: (a) => `Update your market notes: ${keys(a).join(", ") || "nothing"}.`,
     "zh-Hant": (a) => `\u66F4\u65B0\u5E02\u5834\u8CC7\u6599\uFF1A${keys(a).join("\u3001") || "\u6C92\u6709"}\u3002`
@@ -8639,8 +8729,8 @@ var confirmCopy = {
   },
   // ---------------------------------------------------------- Marketing skills (docs/26)
   skill_like: {
-    en: (a) => `${a.undo ? "Take back your like on" : "Like"} the skill ${q(a.skill_id)} on cmo.so.`,
-    "zh-Hant": (a) => `${a.undo ? "\u53D6\u6D88\u5C0D" : "\u5728 cmo.so \u8B9A"}\u6280\u80FD ${q(a.skill_id)}${a.undo ? " \u7684\u8B9A" : ""}\u3002`
+    en: (a) => `${a.undo ? "Take back your upvote on" : "Upvote"} the skill ${q(a.skill_id)} on cmo.so.`,
+    "zh-Hant": (a) => `${a.undo ? "\u6536\u56DE\u5C0D" : "\u5728 cmo.so \u6295\u7968\u652F\u6301"}\u6280\u80FD ${q(a.skill_id)}${a.undo ? " \u7684\u652F\u6301\u7968" : ""}\u3002`
   },
   skill_save: {
     en: (a) => `${a.undo ? "Remove" : "Save"} the skill ${q(a.skill_id)} ${a.undo ? "from" : "to"} your saved skills.`,
@@ -9668,6 +9758,24 @@ var brandTools = [
       return { ctas: out.ctas?.map((c) => c.target_keyword) };
     }
   }),
+  tool({
+    name: "internal_links_set",
+    description: "Set how many of the website's own latest articles each new post links to (internal cross-links, picked for the topic; separate from CTAs). 0 turns it off, max 10, default 3.",
+    parameters: {
+      type: "object",
+      properties: { count: { type: "integer", minimum: 0, maximum: 10 } },
+      required: ["count"]
+    },
+    group: "brand",
+    need: write2,
+    risk: "W1",
+    run: async (ctx, { count }) => {
+      const n = Math.round(Number(count));
+      if (!Number.isFinite(n) || n < 0 || n > 10) throw new Error("count must be 0 to 10.");
+      const out = await ws(ctx).updateBrand({ internal_links: { count: n } });
+      return { internal_links: out.internal_links ?? { count: n } };
+    }
+  }),
   tool({
     name: "testimonial_upsert",
     description: "Add a customer testimonial, or change the one from the same person. Only real quotes the user gives (or examples they asked for). use_in_posts turns testimonials on in posts.",
@@ -9857,6 +9965,85 @@ var brandTools = [
       return { found: out.found, suggestions: out.items.map(({ id, name, website }) => ({ id, name, website })) };
     }
   }),
+  tool({
+    name: "sitemap_list",
+    description: "The sitemaps saved in the business profile: the website's own, competitors' and other sites' (industry sites, partners), each with what it is used for (post_ideas = blog post ideas, channel_ideas = social post ideas, internal_links and post_matching = own sitemaps only) and its last check (pages found or the error). Max 20.",
+    parameters: none,
+    group: "brand",
+    need: { resource: "overview", level: "read" },
+    risk: "R0",
+    run: async (ctx) => {
+      const list2 = (await ws(ctx).brand()).sitemaps ?? [];
+      return { max: SITEMAPS_MAX, sitemaps: list2.map(sitemapResult) };
+    }
+  }),
+  tool({
+    name: "sitemap_upsert",
+    description: "Add a sitemap to the business profile, or change one (found by id from sitemap_list, else by url). owner: own (the website's own; its host must be the website or a subdomain, otherwise it is saved as other), competitor, or other. uses: own may have post_ideas, channel_ideas, internal_links, post_matching; competitor/other only post_ideas, channel_ideas; leave out for all allowed. A new sitemap needs url and owner. Only sitemap addresses the user gives or confirms (never guess one). Saving checks the sitemap; an unreachable one is still saved with the error. Max 20.",
+    parameters: {
+      type: "object",
+      properties: {
+        id: { type: "string", description: "The sitemap to change (from sitemap_list)" },
+        url: { type: "string", description: "The sitemap's http(s) address; with id, its new address" },
+        owner: { type: "string", enum: ["own", "competitor", "other"] },
+        label: { type: "string", description: "A short name, up to 80 characters" },
+        uses: {
+          type: "array",
+          items: { type: "string", enum: ["post_ideas", "channel_ideas", "internal_links", "post_matching"] }
+        }
+      }
+    },
+    group: "brand",
+    need: write2,
+    risk: "W1",
+    run: async (ctx, args) => {
+      const list2 = (await ws(ctx).brand()).sitemaps ?? [];
+      const i = findSitemap(list2, args.id, args.id ? void 0 : args.url);
+      if (args.id && i < 0) throw new Error(`No sitemap with id ${args.id}. Use sitemap_list.`);
+      const old = i >= 0 ? list2[i] : void 0;
+      if (!old && (!args.url || !args.owner)) throw new Error("A new sitemap needs url and owner.");
+      const owner = args.owner ?? old?.owner ?? "other";
+      const entry = cleanSitemap(
+        {
+          ...old,
+          url: args.url ?? old?.url ?? "",
+          owner,
+          label: args.label ?? old?.label ?? null,
+          // A new owner without uses gets that owner's defaults.
+          uses: args.uses ?? (args.owner && args.owner !== old?.owner ? [] : old?.uses ?? [])
+        },
+        ctx.domain ?? void 0
+      );
+      if (typeof entry === "string") throw new Error(entry);
+      if (old && sitemapUrl(old.url) !== entry.url) delete entry.check;
+      const next = old ? list2.map((x, n) => n === i ? entry : x) : [...list2, entry];
+      const problem = checkSitemaps(next);
+      if (problem) throw new Error(problem);
+      const saved = (await ws(ctx).updateBrand({ sitemaps: next })).sitemaps ?? next;
+      const mine = saved[findSitemap(saved, void 0, entry.url)];
+      return {
+        saved: mine ? sitemapResult(mine) : sitemapResult(entry),
+        ...(mine?.owner ?? entry.owner) !== owner ? { note: "Not on this website, so it was saved as another site's sitemap (owner other)." } : {},
+        sitemaps: saved.length
+      };
+    }
+  }),
+  tool({
+    name: "sitemap_remove",
+    description: "Remove a sitemap from the business profile (by id from sitemap_list, or by url). Maggie stops reading it; ideas already found stay.",
+    parameters: { type: "object", properties: { id: { type: "string" }, url: { type: "string" } } },
+    group: "brand",
+    need: write2,
+    risk: "W1",
+    run: async (ctx, { id, url }) => {
+      if (!id && !url) throw new Error("Say which sitemap: id or url.");
+      const list2 = (await ws(ctx).brand()).sitemaps ?? [];
+      const i = findSitemap(list2, id, url);
+      if (i < 0) throw new Error(`No sitemap ${id ?? url} was found. Use sitemap_list.`);
+      const saved = (await ws(ctx).updateBrand({ sitemaps: list2.filter((_, n) => n !== i) })).sitemaps ?? [];
+      return { removed: list2[i]?.url, sitemaps: saved.map((s) => s.url) };
+    }
+  }),
   tool({
     name: "brand_research_update",
     description: "Change the profile's market notes: market_research (text), additional_information (anything else Maggie should know) or the SWOT list (each {name: Strengths|Weaknesses|Opportunities|Threats, description}). A list replaces the whole list.",
@@ -9992,6 +10179,22 @@ function brandGaps(b) {
   check("industries", b.industries, "the industry, for examples and wording");
   return { complete: gaps.length === 0, gaps };
 }
+function findSitemap(list2, id, url) {
+  if (id) return list2.findIndex((s) => s.id === id);
+  const u = url ? (sitemapUrl(url) ?? url).toLowerCase() : "";
+  return u ? list2.findIndex((s) => (sitemapUrl(s.url) ?? s.url).toLowerCase() === u) : -1;
+}
+function sitemapResult(s) {
+  return {
+    id: s.id ?? null,
+    url: s.url,
+    owner: s.owner,
+    label: s.label ?? null,
+    uses: s.uses,
+    check: s.check?.status ?? "unchecked",
+    status: sitemapCheckLine(s.check)
+  };
+}
 
 // ../../packages/tools/src/feedback.ts
 var account = { resource: "account", level: "read" };
@@ -10746,7 +10949,7 @@ var ID = { type: "string", description: "The skill id, like cmo-ad-creative" };
 var skillTools = [
   tool({
     name: "skills_search",
-    description: "Search cmo.so's open library of marketing skills (step-by-step methods an AI agent follows, free and MIT licensed): returns matching skills with their summary, likes and page. Use it when the user asks how to do a marketing job, wants a playbook or template, or asks which skills exist. Empty query: the most useful ones and the categories.",
+    description: "Search cmo.so's open library of marketing skills (step-by-step methods an AI agent follows, free and MIT licensed): returns matching skills with their summary, vote score and page. Use it when the user asks how to do a marketing job, wants a playbook or template, or asks which skills exist. Empty query: the most useful ones and the categories.",
     parameters: {
       type: "object",
       properties: {
@@ -10770,7 +10973,13 @@ var skillTools = [
       return {
         total_in_library: r.total,
         ...a.query ? {} : { categories: r.categories.map((c) => `${c.id} (${c.count})`) },
-        skills: r.skills.map((s) => ({ id: s.id, name: s.name, summary: s.summary, likes: s.likes, page: s.url }))
+        skills: r.skills.map((s) => ({
+          id: s.id,
+          name: s.name,
+          summary: s.summary,
+          score: s.score ?? s.likes,
+          page: s.url
+        }))
       };
     }
   }),
@@ -10789,7 +10998,7 @@ var skillTools = [
         name: s.name,
         summary: s.summary,
         page: s.url,
-        likes: s.likes,
+        score: s.score ?? s.likes,
         saves: s.saves,
         uses_tools: s.mcp_tools,
         pairs_with: s.pairs_with,
@@ -10801,10 +11010,10 @@ var skillTools = [
   }),
   tool({
     name: "skill_like",
-    description: "Like a skill in the cmo.so library for the user (or take the like back with undo). Likes help the library decide what to keep improving. Only when the user asks.",
+    description: "Upvote a skill in the cmo.so library for the user (or take the upvote back with undo). Votes help the library decide what to keep improving. Only when the user asks.",
     parameters: {
       type: "object",
-      properties: { skill_id: ID, undo: { type: "boolean", description: "true takes the like back" } },
+      properties: { skill_id: ID, undo: { type: "boolean", description: "true takes the upvote back" } },
       required: ["skill_id"]
     },
     group: "account",
@@ -10813,12 +11022,12 @@ var skillTools = [
     idempotent: true,
     run: async (ctx, a) => {
       const r = await ctx.api.skills.react(String(a.skill_id), "like", !a.undo);
-      return { skill_id: r.item, liked: r.liked, likes: r.counts.likes };
+      return { skill_id: r.item, upvoted: r.liked, score: r.counts.score ?? r.counts.likes };
     }
   }),
   tool({
     name: "skill_save",
-    description: "Save a skill to the user's saved skills on cmo.so (or remove it with undo), to find it again at cmo.so/skills/saved or with skills_saved_list.",
+    description: "Save a skill to the user's saved skills on cmo.so (or remove it with undo), to find it again under Saved at cmo.so/skills or with skills_saved_list.",
     parameters: {
       type: "object",
       properties: { skill_id: ID, undo: { type: "boolean", description: "true removes it from saved" } },
@@ -10851,7 +11060,7 @@ var skillTools = [
   }),
   tool({
     name: "skill_submit",
-    description: "Suggest a public open-source GitHub repo for cmo.so's skill library. Maggie researches it within minutes and decides: add a new skill, improve an existing one, keep it as a candidate that needs 10 likes in 30 days, or decline (licence first: permissive licences can be adapted, copyleft only inspires, no licence is declined). 3 suggestions a day. Follow up with skill_submissions_list.",
+    description: "Suggest a public open-source GitHub repo for cmo.so's skill library. Maggie researches it within minutes and decides: add a new skill, improve an existing one, keep it as a candidate that needs a vote score of 10 in 30 days, or decline (licence first: permissive licences can be adapted, copyleft only inspires, no licence is declined). 3 suggestions a day. Follow up with skill_submissions_list.",
     parameters: {
       type: "object",
       properties: {
@@ -22393,7 +22602,9 @@ var OPEN_WORLD = /* @__PURE__ */ new Set([
   "seo_audit_run",
   "ai_visibility_prompt_check",
   "idea_add",
-  "competitor_suggestions_find"
+  "competitor_suggestions_find",
+  // Saving makes CMO.so fetch the sitemap from its website.
+  "sitemap_upsert"
 ]);
 var OVERWRITES = /* @__PURE__ */ new Set([
   "ai_visibility_keywords_set",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@cmo-so/mcp",
-	"version": "0.7.5",
+	"version": "0.7.7",
 	"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",