@productmaker/mcp 1.9.0 → 1.11.0

package/dist/http.js

@@ -113,7 +113,7 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "1.9.0";
+var MCP_VERSION = "1.11.0";
 
 // src/tools/tasks.ts
 import { z as z2 } from "zod";
@@ -405,6 +405,11 @@ var LandingStrategyEnum = z.enum([
   "offer_value",
   "lifestyle_identity"
 ]);
+var LandingImageFormatEnum = z.enum([
+  "9:16",
+  "4:5",
+  "1:1"
+]);
 var VideoPresetEnum = z.enum([
   "auto",
   "ugc_dynamic",
@@ -1207,7 +1212,8 @@ var CreateProductTaskInput = z2.object({
   competitorScanEnabled: z2.boolean().optional().describe("Opcional. Si true (default), el sistema analiza ads de competencia en Meta Ad Library y enriquece los \xE1ngulos generados con hooks y painPoints validados por el mercado (\u2248$0.20-0.48 extra por task \u2014 var\xEDa con cu\xE1ntas transcripciones de video se capturen). Si false, el pipeline genera \xE1ngulos sin esa se\xF1al \u2014 usa esto SOLO si el usuario ya tiene su propia investigaci\xF3n de mercado o quiere ahorrar costos en productos muy nicho sin presencia en Meta. Default true."),
   brandId: z2.string().uuid().optional().describe("Opcional. ID de una marca del usuario; si se env\xEDa, el sistema usa su voz, colores y persona para enriquecer los outputs generados."),
   creativeDirection: z2.string().max(500).optional().describe('Opcional. Direcci\xF3n creativa en texto libre (colores, mood, estilo) que aplica a los outputs de IMAGEN y LANDING (no al video \u2014 el estilo/ambiente del video se dirige con scriptNotes). M\xC1XIMA PRIORIDAD: anula marca, colores y estilo por defecto. Ej. "amarillo y azul, minimalista". M\xE1x 500 caracteres.'),
-  landingStrategy: LandingStrategyEnum.default("classic").describe('Opcional. Estructura de la landing cl\xE1sica cuando landing est\xE1 entre outputs: "classic" (estructura original probada y recomendada; default del primer rollout), "auto" (la IA decide; experimental), "pain_solution", "social_proof", "benefits_clarity", "offer_value" o "lifestyle_identity". Default "classic".')
+  landingStrategy: LandingStrategyEnum.default("classic").describe('Opcional. Estructura de la landing cl\xE1sica cuando landing est\xE1 entre outputs: "classic" (estructura original probada y recomendada; default del primer rollout), "auto" (la IA decide; experimental), "pain_solution", "social_proof", "benefits_clarity", "offer_value" o "lifestyle_identity". Default "classic".'),
+  landingImageFormat: LandingImageFormatEnum.default("9:16").describe('Opcional. Formato/relaci\xF3n de aspecto de las im\xE1genes de la landing cl\xE1sica cuando landing est\xE1 entre outputs: "9:16" (vertical, por defecto), "4:5" (vertical compacto para feed) o "1:1" (cuadrado). Default "9:16".')
 }).strict();
 var GetTaskStatusInput = z2.object({
   taskId: z2.string().min(1),
@@ -1337,6 +1343,7 @@ function registerTaskTools(server, api, { proxyBaseUrl = null, transport = "http
         "options.brandId": input.brandId,
         "options.creativeDirection": input.creativeDirection,
         "options.landingStrategy": input.landingStrategy,
+        "options.landingImageFormat": input.landingImageFormat,
         url: input.productUrl
       });
       const r = await api.postMultipart("/v1/ingest", {
@@ -1571,7 +1578,8 @@ var LandingInput = z3.object({
   competitorScanEnabled: CreativeRefs.competitorScanEnabled,
   brandId: CreativeRefs.brandId,
   creativeDirection: CreativeRefs.creativeDirection,
-  landingStrategy: LandingStrategyEnum.default("classic").describe('Opcional. Estructura de la landing cl\xE1sica: "classic" (estructura original probada y recomendada; default del primer rollout), "auto" (la IA decide; experimental), "pain_solution" (problema\u2192soluci\xF3n), "social_proof" (confianza y evidencia), "benefits_clarity" (beneficios claros), "offer_value" (promoci\xF3n/valor) o "lifestyle_identity" (estilo de vida). Default "classic".')
+  landingStrategy: LandingStrategyEnum.default("classic").describe('Opcional. Estructura de la landing cl\xE1sica: "classic" (estructura original probada y recomendada; default del primer rollout), "auto" (la IA decide; experimental), "pain_solution" (problema\u2192soluci\xF3n), "social_proof" (confianza y evidencia), "benefits_clarity" (beneficios claros), "offer_value" (promoci\xF3n/valor) o "lifestyle_identity" (estilo de vida). Default "classic".'),
+  landingImageFormat: LandingImageFormatEnum.default("9:16").describe('Opcional. Formato/relaci\xF3n de aspecto de las im\xE1genes de la landing cl\xE1sica: "9:16" (vertical, por defecto), "4:5" (vertical compacto para feed) o "1:1" (cuadrado). Default "9:16".')
 });
 function registerCreativeTools(server, api, { transport = "http" } = {}) {
   server.tool("generate_video_creative", 'Genera UN video creativo independiente. Devuelve un taskId.\n\nREQUERIDOS: images (array de 1-5 fotos), title, primaryAngle, language, country, aspectRatio.\n\nANTES de invocar, PREG\xDANTALE al usuario por price y offer si no los mencion\xF3 \u2014 son los inputs de mayor impacto en conversi\xF3n y nunca debes asumirlos. NO defaultes country/language desde el contexto: preg\xFAntale expl\xEDcitamente. Si el usuario te dice "t\xFA elige" para price/offer, om\xEDtelos.\n\nOTROS OPCIONALES (puedes invocar sin ellos y dejar que la IA elija defaults sensatos): durationSeconds (m\xE1x 15), videoPreset (tipo/narrativa del video), features, cta, scriptNotes (dirige el guion Y el ambiente/escenario/est\xE9tica del video, ej. "en una playa, opulento").\n\nESTILO: v\xEDa MCP todos los videos se generan en estilo "Realista" (render \xFAnico de 15s con audio nativo). El estilo "Multiescena" (30s, multi-toma) NO est\xE1 disponible por MCP por su costo \u2014 si el usuario lo pide, dile que lo genere desde la web.\n\nGUION: el usuario NO escribe el guion desde cero \u2014 la IA lo redacta. Si quiere REVISARLO/EDITARLO antes de renderizar (igual que en la web), pasa `pauseForVideoScriptReview: true`; cuando la tarea quede pausada, usa get_video_script para leer las escenas, ofr\xE9celas al usuario, y llama approve_video_script con las ediciones. Para dirigir el guion ANTES de generar (sin pausar), usa scriptNotes.', VideoInput.shape, async (input) => {
@@ -1727,7 +1735,18 @@ var ShopifyInput = z6.object({
   /** ASK THE USER before setting: "¿Tu producto tiene variantes (talla, color, etc.)?".
   *  When true, the landing renders variant-picker pills; when false, it ships
   *  a single-option product page. Defaults to false. */
-  showVariantPicker: z6.boolean().optional()
+  showVariantPicker: z6.boolean().optional(),
+  /** Default `auto` updates the product previously published for this task and
+  * shop. Use `existing` with targetProductId to choose another product, or
+  * `new` only when the user explicitly wants a duplicate/new listing. */
+  publicationMode: z6.enum([
+    "auto",
+    "existing",
+    "new"
+  ]).optional(),
+  /** Shopify product GID, numeric id, or admin product URL. Required when
+  * publicationMode is `existing`. */
+  targetProductId: z6.string().trim().min(1).max(300).optional()
 });
 var McpCampaignConfig = z6.object({
   dailyBudgetUsd: z6.number().positive().optional(),
@@ -1765,8 +1784,19 @@ var TikTokInput = z6.object({
   primaryText: z6.string().trim().min(1).max(500).optional()
 });
 function registerPublishTools(server, api) {
-  server.tool("publish_to_shopify", "Publica la landing y producto generados en una tienda Shopify conectada. Precondici\xF3n: la tarea debe estar en status='complete' \u2014 usa `get_task_status` antes. ANTES de llamar preg\xFAntale al usuario \"\xBFTu producto tiene variantes (talla, color, etc.)?\" y pasa `showVariantPicker: true` si responde que s\xED \u2014 eso renderiza los pills de variantes en la landing. Por defecto publica TODAS las im\xE1genes que la tarea gener\xF3 para la landing; pasa `numLandingImages` s\xF3lo si el usuario te pide menos. La respuesta es markdown con el link a la landing y al producto.", ShopifyInput.shape, async (input) => {
+  server.tool("publish_to_shopify", "Publica o actualiza la landing en una tienda Shopify conectada. Precondici\xF3n: la tarea debe estar en status='complete' \u2014 usa `get_task_status` antes. Por defecto `publicationMode=auto`: si esta tarea ya fue publicada en esa tienda, actualiza ESE MISMO producto y conserva URL, precio, variantes, inventario y SKU; si no, crea uno. Usa `existing` + `targetProductId` cuando el usuario elija otro producto y `new` s\xF3lo si pide crear uno nuevo. ANTES de llamar preg\xFAntale \"\xBFTu producto tiene variantes (talla, color, etc.)?\" y pasa `showVariantPicker: true` si responde que s\xED. Por defecto publica TODAS las im\xE1genes generadas; pasa `numLandingImages` s\xF3lo si el usuario pide menos. La respuesta es markdown con el link a la landing y al producto.", ShopifyInput.shape, async (input) => {
     try {
+      if (input.publicationMode === "existing" && !input.targetProductId) {
+        return {
+          isError: true,
+          content: [
+            {
+              type: "text",
+              text: "targetProductId is required when publicationMode is existing"
+            }
+          ]
+        };
+      }
       const variantIndex = input.variantIndex ?? 0;
       const availableImages = await fetchLandingImageCount(api, input.taskId);
       const effectiveAvailable = availableImages > 0 ? availableImages : 3;
@@ -1780,7 +1810,9 @@ function registerPublishTools(server, api) {
       const r = await api.postJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/publish/shopify`, {
         shopDomain: input.shopDomain,
         selectedLandingImages,
-        showVariantPicker: input.showVariantPicker
+        showVariantPicker: input.showVariantPicker,
+        publicationMode: input.publicationMode,
+        targetProductId: input.targetProductId
       });
       return renderShopifyPublishMarkdown(r);
     } catch (e) {

package/dist/stdio.js

@@ -110,7 +110,7 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "1.9.0";
+var MCP_VERSION = "1.11.0";
 
 // src/tools/tasks.ts
 import { z as z2 } from "zod";
@@ -402,6 +402,11 @@ var LandingStrategyEnum = z.enum([
   "offer_value",
   "lifestyle_identity"
 ]);
+var LandingImageFormatEnum = z.enum([
+  "9:16",
+  "4:5",
+  "1:1"
+]);
 var VideoPresetEnum = z.enum([
   "auto",
   "ugc_dynamic",
@@ -1163,7 +1168,8 @@ var CreateProductTaskInput = z2.object({
   competitorScanEnabled: z2.boolean().optional().describe("Opcional. Si true (default), el sistema analiza ads de competencia en Meta Ad Library y enriquece los \xE1ngulos generados con hooks y painPoints validados por el mercado (\u2248$0.20-0.48 extra por task \u2014 var\xEDa con cu\xE1ntas transcripciones de video se capturen). Si false, el pipeline genera \xE1ngulos sin esa se\xF1al \u2014 usa esto SOLO si el usuario ya tiene su propia investigaci\xF3n de mercado o quiere ahorrar costos en productos muy nicho sin presencia en Meta. Default true."),
   brandId: z2.string().uuid().optional().describe("Opcional. ID de una marca del usuario; si se env\xEDa, el sistema usa su voz, colores y persona para enriquecer los outputs generados."),
   creativeDirection: z2.string().max(500).optional().describe('Opcional. Direcci\xF3n creativa en texto libre (colores, mood, estilo) que aplica a los outputs de IMAGEN y LANDING (no al video \u2014 el estilo/ambiente del video se dirige con scriptNotes). M\xC1XIMA PRIORIDAD: anula marca, colores y estilo por defecto. Ej. "amarillo y azul, minimalista". M\xE1x 500 caracteres.'),
-  landingStrategy: LandingStrategyEnum.default("classic").describe('Opcional. Estructura de la landing cl\xE1sica cuando landing est\xE1 entre outputs: "classic" (estructura original probada y recomendada; default del primer rollout), "auto" (la IA decide; experimental), "pain_solution", "social_proof", "benefits_clarity", "offer_value" o "lifestyle_identity". Default "classic".')
+  landingStrategy: LandingStrategyEnum.default("classic").describe('Opcional. Estructura de la landing cl\xE1sica cuando landing est\xE1 entre outputs: "classic" (estructura original probada y recomendada; default del primer rollout), "auto" (la IA decide; experimental), "pain_solution", "social_proof", "benefits_clarity", "offer_value" o "lifestyle_identity". Default "classic".'),
+  landingImageFormat: LandingImageFormatEnum.default("9:16").describe('Opcional. Formato/relaci\xF3n de aspecto de las im\xE1genes de la landing cl\xE1sica cuando landing est\xE1 entre outputs: "9:16" (vertical, por defecto), "4:5" (vertical compacto para feed) o "1:1" (cuadrado). Default "9:16".')
 }).strict();
 var GetTaskStatusInput = z2.object({
   taskId: z2.string().min(1),
@@ -1293,6 +1299,7 @@ function registerTaskTools(server, api, { proxyBaseUrl = null, transport = "http
         "options.brandId": input.brandId,
         "options.creativeDirection": input.creativeDirection,
         "options.landingStrategy": input.landingStrategy,
+        "options.landingImageFormat": input.landingImageFormat,
         url: input.productUrl
       });
       const r = await api.postMultipart("/v1/ingest", {
@@ -1527,7 +1534,8 @@ var LandingInput = z3.object({
   competitorScanEnabled: CreativeRefs.competitorScanEnabled,
   brandId: CreativeRefs.brandId,
   creativeDirection: CreativeRefs.creativeDirection,
-  landingStrategy: LandingStrategyEnum.default("classic").describe('Opcional. Estructura de la landing cl\xE1sica: "classic" (estructura original probada y recomendada; default del primer rollout), "auto" (la IA decide; experimental), "pain_solution" (problema\u2192soluci\xF3n), "social_proof" (confianza y evidencia), "benefits_clarity" (beneficios claros), "offer_value" (promoci\xF3n/valor) o "lifestyle_identity" (estilo de vida). Default "classic".')
+  landingStrategy: LandingStrategyEnum.default("classic").describe('Opcional. Estructura de la landing cl\xE1sica: "classic" (estructura original probada y recomendada; default del primer rollout), "auto" (la IA decide; experimental), "pain_solution" (problema\u2192soluci\xF3n), "social_proof" (confianza y evidencia), "benefits_clarity" (beneficios claros), "offer_value" (promoci\xF3n/valor) o "lifestyle_identity" (estilo de vida). Default "classic".'),
+  landingImageFormat: LandingImageFormatEnum.default("9:16").describe('Opcional. Formato/relaci\xF3n de aspecto de las im\xE1genes de la landing cl\xE1sica: "9:16" (vertical, por defecto), "4:5" (vertical compacto para feed) o "1:1" (cuadrado). Default "9:16".')
 });
 function registerCreativeTools(server, api, { transport = "http" } = {}) {
   server.tool("generate_video_creative", 'Genera UN video creativo independiente. Devuelve un taskId.\n\nREQUERIDOS: images (array de 1-5 fotos), title, primaryAngle, language, country, aspectRatio.\n\nANTES de invocar, PREG\xDANTALE al usuario por price y offer si no los mencion\xF3 \u2014 son los inputs de mayor impacto en conversi\xF3n y nunca debes asumirlos. NO defaultes country/language desde el contexto: preg\xFAntale expl\xEDcitamente. Si el usuario te dice "t\xFA elige" para price/offer, om\xEDtelos.\n\nOTROS OPCIONALES (puedes invocar sin ellos y dejar que la IA elija defaults sensatos): durationSeconds (m\xE1x 15), videoPreset (tipo/narrativa del video), features, cta, scriptNotes (dirige el guion Y el ambiente/escenario/est\xE9tica del video, ej. "en una playa, opulento").\n\nESTILO: v\xEDa MCP todos los videos se generan en estilo "Realista" (render \xFAnico de 15s con audio nativo). El estilo "Multiescena" (30s, multi-toma) NO est\xE1 disponible por MCP por su costo \u2014 si el usuario lo pide, dile que lo genere desde la web.\n\nGUION: el usuario NO escribe el guion desde cero \u2014 la IA lo redacta. Si quiere REVISARLO/EDITARLO antes de renderizar (igual que en la web), pasa `pauseForVideoScriptReview: true`; cuando la tarea quede pausada, usa get_video_script para leer las escenas, ofr\xE9celas al usuario, y llama approve_video_script con las ediciones. Para dirigir el guion ANTES de generar (sin pausar), usa scriptNotes.', VideoInput.shape, async (input) => {
@@ -1683,7 +1691,18 @@ var ShopifyInput = z6.object({
   /** ASK THE USER before setting: "¿Tu producto tiene variantes (talla, color, etc.)?".
   *  When true, the landing renders variant-picker pills; when false, it ships
   *  a single-option product page. Defaults to false. */
-  showVariantPicker: z6.boolean().optional()
+  showVariantPicker: z6.boolean().optional(),
+  /** Default `auto` updates the product previously published for this task and
+  * shop. Use `existing` with targetProductId to choose another product, or
+  * `new` only when the user explicitly wants a duplicate/new listing. */
+  publicationMode: z6.enum([
+    "auto",
+    "existing",
+    "new"
+  ]).optional(),
+  /** Shopify product GID, numeric id, or admin product URL. Required when
+  * publicationMode is `existing`. */
+  targetProductId: z6.string().trim().min(1).max(300).optional()
 });
 var McpCampaignConfig = z6.object({
   dailyBudgetUsd: z6.number().positive().optional(),
@@ -1721,8 +1740,19 @@ var TikTokInput = z6.object({
   primaryText: z6.string().trim().min(1).max(500).optional()
 });
 function registerPublishTools(server, api) {
-  server.tool("publish_to_shopify", "Publica la landing y producto generados en una tienda Shopify conectada. Precondici\xF3n: la tarea debe estar en status='complete' \u2014 usa `get_task_status` antes. ANTES de llamar preg\xFAntale al usuario \"\xBFTu producto tiene variantes (talla, color, etc.)?\" y pasa `showVariantPicker: true` si responde que s\xED \u2014 eso renderiza los pills de variantes en la landing. Por defecto publica TODAS las im\xE1genes que la tarea gener\xF3 para la landing; pasa `numLandingImages` s\xF3lo si el usuario te pide menos. La respuesta es markdown con el link a la landing y al producto.", ShopifyInput.shape, async (input) => {
+  server.tool("publish_to_shopify", "Publica o actualiza la landing en una tienda Shopify conectada. Precondici\xF3n: la tarea debe estar en status='complete' \u2014 usa `get_task_status` antes. Por defecto `publicationMode=auto`: si esta tarea ya fue publicada en esa tienda, actualiza ESE MISMO producto y conserva URL, precio, variantes, inventario y SKU; si no, crea uno. Usa `existing` + `targetProductId` cuando el usuario elija otro producto y `new` s\xF3lo si pide crear uno nuevo. ANTES de llamar preg\xFAntale \"\xBFTu producto tiene variantes (talla, color, etc.)?\" y pasa `showVariantPicker: true` si responde que s\xED. Por defecto publica TODAS las im\xE1genes generadas; pasa `numLandingImages` s\xF3lo si el usuario pide menos. La respuesta es markdown con el link a la landing y al producto.", ShopifyInput.shape, async (input) => {
     try {
+      if (input.publicationMode === "existing" && !input.targetProductId) {
+        return {
+          isError: true,
+          content: [
+            {
+              type: "text",
+              text: "targetProductId is required when publicationMode is existing"
+            }
+          ]
+        };
+      }
       const variantIndex = input.variantIndex ?? 0;
       const availableImages = await fetchLandingImageCount(api, input.taskId);
       const effectiveAvailable = availableImages > 0 ? availableImages : 3;
@@ -1736,7 +1766,9 @@ function registerPublishTools(server, api) {
       const r = await api.postJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/publish/shopify`, {
         shopDomain: input.shopDomain,
         selectedLandingImages,
-        showVariantPicker: input.showVariantPicker
+        showVariantPicker: input.showVariantPicker,
+        publicationMode: input.publicationMode,
+        targetProductId: input.targetProductId
       });
       return renderShopifyPublishMarkdown(r);
     } catch (e) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@productmaker/mcp",
-  "version": "1.9.0",
+  "version": "1.11.0",
   "type": "module",
   "private": false,
   "description": "Product Maker MCP server — connect Claude Desktop, Claude Code, ChatGPT, or Gemini to Product Maker AI to generate dropshipping landing pages, UGC videos, and ad creatives, and publish to Shopify and Meta Ads from your AI assistant.",