pabal-web-mcp 1.1.0 → 1.2.0

package/dist/bin/mcp-server.js

@@ -199,7 +199,6 @@ var asoToPublicInputSchema = z.object({
 });
 var jsonSchema = toJsonSchema(asoToPublicInputSchema, {
   name: "AsoToPublicInput",
-  target: "openApi3",
   $refStrategy: "none"
 });
 var inputSchema = jsonSchema.definitions?.AsoToPublicInput || jsonSchema;
@@ -304,9 +303,11 @@ async function handleAsoToPublic(input) {
       prompt
     });
     const sourcesText = sources.join(" + ");
-    conversionPrompts.push(`
+    conversionPrompts.push(
+      `
 --- ${unifiedLocale} (${sourcesText}) ---
-${prompt}`);
+${prompt}`
+    );
   }
   const pullDataDir = getPullDataDir();
   let responseText = `Converting ASO data from pullData to public/products/${slug}/ structure.
@@ -517,7 +518,6 @@ var publicToAsoInputSchema = z2.object({
 });
 var jsonSchema2 = toJsonSchema2(publicToAsoInputSchema, {
   name: "PublicToAsoInput",
-  target: "openApi3",
   $refStrategy: "none"
 });
 var inputSchema2 = jsonSchema2.definitions?.PublicToAsoInput || jsonSchema2;
@@ -1610,7 +1610,6 @@ var improvePublicInputSchema = z3.object({
 });
 var jsonSchema3 = toJsonSchema3(improvePublicInputSchema, {
   name: "ImprovePublicInput",
-  target: "openApi3",
   $refStrategy: "none"
 });
 var inputSchema3 = jsonSchema3.definitions?.ImprovePublicInput || jsonSchema3;
@@ -1796,7 +1795,6 @@ var initProjectInputSchema = z4.object({
 });
 var jsonSchema4 = zodToJsonSchema4(initProjectInputSchema, {
   name: "InitProjectInput",
-  target: "openApi3",
   $refStrategy: "none"
 });
 var inputSchema4 = jsonSchema4.definitions?.InitProjectInput || jsonSchema4;
@@ -1891,12 +1889,13 @@ async function handleInitProject(input) {
 }
 
 // src/tools/create-blog-html.ts
-import fs7 from "fs";
+import fs8 from "fs";
 import path8 from "path";
 import { z as z5 } from "zod";
 import { zodToJsonSchema as zodToJsonSchema5 } from "zod-to-json-schema";
 
 // src/utils/blog.util.ts
+import fs7 from "fs";
 import path7 from "path";
 var DATE_REGEX = /^\d{4}-\d{2}-\d{2}$/;
 var BLOG_ROOT = "blogs";
@@ -1917,7 +1916,6 @@ function normalizeDate(date) {
   }
   return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
 }
-var isKoreanLocale = (locale) => locale.trim().toLowerCase().startsWith("ko");
 var toPublicBlogBase = (appSlug, slug) => `/${BLOG_ROOT}/${appSlug}/${slug}`;
 function resolveCoverImagePath(appSlug, slug, coverImage) {
   if (!coverImage || !coverImage.trim()) {
@@ -1933,20 +1931,6 @@ function resolveCoverImagePath(appSlug, slug, coverImage) {
   }
   return cleaned;
 }
-function resolveRelativeImagePath(appSlug, slug, relativePath) {
-  const raw = relativePath?.trim() || "./images/hero.png";
-  const normalized = raw.replace(/^\.\//, "");
-  return {
-    raw,
-    absolute: `${toPublicBlogBase(appSlug, slug)}/${normalized}`
-  };
-}
-function buildDescription(locale, topic, appSlug) {
-  if (isKoreanLocale(locale)) {
-    return `${topic}\uB97C \uC8FC\uC81C\uB85C ${appSlug}\uAC00 ASO\uC640 SEO\uB97C \uC5B4\uB5BB\uAC8C \uC5F0\uACB0\uD558\uACE0 \uBE14\uB85C\uADF8 \uD2B8\uB798\uD53D\uC744 \uC81C\uD488 \uD398\uC774\uC9C0\uB85C \uC774\uC5B4\uC8FC\uB294\uC9C0 \uC815\uB9AC\uD588\uC2B5\uB2C8\uB2E4.`;
-  }
-  return `How ${appSlug} teams turn "${topic}" into a bridge between ASO pages and SEO blogs without losing consistency.`;
-}
 function deriveTags(topic, appSlug) {
   const topicParts = topic.toLowerCase().split(/[^a-z0-9+]+/).filter(Boolean).slice(0, 6);
   const set = /* @__PURE__ */ new Set([...topicParts, appSlug.toLowerCase(), "blog"]);
@@ -1960,9 +1944,14 @@ function buildBlogMeta(options) {
     options.slug,
     options.coverImage
   );
+  if (!options.description || !options.description.trim()) {
+    throw new Error(
+      "Description is required. The LLM must generate a meta description based on the topic and locale."
+    );
+  }
   return {
     title: options.title,
-    description: options.description || buildDescription(options.locale, options.topic, options.appSlug),
+    description: options.description.trim(),
     appSlug: options.appSlug,
     slug: options.slug,
     locale: options.locale,
@@ -1980,128 +1969,18 @@ function renderBlogMetaBlock(meta) {
 ${serialized}
 -->`;
 }
-function renderEnglishBody(args) {
-  const { meta, topic, appSlug, includeRelativeImageExample, relativeImagePath } = args;
-  const lines = [];
-  lines.push(`<h1>${meta.title}</h1>`);
-  lines.push(
-    `<p>${appSlug} keeps product pages and blogs aligned. This article shows how to use "${topic}" as a shared story so ASO and SEO stay in sync.</p>`
-  );
-  if (includeRelativeImageExample && relativeImagePath) {
-    lines.push(
-      `<img src="${relativeImagePath.raw}" alt="${appSlug} ${topic} cover" />`
-    );
-    lines.push(
-      `<p>The image above is stored next to this file and resolves to <code>${relativeImagePath.absolute}</code> when published.</p>`
-    );
-  }
-  lines.push(`<h2>Why the gap appears</h2>`);
-  lines.push(
-    `<p>ASO pages are tuned for storefronts while SEO posts speak to search crawlers. Teams often duplicate work, drift on messaging, and miss internal links back to /products/${appSlug}.</p>`
-  );
-  lines.push(`<h3>Signals that drift</h3>`);
-  lines.push(
-    `<p>Different headlines, mismatched screenshots, and stale dates make ranking harder. "${topic}" is a strong bridge topic because it touches both acquisition paths.</p>`
-  );
-  lines.push(`<h2>How to bridge with ${appSlug}</h2>`);
-  lines.push(
-    `<p>Start with the product story, then reuse it in blog form. Keep the same core claim, swap storefront keywords for search intent, and reference the canonical product slug.</p>`
-  );
-  lines.push(`<h3>Mini playbook</h3>`);
-  lines.push(
-    `<ul>
-  <li>Reuse the app store hero claim inside the intro.</li>
-  <li>Map ASO keywords to SEO phrases for the "${topic}" angle.</li>
-  <li>Link feature blurbs to product screenshots and changelog notes.</li>
-  <li>Close with a CTA back to <code>/products/${appSlug}</code>.</li>
-</ul>`
-  );
-  lines.push(`<h2>Example flow to copy</h2>`);
-  lines.push(
-    `<p>Pick one release, outline how it helps with "${topic}", then add a short proof (metric, quote, or screenshot). Keep h2/h3 hierarchy stable so translations stay predictable.</p>`
-  );
-  lines.push(`<h2>Wrap up</h2>`);
-  lines.push(
-    `<p>${appSlug} keeps ASO and SEO talking to each other. Publish this HTML under <code>/blogs/${appSlug}/${meta.slug}/${meta.locale}.html</code> and link it from the product page so traffic flows both ways.</p>`
-  );
-  lines.push(
-    `<p><strong>CTA:</strong> Explore the product page at <a href="/products/${appSlug}">/products/${appSlug}</a>.</p>`
-  );
-  return lines.join("\n\n");
-}
-function renderKoreanBody(args) {
-  const { meta, topic, appSlug, includeRelativeImageExample, relativeImagePath } = args;
-  const lines = [];
-  lines.push(`<h1>${meta.title}</h1>`);
-  lines.push(
-    `<p>${appSlug}\uB294 \uC81C\uD488 \uD398\uC774\uC9C0\uC640 \uBE14\uB85C\uADF8\uC758 \uD750\uB984\uC774 \uB04A\uAE30\uC9C0 \uC54A\uB3C4\uB85D "${topic}"\uC744 \uAC19\uC740 \uC774\uC57C\uAE30\uB85C \uBB36\uC5B4\uB0C5\uB2C8\uB2E4. \uC774 \uAE00\uC740 ASO \uC2E0\uD638\uC640 SEO \uCF58\uD150\uCE20\uB97C \uD558\uB098\uC758 \uBA54\uC2DC\uC9C0\uB85C \uC5F0\uACB0\uD558\uB294 \uBC29\uBC95\uC744 \uC124\uBA85\uD569\uB2C8\uB2E4.</p>`
-  );
-  if (includeRelativeImageExample && relativeImagePath) {
-    lines.push(
-      `<img src="${relativeImagePath.raw}" alt="${appSlug} ${topic} \uD45C\uC9C0 \uC774\uBBF8\uC9C0" />`
-    );
-    lines.push(
-      `<p>\uC704 \uC774\uBBF8\uC9C0\uB294 \uAE00\uACFC \uAC19\uC740 \uD3F4\uB354\uC5D0 \uC800\uC7A5\uB418\uC5B4 \uD37C\uBE14\uB9AC\uC2DC \uC2DC <code>${relativeImagePath.absolute}</code> \uACBD\uB85C\uB85C \uB178\uCD9C\uB429\uB2C8\uB2E4.</p>`
-    );
-  }
-  lines.push(`<h2>ASO\uC640 SEO\uAC00 \uAC08\uB77C\uC9C0\uB294 \uC9C0\uC810</h2>`);
-  lines.push(
-    `<p>\uC2A4\uD1A0\uC5B4 \uCD5C\uC801\uD654\uB294 \uC804\uD658\uC5D0 \uC9D1\uC911\uD558\uACE0, \uBE14\uB85C\uADF8\uB294 \uAC80\uC0C9 \uB178\uCD9C\uC744 \uB178\uB9BD\uB2C8\uB2E4. \uAC19\uC740 \uC81C\uD488\uC774\uB77C\uB3C4 \uC81C\uBAA9, \uC2A4\uD06C\uB9B0\uC0F7, \uB0A0\uC9DC\uAC00 \uB2EC\uB77C\uC9C0\uBA74 \uC2E0\uB8B0\uB3C4\uAC00 \uB5A8\uC5B4\uC9C0\uACE0 /products/${appSlug}\uB85C \uC774\uC5B4\uC9C0\uB294 \uB9C1\uD06C\uB3C4 \uC57D\uD574\uC9D1\uB2C8\uB2E4.</p>`
-  );
-  lines.push(`<h3>\uD754\uD788 \uB193\uCE58\uB294 \uC2E0\uD638</h3>`);
-  lines.push(
-    `<p>\uC2A4\uD1A0\uC5B4 \uBA54\uC2DC\uC9C0\uC640 \uBE14\uB85C\uADF8 \uCE74\uD53C\uAC00 \uB530\uB85C \uB180\uAC70\uB098, \uCD9C\uC2DC \uB9E5\uB77D\uC774 \uBE60\uC9C0\uB294 \uACBD\uC6B0\uC785\uB2C8\uB2E4. "${topic}" \uAC19\uC740 \uC8FC\uC81C\uB294 \uB450 \uCC44\uB110\uC744 \uBAA8\uB450 \uAC74\uB4DC\uB9AC\uAE30 \uB54C\uBB38\uC5D0 \uC77C\uAD00\uC131\uC774 \uB354 \uC911\uC694\uD569\uB2C8\uB2E4.</p>`
-  );
-  lines.push(`<h2>${appSlug}\uB85C \uB2E4\uB9AC \uB193\uAE30</h2>`);
-  lines.push(
-    `<p>\uC81C\uD488 \uC774\uC57C\uAE30\uB97C \uBA3C\uC800 \uC815\uB9AC\uD558\uACE0 \uBE14\uB85C\uADF8 \uBC84\uC804\uC73C\uB85C \uC7AC\uC0AC\uC6A9\uD569\uB2C8\uB2E4. \uD575\uC2EC \uC8FC\uC7A5\uACFC \uC99D\uAC70\uB294 \uC720\uC9C0\uD558\uB418, \uAC80\uC0C9 \uC758\uB3C4\uC5D0 \uB9DE\uCDB0 \uD0A4\uC6CC\uB4DC\uC640 \uC608\uC2DC\uB97C \uC870\uC815\uD558\uACE0 \uC81C\uD488 \uC2AC\uB7EC\uADF8\uB97C \uD568\uAED8 \uB178\uCD9C\uD569\uB2C8\uB2E4.</p>`
-  );
-  lines.push(`<h3>\uC801\uC6A9 \uCCB4\uD06C\uB9AC\uC2A4\uD2B8</h3>`);
-  lines.push(
-    `<ul>
-  <li>\uC2A4\uD1A0\uC5B4 \uD5E4\uB4DC\uB77C\uC778\uC744 \uC778\uD2B8\uB85C\uC5D0 \uC7AC\uC0AC\uC6A9\uD558\uACE0 \uB3D9\uC77C\uD55C \uC8FC\uC7A5\uC73C\uB85C \uD480\uC5B4\uAC00\uAE30</li>
-  <li>"${topic}"\uB97C \uC704\uD55C SEO \uD0A4\uC6CC\uB4DC\uB97C ASO \uD0A4\uC6CC\uB4DC\uC640 \uB9E4\uD551\uD558\uAE30</li>
-  <li>\uC2E0\uAE30\uB2A5/\uC2A4\uD06C\uB9B0\uC0F7/\uBCC0\uACBD \uC0AC\uD56D\uC744 \uBE14\uB85C\uADF8 \uBCF8\uBB38\uC5D0 \uC9E7\uAC8C \uC5F0\uACB0\uD558\uAE30</li>
-  <li>\uB9C8\uC9C0\uB9C9 \uBB38\uB2E8\uC5D0\uC11C <code>/products/${appSlug}</code>\uB85C \uC790\uC5F0\uC2A4\uB7EC\uC6B4 CTA \uBC30\uCE58</li>
-</ul>`
-  );
-  lines.push(`<h2>\uC0AC\uB840 \uD750\uB984 \uC608\uC2DC</h2>`);
-  lines.push(
-    `<p>\uCD5C\uADFC \uB9B4\uB9AC\uC2A4\uB97C \uD558\uB098 \uACE8\uB77C "${topic}"\uACFC \uC5B4\uB5BB\uAC8C \uB9DE\uBB3C\uB9AC\uB294\uC9C0 \uC124\uBA85\uD558\uACE0, \uC22B\uC790\xB7\uC778\uC6A9\xB7\uC2A4\uD06C\uB9B0\uC0F7 \uC911 \uD558\uB098\uB85C \uC99D\uAC70\uB97C \uB0A8\uAE30\uC138\uC694. h2/h3 \uAD6C\uC870\uB97C \uACE0\uC815\uD558\uBA74 \uB2E4\uAD6D\uC5B4 \uD655\uC7A5\uB3C4 \uC218\uC6D4\uD574\uC9D1\uB2C8\uB2E4.</p>`
-  );
-  lines.push(`<h2>\uB9C8\uBB34\uB9AC</h2>`);
-  lines.push(
-    `<p>${appSlug}\uB294 \uBE14\uB85C\uADF8\uC640 \uC81C\uD488 \uD398\uC774\uC9C0\uAC00 \uC11C\uB85C \uD2B8\uB798\uD53D\uC744 \uC8FC\uACE0\uBC1B\uB3C4\uB85D \uC124\uACC4\uD588\uC2B5\uB2C8\uB2E4. \uC774 HTML\uC744 <code>/blogs/${appSlug}/${meta.slug}/${meta.locale}.html</code> \uC704\uCE58\uC5D0 \uC800\uC7A5\uD558\uACE0 \uC81C\uD488 \uC0C1\uC138\uC5D0\uC11C \uB9C1\uD06C\uB97C \uAC78\uC5B4\uB450\uC138\uC694.</p>`
-  );
-  lines.push(
-    `<p><strong>CTA:</strong> \uC81C\uD488 \uD398\uC774\uC9C0 <a href="/products/${appSlug}">/products/${appSlug}</a>\uC5D0\uC11C \uB354 \uC790\uC138\uD788 \uC0B4\uD3B4\uBCF4\uC138\uC694.</p>`
-  );
-  return lines.join("\n\n");
-}
-function renderBlogBody(options) {
-  if (isKoreanLocale(options.meta.locale)) {
-    return renderKoreanBody(options);
-  }
-  return renderEnglishBody(options);
-}
 function buildBlogHtmlDocument(options) {
   const metaBlock = renderBlogMetaBlock(options.meta);
-  const body = renderBlogBody({
-    meta: options.meta,
-    topic: options.topic,
-    appSlug: options.appSlug,
-    includeRelativeImageExample: options.includeRelativeImageExample,
-    relativeImagePath: options.relativeImagePath
-  });
+  const body = options.content.trim();
   return `${metaBlock}
 ${body}`;
 }
-function resolveTargetLocales(input, defaultLocale = "en-US") {
+function resolveTargetLocales(input) {
   if (input.locales?.length) {
     const locales = input.locales.map((loc) => loc.trim()).filter(Boolean);
     return Array.from(new Set(locales));
   }
-  const fallback = input.locale?.trim() || defaultLocale;
+  const fallback = input.locale?.trim();
   return fallback ? [fallback] : [];
 }
 function getBlogOutputPaths(options) {
@@ -2115,6 +1994,63 @@ function getBlogOutputPaths(options) {
   const publicBasePath = toPublicBlogBase(options.appSlug, options.slug);
   return { baseDir, filePath, publicBasePath };
 }
+function parseBlogHtml(htmlContent) {
+  const metaBlockRegex = /<!--BLOG_META\s*\n([\s\S]*?)\n-->/;
+  const match = htmlContent.match(metaBlockRegex);
+  if (!match) {
+    return { meta: null, body: htmlContent.trim() };
+  }
+  try {
+    const metaJson = match[1].trim();
+    const meta = JSON.parse(metaJson);
+    const body = htmlContent.replace(metaBlockRegex, "").trim();
+    return { meta, body };
+  } catch (error) {
+    return { meta: null, body: htmlContent.trim() };
+  }
+}
+function findExistingBlogPosts({
+  appSlug,
+  locale,
+  publicDir,
+  limit = 2
+}) {
+  const blogAppDir = path7.join(publicDir, BLOG_ROOT, appSlug);
+  if (!fs7.existsSync(blogAppDir)) {
+    return [];
+  }
+  const posts = [];
+  const subdirs = fs7.readdirSync(blogAppDir, { withFileTypes: true });
+  for (const subdir of subdirs) {
+    if (!subdir.isDirectory()) continue;
+    const localeFile = path7.join(blogAppDir, subdir.name, `${locale}.html`);
+    if (!fs7.existsSync(localeFile)) continue;
+    try {
+      const htmlContent = fs7.readFileSync(localeFile, "utf-8");
+      const { meta, body } = parseBlogHtml(htmlContent);
+      if (meta && meta.locale === locale) {
+        posts.push({
+          filePath: localeFile,
+          meta,
+          body,
+          publishedAt: meta.publishedAt
+        });
+      }
+    } catch (error) {
+      continue;
+    }
+  }
+  posts.sort((a, b) => {
+    const dateA = new Date(a.publishedAt).getTime();
+    const dateB = new Date(b.publishedAt).getTime();
+    return dateB - dateA;
+  });
+  return posts.slice(0, limit).map(({ filePath, meta, body }) => ({
+    filePath,
+    meta,
+    body
+  }));
+}
 
 // src/tools/create-blog-html.ts
 var toJsonSchema4 = zodToJsonSchema5;
@@ -2125,28 +2061,30 @@ var createBlogHtmlInputSchema = z5.object({
     "English title used for slug (kebab-case). Falls back to topic when omitted."
   ),
   topic: z5.string().trim().min(1, "topic is required").describe("Topic/angle to write about in the blog body"),
-  locale: z5.string().trim().optional().default("en-US").describe("Primary locale (default en-US). Ignored when locales[] is set."),
+  locale: z5.string().trim().min(1, "locale is required").describe(
+    "Primary locale (e.g., 'en-US', 'ko-KR'). Required to determine the language for blog content generation."
+  ),
   locales: z5.array(z5.string().trim().min(1)).optional().describe(
-    "Optional list of locales to generate. Each locale gets its own HTML file."
+    "Optional list of locales to generate. Each locale gets its own HTML file. If provided, locale parameter is ignored."
   ),
-  description: z5.string().trim().optional().describe(
-    "Meta description override. If omitted, the tool generates one from appSlug/topic per locale."
+  content: z5.string().trim().min(1, "content is required").describe(
+    "HTML content for the blog body. You (the LLM) must generate this HTML content based on the topic and locale. Structure should follow the pattern in public/en-US.html: paragraphs (<p>), headings (<h2>, <h3>), images (<img>), lists (<ul>, <li>), horizontal rules (<hr>), etc. The content should be written in the language corresponding to the locale."
+  ),
+  description: z5.string().trim().min(1, "description is required").describe(
+    "Meta description for the blog post. You (the LLM) must generate this based on the topic and locale. Should be a concise summary of the blog content in the language corresponding to the locale."
+  ),
+  tags: z5.array(z5.string().trim().min(1)).optional().describe(
+    "Optional tags for BLOG_META. Defaults to tags derived from topic."
   ),
-  tags: z5.array(z5.string().trim().min(1)).optional().describe("Optional tags for BLOG_META. Defaults to tags derived from topic."),
   coverImage: z5.string().trim().optional().describe(
     "Cover image path. Relative paths rewrite to /blogs/<app>/<slug>/..., default is /products/<appSlug>/og-image.png."
   ),
-  includeRelativeImageExample: z5.boolean().optional().default(false).describe(
-    "Inject a relative image example (./images/hero.png) into the body to demonstrate path rewriting."
-  ),
-  relativeImagePath: z5.string().trim().optional().describe("Override the relative image path (default ./images/hero.png)."),
   publishedAt: z5.string().trim().regex(DATE_REGEX2, "publishedAt must use YYYY-MM-DD").optional().describe("Publish date (YYYY-MM-DD). Defaults to today."),
   modifiedAt: z5.string().trim().regex(DATE_REGEX2, "modifiedAt must use YYYY-MM-DD").optional().describe("Last modified date (YYYY-MM-DD). Defaults to publishedAt."),
   overwrite: z5.boolean().optional().default(false).describe("Overwrite existing files when true (default: false).")
 }).describe("Generate static HTML blog posts with BLOG_META headers.");
 var jsonSchema5 = toJsonSchema4(createBlogHtmlInputSchema, {
   name: "CreateBlogHtmlInput",
-  target: "openApi3",
   $refStrategy: "none"
 });
 var inputSchema5 = jsonSchema5.definitions?.CreateBlogHtmlInput || jsonSchema5;
@@ -2154,19 +2092,33 @@ var createBlogHtmlTool = {
   name: "create-blog-html",
   description: `Generate HTML blog posts under public/blogs/<appSlug>/<slug>/<locale>.html with a BLOG_META block.
 
+CRITICAL: WRITING STYLE CONSISTENCY
+Before generating content, you MUST:
+1. Read existing blog posts from public/blogs/<appSlug>/*/<locale>.html (use findExistingBlogPosts utility or read files directly)
+2. Analyze the writing style, tone, and format from 2 existing posts in the same locale
+3. Match that exact writing style when generating the new blog post content and description
+4. Maintain consistency in: paragraph structure, heading usage, tone, formality level, and overall format
+
+IMPORTANT REQUIREMENTS:
+1. The 'locale' parameter is REQUIRED. If the user does not provide a locale, you MUST ask them to specify which language/locale they want to write the blog in (e.g., 'en-US', 'ko-KR', 'ja-JP', etc.).
+2. The 'content' parameter is REQUIRED. You (the LLM) must generate the HTML content based on the 'topic' and 'locale' provided by the user. The content should be written in the language corresponding to the locale AND match the writing style of existing blog posts for that locale.
+3. The 'description' parameter is REQUIRED. You (the LLM) must generate this based on the topic, locale, AND the writing style of existing blog posts.
+
 Slug rules:
 - slug = slugify(English title, kebab-case ASCII)
 - path: public/blogs/<appSlug>/<slug>/<locale>.html
 - coverImage default: /products/<appSlug>/og-image.png (relative paths are rewritten under /blogs/<app>/<slug>/)
 - overwrite defaults to false (throws when file exists)
 
-Template:
-- Intro connecting topic/app
-- 3-4 sections (problem \u2192 solution \u2192 tips/examples) using h2/h3
-- Optional relative image example (./images/hero.png)
-- Conclusion + CTA linking to /products/<appSlug>
+HTML Structure (follows public/en-US.html pattern):
+- BLOG_META block at the top with JSON metadata
+- HTML body content: paragraphs (<p>), headings (<h2>, <h3>), images (<img>), lists (<ul>, <li>), horizontal rules (<hr>), etc.
+- You must generate the HTML content based on the topic, making it relevant and engaging for the target locale's language, while maintaining consistency with existing blog posts.
 
-Supports multiple locales when locales[] is provided (default single locale). Content language follows locale (ko -> Korean, otherwise English).`,
+Supports multiple locales when locales[] is provided. Each locale gets its own HTML file. For each locale, you must:
+1. Read existing posts in that locale to understand the writing style
+2. Generate appropriate content in that locale's language
+3. Match the writing style and format of existing posts`,
   inputSchema: inputSchema5
 };
 async function handleCreateBlogHtml(input) {
@@ -2178,20 +2130,36 @@ async function handleCreateBlogHtml(input) {
     description,
     tags,
     coverImage,
-    includeRelativeImageExample = false,
-    relativeImagePath,
     publishedAt,
     modifiedAt,
-    overwrite = false
+    overwrite = false,
+    content
   } = input;
+  if (!content || !content.trim()) {
+    throw new Error(
+      "Content is required. Please provide HTML content for the blog body based on the topic and locale."
+    );
+  }
   const resolvedTitle = title && title.trim() || topic.trim();
   const slug = slugifyTitle(resolvedTitle);
   const targetLocales = resolveTargetLocales(input);
   if (!targetLocales.length) {
-    throw new Error("At least one locale is required to generate blog HTML.");
+    throw new Error(
+      "Locale is required. Please specify which language/locale you want to write the blog in (e.g., 'en-US', 'ko-KR', 'ja-JP')."
+    );
+  }
+  const existingPostsByLocale = {};
+  for (const locale of targetLocales) {
+    const existingPosts = findExistingBlogPosts({
+      appSlug,
+      locale,
+      publicDir,
+      limit: 2
+    });
+    if (existingPosts.length > 0) {
+      existingPostsByLocale[locale] = existingPosts;
+    }
   }
-  const shouldIncludeRelativeImage = includeRelativeImageExample || Boolean(relativeImagePath);
-  const relativeImage = shouldIncludeRelativeImage ? resolveRelativeImagePath(appSlug, slug, relativeImagePath) : void 0;
   const output = {
     slug,
     baseDir: path8.join(publicDir, "blogs", appSlug, slug),
@@ -2207,7 +2175,9 @@ async function handleCreateBlogHtml(input) {
       publicDir
     })
   );
-  const existing = plannedFiles.filter(({ filePath }) => fs7.existsSync(filePath));
+  const existing = plannedFiles.filter(
+    ({ filePath }) => fs8.existsSync(filePath)
+  );
   if (existing.length > 0 && !overwrite) {
     const existingList = existing.map((f) => f.filePath).join("\n- ");
     throw new Error(
@@ -2215,7 +2185,7 @@ async function handleCreateBlogHtml(input) {
 - ${existingList}`
     );
   }
-  fs7.mkdirSync(output.baseDir, { recursive: true });
+  fs8.mkdirSync(output.baseDir, { recursive: true });
   for (const locale of targetLocales) {
     const { filePath } = getBlogOutputPaths({
       appSlug,
@@ -2239,12 +2209,9 @@ async function handleCreateBlogHtml(input) {
     output.metaByLocale[locale] = meta;
     const html = buildBlogHtmlDocument({
       meta,
-      topic,
-      appSlug,
-      includeRelativeImageExample: shouldIncludeRelativeImage,
-      relativeImagePath: relativeImage
+      content
     });
-    fs7.writeFileSync(filePath, html, "utf-8");
+    fs8.writeFileSync(filePath, html, "utf-8");
     output.files.push({ locale, path: filePath });
   }
   const summaryLines = [
@@ -2256,11 +2223,25 @@ async function handleCreateBlogHtml(input) {
     "Files:",
     ...output.files.map((file) => `- ${file.locale}: ${file.path}`)
   ];
+  const styleReferenceInfo = [];
+  for (const [locale, posts] of Object.entries(existingPostsByLocale)) {
+    if (posts.length > 0) {
+      styleReferenceInfo.push(
+        `
+Writing style reference for ${locale}: Found ${posts.length} existing post(s) used for style consistency.`
+      );
+    }
+  }
+  if (styleReferenceInfo.length === 0) {
+    styleReferenceInfo.push(
+      "\nNote: No existing blog posts found for style reference. This is the first post for this app/locale combination."
+    );
+  }
   return {
     content: [
       {
         type: "text",
-        text: summaryLines.join("\n")
+        text: summaryLines.join("\n") + styleReferenceInfo.join("")
       }
     ]
   };

package/dist/index.d.ts

@@ -204,6 +204,61 @@ declare function isGooglePlayMultilingual(data: GooglePlayAsoData | GooglePlayMu
  */
 declare function isAppStoreMultilingual(data: AppStoreAsoData | AppStoreMultilingualAsoData | undefined): data is AppStoreMultilingualAsoData;
 
+/**
+ * Blog type definitions
+ * Used by both MCP tools and web application
+ */
+/**
+ * Blog Meta Block (raw from HTML comment)
+ * All fields are optional as they may be parsed from HTML or defaults
+ */
+interface BlogMetaBlock {
+    title: string;
+    description: string;
+    appSlug: string;
+    slug: string;
+    locale?: string;
+    coverImage?: string;
+    publishedAt?: string;
+    modifiedAt?: string;
+    tags?: string[];
+}
+/**
+ * Blog Meta (resolved with UnifiedLocale)
+ * Used by web application after normalization
+ */
+interface BlogMeta extends BlogMetaBlock {
+    locale: UnifiedLocale;
+    coverImage?: string;
+    publishedAt?: string;
+    modifiedAt?: string;
+}
+/**
+ * Blog Article (complete parsed article with HTML content)
+ */
+interface BlogArticle {
+    appSlug: string;
+    slug: string;
+    locale: UnifiedLocale;
+    html: string;
+    meta: BlogMeta;
+    filePath: string;
+}
+/**
+ * Blog Summary (aggregated metadata across locales)
+ */
+interface BlogSummary {
+    appSlug: string;
+    slug: string;
+    title: string;
+    description: string;
+    coverImage?: string;
+    publishedAt?: string;
+    modifiedAt?: string;
+    locales: UnifiedLocale[];
+    defaultLocale: UnifiedLocale;
+}
+
 interface ImageAsset {
     src: string;
     alt: string;
@@ -366,10 +421,60 @@ interface ProductLocale {
     landing?: LandingPageLocale;
 }
 
+/**
+ * Site data type definitions
+ * Structure for public/site/ directory
+ * - contacts.json: Contact information
+ * - locales/en-US.json: Localized content (meta, hero, developer)
+ */
+interface SiteData {
+    meta: {
+        title: string;
+        description: string;
+    };
+    hero: {
+        brand: string;
+        tagline: string;
+        subtitle: string;
+    };
+    contacts: {
+        id: string;
+        label: string;
+        icon: string;
+        value: string;
+    }[];
+    developer: {
+        name: string;
+        heading: string;
+        role: string;
+        bio: string;
+        principles: string[];
+        stack: string[];
+        now: string;
+        availability: string;
+        likes: string[];
+        location?: string;
+        timezone?: string;
+        visited: {
+            countries: {
+                code: string;
+                name: string;
+                flagEmoji: string;
+                cities: string[];
+            }[];
+        };
+    };
+}
+
 /**
  * Types for the create-blog-html MCP tool
  */
-interface BlogMeta {
+/**
+ * BlogMetaOutput for MCP tool output
+ * All fields are required (resolved values)
+ * Note: This is separate from blog.types.ts BlogMeta which uses UnifiedLocale
+ */
+interface BlogMetaOutput {
     title: string;
     description: string;
     appSlug: string;
@@ -394,13 +499,18 @@ interface CreateBlogHtmlInput {
      */
     topic: string;
     /**
-     * Single locale to generate (default en-US). Ignored when locales[] is provided.
+     * Single locale to generate (REQUIRED). Ignored when locales[] is provided.
      */
-    locale?: string;
+    locale: string;
     /**
      * Optional list of locales to generate. Each gets its own HTML file.
      */
     locales?: string[];
+    /**
+     * HTML content for the blog body. REQUIRED. The LLM must generate this based on the topic and locale.
+     * Structure should follow public/en-US.html pattern.
+     */
+    content: string;
     /**
      * Meta description override. If absent, a locale-aware summary is generated from topic/appSlug.
      */
@@ -443,7 +553,7 @@ interface CreateBlogHtmlResult {
     baseDir: string;
     files: GeneratedBlogFile[];
     coverImage: string;
-    metaByLocale: Record<string, BlogMeta>;
+    metaByLocale: Record<string, BlogMetaOutput>;
 }
 
 /**
@@ -701,4 +811,4 @@ declare function getPublicDir(): string;
  */
 declare function getProductsDir(): string;
 
-export { APP_STORE_TO_UNIFIED, type AppMetaLinks, type AppPageData, type AppStoreAsoData, type AppStoreInfoLocalization, type AppStoreLocale, type AppStoreMultilingualAsoData, type AppStoreReleaseNote, type AppStoreScreenshotDisplayType, type AppStoreScreenshots, type AppStoreVersionLocalization, type AsoData, type AsoLocaleContent, type AsoTemplate, type BlogMeta, type CreateBlogHtmlInput, type CreateBlogHtmlResult, DEFAULT_LOCALE, type DeepPartial, type FeatureItem, GOOGLE_PLAY_TO_UNIFIED, type GeneratedBlogFile, type GooglePlayAsoData, type GooglePlayImageType, type GooglePlayListing, type GooglePlayLocale, type GooglePlayMultilingualAsoData, type GooglePlayReleaseNote, type GooglePlayScreenshotType, type GooglePlayScreenshots, type ImageAsset, type LandingCta, type LandingFeatures, type LandingHero, type LandingPage, type LandingPageLocale, type LandingReviews, type LandingScreenshots, type LayoutColors, type ProductConfig, type ProductContent, type ProductLocale, type ProductMetadata, type ProductScreenshots, type SupportedLocale, type Testimonial, UNIFIED_LOCALES, UNIFIED_TO_APP_STORE, UNIFIED_TO_GOOGLE_PLAY, type UnifiedLocale, appStoreToGooglePlay, appStoreToUnified, appStoreToUnifiedBatch, convertObjectFromAppStore, convertObjectFromGooglePlay, convertObjectToAppStore, convertObjectToGooglePlay, getAsoDataDir, getProductsDir, getPublicDir, getPullDataDir, getPushDataDir, googlePlayToAppStore, googlePlayToUnified, googlePlayToUnifiedBatch, isAppStoreLocale, isAppStoreMultilingual, isGooglePlayLocale, isGooglePlayMultilingual, isSupportedLocale, loadAsoFromConfig, saveAsoToAsoDir, saveAsoToConfig, unifiedToAppStore, unifiedToAppStoreBatch, unifiedToBothPlatforms, unifiedToGooglePlay, unifiedToGooglePlayBatch };
+export { APP_STORE_TO_UNIFIED, type AppMetaLinks, type AppPageData, type AppStoreAsoData, type AppStoreInfoLocalization, type AppStoreLocale, type AppStoreMultilingualAsoData, type AppStoreReleaseNote, type AppStoreScreenshotDisplayType, type AppStoreScreenshots, type AppStoreVersionLocalization, type AsoData, type AsoLocaleContent, type AsoTemplate, type BlogArticle, type BlogMeta, type BlogMetaBlock, type BlogMetaOutput, type BlogSummary, type CreateBlogHtmlInput, type CreateBlogHtmlResult, DEFAULT_LOCALE, type DeepPartial, type FeatureItem, GOOGLE_PLAY_TO_UNIFIED, type GeneratedBlogFile, type GooglePlayAsoData, type GooglePlayImageType, type GooglePlayListing, type GooglePlayLocale, type GooglePlayMultilingualAsoData, type GooglePlayReleaseNote, type GooglePlayScreenshotType, type GooglePlayScreenshots, type ImageAsset, type LandingCta, type LandingFeatures, type LandingHero, type LandingPage, type LandingPageLocale, type LandingReviews, type LandingScreenshots, type LayoutColors, type ProductConfig, type ProductContent, type ProductLocale, type ProductMetadata, type ProductScreenshots, type SiteData, type SupportedLocale, type Testimonial, UNIFIED_LOCALES, UNIFIED_TO_APP_STORE, UNIFIED_TO_GOOGLE_PLAY, type UnifiedLocale, appStoreToGooglePlay, appStoreToUnified, appStoreToUnifiedBatch, convertObjectFromAppStore, convertObjectFromGooglePlay, convertObjectToAppStore, convertObjectToGooglePlay, getAsoDataDir, getProductsDir, getPublicDir, getPullDataDir, getPushDataDir, googlePlayToAppStore, googlePlayToUnified, googlePlayToUnifiedBatch, isAppStoreLocale, isAppStoreMultilingual, isGooglePlayLocale, isGooglePlayMultilingual, isSupportedLocale, loadAsoFromConfig, saveAsoToAsoDir, saveAsoToConfig, unifiedToAppStore, unifiedToAppStoreBatch, unifiedToBothPlatforms, unifiedToGooglePlay, unifiedToGooglePlayBatch };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pabal-web-mcp",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "type": "module",
   "description": "MCP server for ASO data management with shared types and utilities",
   "author": "skyu",