aimakeall-mcp 0.3.0 → 0.4.0

package/README.md

@@ -16,7 +16,7 @@ Claude Code·Codex 같은 MCP 클라이언트에서 자연어로 AImakeAll 영
   "mcpServers": {
     "aimakeall": {
       "command": "npx",
-      "args": ["-y", "aimakeall-mcp@0.3.0"],
+      "args": ["-y", "aimakeall-mcp@0.4.0"],
       "env": { "AIMAKEALL_PAT": "aio_pat_..." }
     }
   }

package/lib/cloud-tools.mjs

@@ -14,6 +14,7 @@ import {
   fileToDataUrl,
   fileToImagePayload,
   guessMimeType,
+  saveExportBuffer,
   saveMediaBuffer,
   savePayloadHandle,
   SERVER_JSON_BODY_LIMIT_BYTES,
@@ -46,6 +47,26 @@ function decodeHeaderValue(value) {
   }
 }
 
+// 상품 이미지 URL 클라이언트 가드 — 서버가 1차 필터하지만 이 코드는 사용자 PC 에서
+// 돌므로, 악성 페이지가 심은 내부망 URL(127.0.0.1:9876 컴패니언 등) fetch 를 이중 차단.
+function isSafePublicImageUrl(rawUrl) {
+  try {
+    const parsed = new URL(String(rawUrl || ""));
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") return false;
+    const host = parsed.hostname.toLowerCase();
+    if (!host || host === "localhost" || host.endsWith(".localhost") || host.endsWith(".local") || host.endsWith(".internal")) return false;
+    if (host.includes(":") || host.startsWith("[")) return false; // IPv6 리터럴은 스킵 (이미지 CDN 에 불필요)
+    if (/^\d{1,3}(\.\d{1,3}){3}$/.test(host)) {
+      const [a, b] = host.split(".").map(Number);
+      if (a === 0 || a === 10 || a === 127 || (a === 100 && b >= 64 && b <= 127) || (a === 169 && b === 254)
+        || (a === 172 && b >= 16 && b <= 31) || (a === 192 && b === 168) || a >= 224) return false;
+    }
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 // 실측 mp3 길이(초) — 파싱 실패 시에만 CBR-128 근사로 폴백.
 function audioDurationSecFromFile(filePath) {
   try {
@@ -165,6 +186,83 @@ export function registerCloudTools(server, config, api) {
     }),
   );
 
+  server.tool(
+    "research_product",
+    "상품 링크로 리뷰 기반 시장조사를 합니다: 구매자 불만 TOP3(근거 리뷰 인용)·첫 3초 후킹 패턴·경쟁 광고 공백·핵심 USP·금지 표현. 결과의 planBrief는 plan_commerce_video의 researchBrief로, productImagePaths는 productImagePaths로 그대로 이어가세요. 사이트가 서버 접근을 차단하면(fetchBlocked 안내) 에이전트가 직접 상품 페이지·리뷰를 읽어 pageText/reviewsText로 다시 호출하세요.",
+    {
+      productUrl: z.string().optional().describe("상품 페이지 URL (아마존·쇼핑몰 등)"),
+      productName: z.string().optional().describe("상품명 (URL 없이 텍스트만 넘길 때)"),
+      pageText: z.string().optional().describe("에이전트가 직접 읽은 상품 페이지 텍스트 (봇 차단 폴백)"),
+      reviewsText: z.string().optional().describe("에이전트가 수집한 구매 후기 텍스트 (봇 차단 폴백)"),
+      downloadImages: z.boolean().optional().describe("기본 true — 상품 이미지를 로컬 저장해 plan_commerce_video용 경로 반환"),
+    },
+    wrapCloudHandler(config, async ({ productUrl = "", productName = "", pageText = "", reviewsText = "", downloadImages = true }) => {
+      if (!productUrl.trim() && !pageText.trim() && !reviewsText.trim()) {
+        return textResult("productUrl 또는 pageText/reviewsText 중 하나는 필요합니다.", { isError: true });
+      }
+      const payload = await api.request("/api/tracker/commerce/product-research", {
+        body: { pageText, productName, reviewsText, url: productUrl },
+        method: "POST",
+        timeoutMs: 120_000,
+      });
+      if (!payload?.ok) {
+        return textResult(
+          `리서치 자료를 얻지 못했습니다: ${payload?.error || "자료 없음"}\n${payload?.guidance || ""}`,
+          { isError: true },
+        );
+      }
+      const productImagePaths = [];
+      if (downloadImages) {
+        const EXT_BY_SUBTYPE = { jpeg: "jpg", jpg: "jpg", png: "png", webp: "webp" };
+        for (const imageUrl of (Array.isArray(payload?.product?.imageUrls) ? payload.product.imageUrls : []).slice(0, 5)) {
+          if (!isSafePublicImageUrl(imageUrl)) continue;
+          try {
+            // redirect 미추적 — CDN 이 내부 주소로 리다이렉트시키는 우회 차단.
+            const res = await fetch(imageUrl, { redirect: "manual", signal: AbortSignal.timeout(30_000) });
+            if (!res.ok) continue;
+            const contentType = String(res.headers.get("content-type") || "").toLowerCase();
+            const subtype = contentType.startsWith("image/") ? contentType.slice(6).split(";")[0].trim() : "";
+            const ext = EXT_BY_SUBTYPE[subtype];
+            if (!ext) continue; // 이미지가 아니거나(HTML/SVG 등) 미지원 포맷
+            // 스트리밍 캡 — 전체 버퍼링 전에 8MB 에서 중단.
+            const parts = [];
+            let received = 0;
+            let tooLarge = false;
+            for await (const chunk of res.body) {
+              const piece = Buffer.from(chunk);
+              received += piece.length;
+              if (received > 8 * 1024 * 1024) {
+                tooLarge = true;
+                break;
+              }
+              parts.push(piece);
+            }
+            if (tooLarge || !received) continue;
+            const saved = saveMediaBuffer(config.stateDir, `product-${productImagePaths.length + 1}.${ext}`, Buffer.concat(parts));
+            productImagePaths.push(saved.filePath);
+          } catch {
+            // 이미지 한 장 실패는 무시
+          }
+        }
+      }
+      return jsonResult({
+        fetchBlocked: payload?.fetchBlocked || false,
+        next: productImagePaths.length
+          ? "plan_commerce_video에 productImagePaths와 researchBrief(planBrief)를 그대로 넘기세요."
+          : "상품 이미지를 확보하지 못했습니다 — 에이전트가 상품 사진을 로컬에 저장해 그 경로로 plan_commerce_video를 호출하세요 (researchBrief는 planBrief 사용).",
+        planBrief: payload?.planBrief,
+        product: {
+          imageCount: (Array.isArray(payload?.product?.imageUrls) ? payload.product.imageUrls : []).length,
+          name: payload?.product?.name,
+          price: payload?.product?.price,
+          reviewCount: payload?.product?.reviewCount,
+        },
+        productImagePaths,
+        research: payload?.research,
+      });
+    }),
+  );
+
   server.tool(
     "plan_commerce_video",
     "제품 홍보 영상 기획을 생성합니다. 제품 사진 파일 경로가 최소 1장 필요합니다 (이 PC의 로컬 경로).",
@@ -177,8 +275,9 @@ export function registerCloudTools(server, config, api) {
       tone: z.string().optional().describe("기본 '자동 추천'"),
       categoryId: z.string().optional().describe("기본 ecommerce"),
       sceneCount: z.number().int().min(1).max(12).optional().describe("기본 6"),
+      researchBrief: z.string().optional().describe("research_product 결과의 planBrief — 불만·후킹·경쟁공백이 기획에 반영됨"),
     },
-    wrapCloudHandler(config, async ({ productName, productImagePaths, modelImagePath = "", description = "", targetCustomer = "", tone = "자동 추천", categoryId = "ecommerce", sceneCount = 6 }) => {
+    wrapCloudHandler(config, async ({ productName, productImagePaths, modelImagePath = "", description = "", targetCustomer = "", tone = "자동 추천", categoryId = "ecommerce", sceneCount = 6, researchBrief = "" }) => {
       // 확장자 검증(임의 파일 업로드 차단) + 합산 크기 예산(서버 413 사전 차단).
       for (const filePath of productImagePaths) assertAllowedInputFile(filePath, ALLOWED_IMAGE_EXTS, { kind: "이미지" });
       if (modelImagePath) assertAllowedInputFile(modelImagePath, ALLOWED_IMAGE_EXTS, { kind: "모델 이미지" });
@@ -192,6 +291,7 @@ export function registerCloudTools(server, config, api) {
           operationId: createUsageEventId("commerce-plan"),
           productImages: productImagePaths.map((filePath) => fileToImagePayload(filePath)),
           productName,
+          researchBrief,
           sceneCount,
           selectedCharacters: [],
           skillOverride: null,
@@ -1252,30 +1352,33 @@ export function registerCloudTools(server, config, api) {
         for (const image of Array.isArray(result.lifestyleImages) ? result.lifestyleImages : []) {
           const url = String(image?.url || "");
           if (!url) continue;
+          // HTML 이 실제로 참조하는 컷만 받는다 — 조립에서 빠진 컷을 받아 저장하면
+          // 정리되지 않는 exports/ 에 고아 파일이 영구히 쌓인다.
+          const escaped = escapeHtml(url);
+          if (!html.includes(url) && !html.includes(escaped)) continue;
           try {
             const res = await fetch(url, { signal: AbortSignal.timeout(60_000) });
             if (!res.ok) continue;
             const buf = Buffer.from(await res.arrayBuffer());
             const ext = String(res.headers.get("content-type") || "").includes("png") ? "png" : "jpg";
-            const saved = saveMediaBuffer(config.stateDir, `pdp-image-${image?.idx ?? savedImages.length + 1}.${ext}`, buf);
+            const saved = saveExportBuffer(config.stateDir, `pdp-image-${image?.idx ?? savedImages.length + 1}.${ext}`, buf);
             // HTML 은 같은 디렉터리에 저장되므로 상대경로 치환으로 자립형 유지.
             const local = `./${path.basename(saved.filePath)}`;
-            const before = html;
-            html = html.split(url).join(local).split(escapeHtml(url)).join(local);
-            if (html !== before) savedImages.push(saved.filePath);
+            html = html.split(url).join(local).split(escaped).join(local);
+            savedImages.push(saved.filePath);
           } catch {
             // 다운로드 실패한 컷은 원격 URL 유지
           }
         }
       }
-      const savedHtml = saveMediaBuffer(config.stateDir, "pdp.html", Buffer.from(html, "utf8"), { contentType: "text/html" });
+      const savedHtml = saveExportBuffer(config.stateDir, "pdp.html", Buffer.from(html, "utf8"), { contentType: "text/html" });
       return jsonResult({
         analysis: trimAnalysis(result.analysis),
         heroHeadline: result?.copy?.heroHeadline,
         htmlPath: savedHtml.filePath,
         imageCount: (Array.isArray(result.lifestyleImages) ? result.lifestyleImages : []).filter((image) => image?.url).length,
         localImages: savedImages.length,
-        note: "htmlPath와 로컬 이미지들은 48시간 뒤 자동 정리되는 스테이징 폴더에 있습니다. 보존하려면 같은 폴더의 이미지들과 함께 원하는 위치로 복사하세요.",
+        note: "htmlPath와 로컬 이미지는 자동 정리되지 않는 exports 폴더에 저장됩니다. 옮길 때는 같은 폴더의 이미지들과 함께 이동하세요(상대경로 참조).",
         tagline: result?.copy?.tagline,
       });
     }),

package/lib/config.mjs

@@ -2,7 +2,7 @@ import { homedir } from "node:os";
 import path from "node:path";
 
 // 프록시 버전 — 서버가 X-AImakeAll-MCP-Version 으로 하한을 강제(426)할 수 있다.
-export const MCP_PROXY_VERSION = "0.3.0";
+export const MCP_PROXY_VERSION = "0.4.0";
 
 export const DEFAULT_API_BASE = "https://aimakeall.com";
 export const DEFAULT_COMPANION_URL = "http://127.0.0.1:9876";

package/lib/media-store.mjs

@@ -114,6 +114,17 @@ export function readPayloadHandle(filePath, { stateDir = "" } = {}) {
 }
 
 // 보존 기간이 지난 스테이징 미디어 정리 — 숨김 디렉터리에 GB 단위로 쌓이는 것 방지.
+// 최종 산출물(PDP HTML 등)용 보존 디렉터리 — pruneOldMedia(48h TTL)는 media/ 만
+// 정리하므로 exports/ 는 자동 삭제되지 않는다.
+export function saveExportBuffer(stateDir, name, buffer, { contentType = "" } = {}) {
+  const dir = path.join(stateDir, "exports");
+  mkdirSync(dir, { recursive: true });
+  const safeName = sanitizeOutputFilename(name, "export");
+  const filePath = path.join(dir, `${Date.now()}-${randomUUID().slice(0, 8)}-${safeName}`);
+  writeFileSync(filePath, buffer, { flag: "wx", mode: 0o600 });
+  return { bytes: buffer.length, contentType, filePath };
+}
+
 export function pruneOldMedia(stateDir, { now = Date.now() } = {}) {
   const dir = mediaDir(stateDir);
   let removed = 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aimakeall-mcp",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "AImakeAll MCP 서버 — Claude Code/Codex에서 자연어로 영상 기획·생성·렌더·퍼블리시 (렌더는 로컬 컴패니언)",
   "type": "module",
   "bin": {