pabal-web-mcp 1.0.0 → 1.1.1

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;
@@ -546,9 +546,10 @@ async function downloadScreenshotsToAsoDir(slug, asoData) {
         "screenshots",
         googlePlayLocale
       );
-      if (localeData.screenshots?.phone?.length > 0) {
-        for (let i = 0; i < localeData.screenshots.phone.length; i++) {
-          const url = localeData.screenshots.phone[i];
+      const phoneScreenshots = localeData.screenshots?.phone;
+      if (phoneScreenshots && phoneScreenshots.length > 0) {
+        for (let i = 0; i < phoneScreenshots.length; i++) {
+          const url = phoneScreenshots[i];
           const filename = `phone-${i + 1}.png`;
           const outputPath = path4.join(asoDir, filename);
           if (isLocalAssetPath(url)) {
@@ -1609,7 +1610,6 @@ var improvePublicInputSchema = z3.object({
 });
 var jsonSchema3 = toJsonSchema3(improvePublicInputSchema, {
   name: "ImprovePublicInput",
-  target: "openApi3",
   $refStrategy: "none"
 });
 var inputSchema3 = jsonSchema3.definitions?.ImprovePublicInput || jsonSchema3;
@@ -1795,7 +1795,6 @@ var initProjectInputSchema = z4.object({
 });
 var jsonSchema4 = zodToJsonSchema4(initProjectInputSchema, {
   name: "InitProjectInput",
-  target: "openApi3",
   $refStrategy: "none"
 });
 var inputSchema4 = jsonSchema4.definitions?.InitProjectInput || jsonSchema4;
@@ -1889,6 +1888,401 @@ async function handleInitProject(input) {
   };
 }
 
+// src/tools/create-blog-html.ts
+import fs7 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 path7 from "path";
+var DATE_REGEX = /^\d{4}-\d{2}-\d{2}$/;
+var BLOG_ROOT = "blogs";
+var removeDiacritics = (value) => value.normalize("NFKD").replace(/[\u0300-\u036f]/g, "");
+var compact = (items) => (items || []).filter((item) => Boolean(item && item.trim()));
+function slugifyTitle(title) {
+  const normalized = removeDiacritics(title).toLowerCase().replace(/[^a-z0-9\s-]/g, " ").replace(/[_\s]+/g, "-").replace(/-+/g, "-").replace(/^-+|-+$/g, "");
+  return normalized || "post";
+}
+function normalizeDate(date) {
+  if (date) {
+    if (!DATE_REGEX.test(date)) {
+      throw new Error(
+        `Invalid date format "${date}". Use YYYY-MM-DD (e.g. 2024-09-30).`
+      );
+    }
+    return 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()) {
+    return `/products/${appSlug}/og-image.png`;
+  }
+  const cleaned = coverImage.trim();
+  const relativePath = cleaned.replace(/^\.\//, "");
+  if (!cleaned.startsWith("/") && !/^https?:\/\//.test(cleaned)) {
+    return `${toPublicBlogBase(appSlug, slug)}/${relativePath}`;
+  }
+  if (cleaned.startsWith("./")) {
+    return `${toPublicBlogBase(appSlug, slug)}/${relativePath}`;
+  }
+  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"]);
+  return Array.from(set);
+}
+function buildBlogMeta(options) {
+  const publishedAt = normalizeDate(options.publishedAt);
+  const modifiedAt = normalizeDate(options.modifiedAt || publishedAt);
+  const coverImage = resolveCoverImagePath(
+    options.appSlug,
+    options.slug,
+    options.coverImage
+  );
+  return {
+    title: options.title,
+    description: options.description || buildDescription(options.locale, options.topic, options.appSlug),
+    appSlug: options.appSlug,
+    slug: options.slug,
+    locale: options.locale,
+    publishedAt,
+    modifiedAt,
+    coverImage,
+    tags: compact(options.tags)?.length ? Array.from(
+      new Set(compact(options.tags).map((tag) => tag.toLowerCase()))
+    ) : deriveTags(options.topic, options.appSlug)
+  };
+}
+function renderBlogMetaBlock(meta) {
+  const serialized = JSON.stringify(meta, null, 2);
+  return `<!--BLOG_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
+  });
+  return `${metaBlock}
+${body}`;
+}
+function resolveTargetLocales(input, defaultLocale = "en-US") {
+  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;
+  return fallback ? [fallback] : [];
+}
+function getBlogOutputPaths(options) {
+  const baseDir = path7.join(
+    options.publicDir,
+    BLOG_ROOT,
+    options.appSlug,
+    options.slug
+  );
+  const filePath = path7.join(baseDir, `${options.locale}.html`);
+  const publicBasePath = toPublicBlogBase(options.appSlug, options.slug);
+  return { baseDir, filePath, publicBasePath };
+}
+
+// src/tools/create-blog-html.ts
+var toJsonSchema4 = zodToJsonSchema5;
+var DATE_REGEX2 = /^\d{4}-\d{2}-\d{2}$/;
+var createBlogHtmlInputSchema = z5.object({
+  appSlug: z5.string().trim().min(1, "appSlug is required").describe("Product/app slug used for paths and CTAs"),
+  title: z5.string().trim().optional().describe(
+    "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."
+  ),
+  locales: z5.array(z5.string().trim().min(1)).optional().describe(
+    "Optional list of locales to generate. Each locale gets its own HTML file."
+  ),
+  description: z5.string().trim().optional().describe(
+    "Meta description override. If omitted, the tool generates one from appSlug/topic per locale."
+  ),
+  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",
+  $refStrategy: "none"
+});
+var inputSchema5 = jsonSchema5.definitions?.CreateBlogHtmlInput || jsonSchema5;
+var createBlogHtmlTool = {
+  name: "create-blog-html",
+  description: `Generate HTML blog posts under public/blogs/<appSlug>/<slug>/<locale>.html with a BLOG_META block.
+
+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>
+
+Supports multiple locales when locales[] is provided (default single locale). Content language follows locale (ko -> Korean, otherwise English).`,
+  inputSchema: inputSchema5
+};
+async function handleCreateBlogHtml(input) {
+  const publicDir = getPublicDir();
+  const {
+    appSlug,
+    topic,
+    title,
+    description,
+    tags,
+    coverImage,
+    includeRelativeImageExample = false,
+    relativeImagePath,
+    publishedAt,
+    modifiedAt,
+    overwrite = false
+  } = input;
+  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.");
+  }
+  const shouldIncludeRelativeImage = includeRelativeImageExample || Boolean(relativeImagePath);
+  const relativeImage = shouldIncludeRelativeImage ? resolveRelativeImagePath(appSlug, slug, relativeImagePath) : void 0;
+  const output = {
+    slug,
+    baseDir: path8.join(publicDir, "blogs", appSlug, slug),
+    files: [],
+    coverImage: coverImage && coverImage.trim().length > 0 ? coverImage.trim() : `/products/${appSlug}/og-image.png`,
+    metaByLocale: {}
+  };
+  const plannedFiles = targetLocales.map(
+    (locale) => getBlogOutputPaths({
+      appSlug,
+      slug,
+      locale,
+      publicDir
+    })
+  );
+  const existing = plannedFiles.filter(
+    ({ filePath }) => fs7.existsSync(filePath)
+  );
+  if (existing.length > 0 && !overwrite) {
+    const existingList = existing.map((f) => f.filePath).join("\n- ");
+    throw new Error(
+      `Blog HTML already exists. Set overwrite=true to replace:
+- ${existingList}`
+    );
+  }
+  fs7.mkdirSync(output.baseDir, { recursive: true });
+  for (const locale of targetLocales) {
+    const { filePath } = getBlogOutputPaths({
+      appSlug,
+      slug,
+      locale,
+      publicDir
+    });
+    const meta = buildBlogMeta({
+      title: resolvedTitle,
+      description,
+      appSlug,
+      slug,
+      locale,
+      topic,
+      coverImage,
+      tags,
+      publishedAt,
+      modifiedAt
+    });
+    output.coverImage = meta.coverImage;
+    output.metaByLocale[locale] = meta;
+    const html = buildBlogHtmlDocument({
+      meta,
+      topic,
+      appSlug,
+      includeRelativeImageExample: shouldIncludeRelativeImage,
+      relativeImagePath: relativeImage
+    });
+    fs7.writeFileSync(filePath, html, "utf-8");
+    output.files.push({ locale, path: filePath });
+  }
+  const summaryLines = [
+    `Created blog HTML for ${appSlug}`,
+    `Slug: ${slug}`,
+    `Locales: ${targetLocales.join(", ")}`,
+    `Cover image: ${output.coverImage}`,
+    "",
+    "Files:",
+    ...output.files.map((file) => `- ${file.locale}: ${file.path}`)
+  ];
+  return {
+    content: [
+      {
+        type: "text",
+        text: summaryLines.join("\n")
+      }
+    ]
+  };
+}
+
 // src/tools/index.ts
 var tools = [
   {
@@ -1922,6 +2316,14 @@ var tools = [
     zodSchema: initProjectInputSchema,
     handler: handleInitProject,
     category: "Setup"
+  },
+  {
+    name: createBlogHtmlTool.name,
+    description: createBlogHtmlTool.description,
+    inputSchema: createBlogHtmlTool.inputSchema,
+    zodSchema: createBlogHtmlInputSchema,
+    handler: handleCreateBlogHtml,
+    category: "Content"
   }
 ];
 function getToolDefinitions() {
@@ -1929,7 +2331,8 @@ function getToolDefinitions() {
     asoToPublicTool,
     publicToAsoTool,
     improvePublicTool,
-    initProjectTool
+    initProjectTool,
+    createBlogHtmlTool
   ];
 }
 function getToolHandler(name) {

package/dist/index.d.ts

@@ -1,3 +1,6 @@
+import { androidpublisher_v3 } from '@googleapis/androidpublisher';
+import { AppStoreVersionAttributes, AppStoreVersionLocalizationAttributes, AppInfoLocalizationAttributes, ScreenshotDisplayType } from 'appstore-connect-sdk/openapi';
+
 /**
  * Unified locale system for ASO (App Store Optimization)
  * Consolidates App Store Connect and Google Play Console locale codes
@@ -70,21 +73,32 @@ declare function isAppStoreLocale(locale: string): locale is AppStoreLocale;
  * Check if locale is supported by Google Play
  */
 declare function isGooglePlayLocale(locale: string): locale is GooglePlayLocale;
+/**
+ * Google Play Android Publisher base types
+ */
+type GooglePlayListing = androidpublisher_v3.Schema$Listing;
+type GooglePlayImageType = NonNullable<androidpublisher_v3.Params$Resource$Edits$Images$List["imageType"]>;
+type GooglePlayScreenshotType = Extract<GooglePlayImageType, "phoneScreenshots" | "sevenInchScreenshots" | "tenInchScreenshots" | "tvScreenshots" | "wearScreenshots">;
+/**
+ * Google Play screenshots keyed by Android Publisher imageType
+ * Includes legacy aliases for existing data structures
+ */
+interface GooglePlayScreenshots extends Partial<Record<GooglePlayScreenshotType, string[]>> {
+    phone?: string[];
+    tablet?: string[];
+    tablet7?: string[];
+    tablet10?: string[];
+    tv?: string[];
+    wear?: string[];
+}
 /**
  * Google Play Store ASO data
  */
-interface GooglePlayAsoData {
-    title: string;
-    shortDescription: string;
-    fullDescription: string;
-    screenshots: {
-        phone: string[];
-        tablet?: string[];
-        tablet7?: string[];
-        tablet10?: string[];
-        tv?: string[];
-        wear?: string[];
-    };
+interface GooglePlayAsoData extends Pick<GooglePlayListing, "video" | "language"> {
+    title: NonNullable<GooglePlayListing["title"]>;
+    shortDescription: NonNullable<GooglePlayListing["shortDescription"]>;
+    fullDescription: NonNullable<GooglePlayListing["fullDescription"]>;
+    screenshots: GooglePlayScreenshots;
     featureGraphic?: string;
     promoGraphic?: string;
     category?: string;
@@ -99,59 +113,57 @@ interface GooglePlayAsoData {
 /**
  * Google Play release notes (per version)
  */
-interface GooglePlayReleaseNote {
-    versionCode: number;
-    versionName: string;
-    releaseNotes: {
-        [language: string]: string;
-    };
-    track: string;
-    status: string;
-    releaseDate?: string;
-}
+type GooglePlayReleaseNote = androidpublisher_v3.Schema$TrackRelease;
 /**
  * App Store release notes (per version)
  */
-interface AppStoreReleaseNote {
-    versionString: string;
-    releaseNotes: {
-        [locale: string]: string;
-    };
-    platform: string;
+type AppStoreReleaseNote = Pick<AppStoreVersionAttributes, "versionString" | "platform"> & {
+    releaseNotes: Record<string, NonNullable<AppStoreVersionLocalizationAttributes["whatsNew"]>>;
     releaseDate?: string;
+};
+/**
+ * App Store Connect base types
+ */
+type AppStoreInfoLocalization = AppInfoLocalizationAttributes;
+type AppStoreVersionLocalization = AppStoreVersionLocalizationAttributes;
+type AppStoreScreenshotDisplayType = ScreenshotDisplayType;
+/**
+ * App Store screenshots keyed by official display type
+ * Includes legacy aliases used in existing data structures
+ */
+interface AppStoreScreenshots extends Partial<Record<AppStoreScreenshotDisplayType, string[]>> {
+    iphone65?: string[];
+    iphone61?: string[];
+    iphone58?: string[];
+    iphone55?: string[];
+    iphone47?: string[];
+    iphone40?: string[];
+    ipadPro129?: string[];
+    ipadPro11?: string[];
+    ipad105?: string[];
+    ipad97?: string[];
+    appleWatch?: string[];
 }
 /**
  * App Store ASO data
  */
 interface AppStoreAsoData {
-    name: string;
-    subtitle?: string;
-    description: string;
-    keywords?: string;
-    promotionalText?: string;
-    screenshots: {
-        iphone65?: string[];
-        iphone61?: string[];
-        iphone58?: string[];
-        iphone55?: string[];
-        iphone47?: string[];
-        iphone40?: string[];
-        ipadPro129?: string[];
-        ipadPro11?: string[];
-        ipad105?: string[];
-        ipad97?: string[];
-        appleWatch?: string[];
-    };
+    name: NonNullable<AppStoreInfoLocalization["name"]>;
+    subtitle?: AppStoreInfoLocalization["subtitle"];
+    description: NonNullable<AppStoreVersionLocalization["description"]>;
+    keywords?: AppStoreVersionLocalization["keywords"];
+    promotionalText?: AppStoreVersionLocalization["promotionalText"];
+    screenshots: AppStoreScreenshots;
     appPreview?: string[];
     primaryCategory?: string;
     secondaryCategory?: string;
     contentRightId?: string;
-    supportUrl?: string;
-    marketingUrl?: string;
-    privacyPolicyUrl?: string;
+    supportUrl?: AppStoreVersionLocalization["supportUrl"];
+    marketingUrl?: AppStoreVersionLocalization["marketingUrl"];
+    privacyPolicyUrl?: AppStoreInfoLocalization["privacyPolicyUrl"];
     bundleId: string;
-    locale: string;
-    whatsNew?: string;
+    locale: NonNullable<AppStoreVersionLocalization["locale"]>;
+    whatsNew?: AppStoreVersionLocalization["whatsNew"];
 }
 /**
  * Multilingual Google Play ASO data
@@ -192,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;
@@ -354,6 +421,136 @@ 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
+ */
+/**
+ * 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;
+    slug: string;
+    locale: string;
+    publishedAt: string;
+    modifiedAt: string;
+    coverImage: string;
+    tags: string[];
+}
+interface CreateBlogHtmlInput {
+    /**
+     * Product/app slug used for paths and CTAs
+     */
+    appSlug: string;
+    /**
+     * English title used for slug creation and H1
+     */
+    title?: string;
+    /**
+     * Topic/angle to cover inside the article body
+     */
+    topic: string;
+    /**
+     * Single locale to generate (default en-US). Ignored when locales[] is provided.
+     */
+    locale?: string;
+    /**
+     * Optional list of locales to generate. Each gets its own HTML file.
+     */
+    locales?: string[];
+    /**
+     * Meta description override. If absent, a locale-aware summary is generated from topic/appSlug.
+     */
+    description?: string;
+    /**
+     * Optional tags for BLOG_META. If absent, tags are derived from topic and appSlug.
+     */
+    tags?: string[];
+    /**
+     * Optional cover image. Relative paths are rewritten to /blogs/<app>/<slug>/...
+     */
+    coverImage?: string;
+    /**
+     * Include a relative image example in the body (./images/hero.png by default).
+     */
+    includeRelativeImageExample?: boolean;
+    /**
+     * Override the relative image path used when includeRelativeImageExample is true.
+     */
+    relativeImagePath?: string;
+    /**
+     * Publish date (YYYY-MM-DD). Defaults to today.
+     */
+    publishedAt?: string;
+    /**
+     * Last modified date (YYYY-MM-DD). Defaults to publishedAt.
+     */
+    modifiedAt?: string;
+    /**
+     * Overwrite existing HTML files when true (default false).
+     */
+    overwrite?: boolean;
+}
+interface GeneratedBlogFile {
+    locale: string;
+    path: string;
+}
+interface CreateBlogHtmlResult {
+    slug: string;
+    baseDir: string;
+    files: GeneratedBlogFile[];
+    coverImage: string;
+    metaByLocale: Record<string, BlogMetaOutput>;
+}
+
 /**
  * Locale conversion utilities for ASO platforms
  * Handles conversion between unified locales and platform-specific locale codes
@@ -609,4 +806,4 @@ declare function getPublicDir(): string;
  */
 declare function getProductsDir(): string;
 
-export { APP_STORE_TO_UNIFIED, type AppMetaLinks, type AppPageData, type AppStoreAsoData, type AppStoreLocale, type AppStoreMultilingualAsoData, type AppStoreReleaseNote, type AsoData, type AsoLocaleContent, type AsoTemplate, DEFAULT_LOCALE, type DeepPartial, type FeatureItem, GOOGLE_PLAY_TO_UNIFIED, type GooglePlayAsoData, type GooglePlayLocale, type GooglePlayMultilingualAsoData, type GooglePlayReleaseNote, 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.0.0",
+  "version": "1.1.1",
   "type": "module",
   "description": "MCP server for ASO data management with shared types and utilities",
   "author": "skyu",
@@ -39,7 +39,9 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
+    "@googleapis/androidpublisher": "^33.2.0",
     "@modelcontextprotocol/sdk": "^1.22.0",
+    "appstore-connect-sdk": "^1.3.2",
     "zod": "^3.25.76",
     "zod-to-json-schema": "^3.25.0"
   },