pabal-web-mcp 0.1.6 → 1.1.0

package/README.md

@@ -1,6 +1,10 @@
 # pabal-web-mcp
 
-MCP (Model Context Protocol) server for ASO (App Store Optimization) data management with shared types and utilities.
+MCP (Model Context Protocol) server for bidirectional conversion between ASO (App Store Optimization) and web SEO data.
+
+This library enables seamless reuse of ASO data for web SEO purposes, allowing you to convert ASO metadata directly into web SEO content and vice versa.
+
+[![한국어 docs](https://img.shields.io/badge/docs-Korean-green)](./i18n/README.ko.md)
 
 ## 🛠️ MCP Client Installation
 
@@ -12,18 +16,6 @@ MCP (Model Context Protocol) server for ASO (App Store Optimization) data manage
 > [!TIP]
 > If you repeatedly do ASO/store tasks, add a client rule like "always use pabal-web-mcp" so the MCP server auto-invokes without typing it every time.
 
-### Global install (recommended)
-
-```bash
-npm install -g pabal-web-mcp
-
-# or
-
-yarn global add pabal-web-mcp
-```
-
-Install globally first for fastest starts and to avoid npm download issues (proxy/firewall/offline). You can still use `npx -y pabal-web-mcp`, but global install is recommended. After global install, set your MCP config to `command: "pabal-web-mcp"` (no `npx` needed).
-
 <details>
 <summary><b>Install in Cursor</b></summary>
 
@@ -235,6 +227,8 @@ console.log(asoData.googlePlay?.title);
 
 ## Supported Locales
 
+Supports all languages supported by each store.
+
 | Unified | App Store | Google Play |
 | ------- | --------- | ----------- |
 | en-US   | en-US     | en-US       |
@@ -251,3 +245,17 @@ console.log(asoData.googlePlay?.title);
 ## License
 
 MIT
+
+---
+
+<br>
+
+## 🌐 Pabal Web
+
+Want to manage ASO and SEO together? Check out **Pabal Web**.
+
+[![Pabal Web](public/pabal-web.png)](https://pabal.quartz.best/)
+
+**Pabal Web** is a Next.js-based web interface that provides a complete solution for unified management of ASO, SEO, Google Search Console indexing, and more.
+
+👉 [Visit Pabal Web](https://pabal.quartz.best/)

package/dist/bin/mcp-server.js

@@ -15,7 +15,7 @@ import {
   saveAsoToAsoDir,
   unifiedToAppStore,
   unifiedToGooglePlay
-} from "../chunk-YPDLNPLX.js";
+} from "../chunk-OCOFNMN2.js";
 
 // src/bin/mcp-server.ts
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
@@ -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)) {
@@ -1889,6 +1890,382 @@ 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",
+  target: "openApi3",
+  $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 +2299,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 +2314,8 @@ function getToolDefinitions() {
     asoToPublicTool,
     publicToAsoTool,
     improvePublicTool,
-    initProjectTool
+    initProjectTool,
+    createBlogHtmlTool
   ];
 }
 function getToolHandler(name) {