pabal-web-mcp 1.3.4 → 1.3.6

package/dist/bin/mcp-server.js

@@ -2380,6 +2380,8 @@ import fs11 from "fs";
 import path11 from "path";
 import { z as z6 } from "zod";
 import { zodToJsonSchema as zodToJsonSchema6 } from "zod-to-json-schema";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
 
 // src/utils/registered-apps.util.ts
 import fs10 from "fs";
@@ -2413,45 +2415,28 @@ function findRegisteredApp(slug, filePath) {
   const app = apps.find((a) => a.slug === slug);
   return { app, path: usedPath };
 }
-function getSupportedLocalesForSlug(slug, platform, filePath) {
-  const { app, path: usedPath } = findRegisteredApp(slug, filePath);
-  if (!app) return { supportedLocales: [], path: usedPath };
-  if (platform === "ios") {
-    return {
-      supportedLocales: app.appStore?.supportedLocales || [],
-      path: usedPath
-    };
-  }
-  return {
-    supportedLocales: app.googlePlay?.supportedLocales || [],
-    path: usedPath
-  };
-}
 
 // src/tools/keyword-research.ts
 var TOOL_NAME = "keyword-research";
 var keywordResearchInputSchema = z6.object({
   slug: z6.string().trim().describe("Product slug"),
-  locale: z6.string().trim().describe("Locale code (e.g., en-US, ko-KR). Used for storage under .aso/keywordResearch/products/[slug]/locales/."),
+  locale: z6.string().trim().describe(
+    "Locale code (e.g., en-US, ko-KR). Stored under .aso/keywordResearch/products/[slug]/locales/."
+  ),
   platform: z6.enum(["ios", "android"]).default("ios").describe("Store to target ('ios' or 'android'). Run separately per platform."),
   country: z6.string().length(2).optional().describe(
     "Two-letter store country code. If omitted, derived from locale region (e.g., ko-KR -> kr), else 'us'."
   ),
-  seedKeywords: z6.array(z6.string().trim()).default([]).describe("Seed keywords to start from."),
+  seedKeywords: z6.array(z6.string().trim()).default([]),
   competitorApps: z6.array(
     z6.object({
       appId: z6.string().trim().describe("App ID (package name or iOS ID/bundle)"),
       platform: z6.enum(["ios", "android"])
     })
-  ).default([]).describe("Known competitor apps to probe."),
-  filename: z6.string().trim().optional().describe("Override output filename. Defaults to keyword-research-[platform]-[country].json"),
-  writeTemplate: z6.boolean().default(false).describe("If true, write a JSON template at the output path."),
-  researchData: z6.string().trim().optional().describe(
-    "Optional JSON string with research results (e.g., from mcp-appstore tools). If provided, saves it to the output path."
-  ),
-  researchDataPath: z6.string().trim().optional().describe(
-    "Optional path to a JSON file containing research results. If set, file content is saved to the output path (preferred to avoid escape errors)."
-  )
+  ).default([]),
+  serverCwd: z6.string().trim().optional().describe("Path to mcp-appstore cwd (default: external-tools/mcp-appstore)"),
+  serverCommand: z6.array(z6.string()).optional().describe("Command + args to start mcp-appstore (default: ['node','server.js'])"),
+  numSuggestions: z6.number().int().positive().max(50).default(20).describe("Number of keyword suggestions per strategy (default: 20)")
 });
 var jsonSchema6 = zodToJsonSchema6(keywordResearchInputSchema, {
   name: "KeywordResearchInput",
@@ -2460,86 +2445,28 @@ var jsonSchema6 = zodToJsonSchema6(keywordResearchInputSchema, {
 var inputSchema6 = jsonSchema6.definitions?.KeywordResearchInput || jsonSchema6;
 var keywordResearchTool = {
   name: TOOL_NAME,
-  description: `Prep + persist keyword research ahead of improve-public using mcp-appstore outputs.
-
-Run this before improve-public. It gives a concrete MCP-powered research plan and a storage path under .aso/keywordResearch/products/[slug]/locales/[locale]/. Optionally writes a template or saves raw JSON from mcp-appstore tools.`,
+  description: "Runs mcp-appstore calls to collect 10\u201315 keywords per locale and saves to .aso/keywordResearch/products/[slug]/locales/[locale]/keyword-research-[platform]-[country].json.",
   inputSchema: inputSchema6
 };
-function buildTemplate({
-  slug,
-  locale,
-  platform,
-  country,
-  seedKeywords,
-  competitorApps
-}) {
-  const timestamp = (/* @__PURE__ */ new Date()).toISOString();
-  return {
-    meta: {
-      slug,
-      locale,
-      platform,
-      country,
-      seedKeywords,
-      competitorApps,
-      source: "mcp-appstore",
-      updatedAt: timestamp
-    },
-    plan: {
-      steps: [
-        "Start mcp-appstore server (node server.js in external-tools/mcp-appstore).",
-        "Confirm app IDs/locales: get_app_details(appId from config/registered-apps) to lock country/lang and 3\u20135 competitors.",
-        "Discover competitors: search_app(term=seed keyword, num=10\u201320), get_similar_apps(appId=top competitor, num=10).",
-        "Collect candidates (all of these, num=20\u201330): suggest_keywords_by_seeds/by_category/by_similarity/by_competition/by_search; suggest_keywords_by_apps(apps=[top competitors]).",
-        "Score shortlist: get_keyword_scores for 15\u201330 candidates per platform/country.",
-        "Context check: analyze_reviews (num=100\u2013200) and fetch_reviews (num=50\u2013100) on top apps for language/tone cues.",
-        "If keywordSuggestions/similar/reviews are sparse, rerun calls (add more competitors/seeds) until you have 10\u201315 strong keywords.",
-        "For any recommended keyword without scores, rerun get_keyword_scores to fill traffic/difficulty.",
-        "Keep rationale/nextActions in English by default unless you intentionally localize them."
-      ],
-      note: "Run per platform/country. Save raw tool outputs plus curated top keywords (target 10\u201315 per locale: 2\u20133 high-traffic core, 4\u20136 mid-competition, 4\u20136 longtail)."
-    },
-    data: {
-      raw: {
-        searchApp: [],
-        getAppDetails: [],
-        similarApps: [],
-        keywordSuggestions: {
-          bySeeds: [],
-          byCategory: [],
-          bySimilarity: [],
-          byCompetition: [],
-          bySearchHints: [],
-          byApps: []
-        },
-        keywordScores: [],
-        reviewsAnalysis: [],
-        reviewsRaw: []
-      },
-      summary: {
-        recommendedKeywords: [],
-        rationale: "",
-        nextActions: "Feed 10\u201315 mixed keywords (core/mid/longtail) into improve-public Stage 1."
-      }
-    }
-  };
-}
-function saveJsonFile({
-  researchDir,
-  fileName,
-  payload
-}) {
-  fs11.mkdirSync(researchDir, { recursive: true });
-  const outputPath = path11.join(researchDir, fileName);
-  fs11.writeFileSync(outputPath, JSON.stringify(payload, null, 2) + "\n", "utf-8");
-  return outputPath;
-}
 function normalizeKeywords(raw) {
   if (!raw) return [];
   if (Array.isArray(raw)) {
-    return raw.map((k) => k.trim()).filter((k) => k.length > 0);
+    return raw.map((k) => k.trim()).filter(Boolean);
+  }
+  return raw.split(",").map((k) => k.trim()).filter(Boolean);
+}
+async function callToolJSON(client, name, args) {
+  const result = await client.callTool({ name, arguments: args });
+  const text = result.content?.[0]?.text;
+  if (!text) return null;
+  try {
+    return JSON.parse(text);
+  } catch {
+    return text;
   }
-  return raw.split(",").map((k) => k.trim()).filter((k) => k.length > 0);
+}
+function ensureDir(dir) {
+  fs11.mkdirSync(dir, { recursive: true });
 }
 async function handleKeywordResearch(input) {
   const {
@@ -2549,34 +2476,28 @@ async function handleKeywordResearch(input) {
     country,
     seedKeywords = [],
     competitorApps = [],
-    filename,
-    writeTemplate = false,
-    researchData,
-    researchDataPath
+    serverCwd,
+    serverCommand,
+    numSuggestions = 20
   } = input;
   const { config, locales } = loadProductLocales(slug);
   const primaryLocale = resolvePrimaryLocale(config, locales);
   const primaryLocaleData = locales[primaryLocale];
-  const { app: registeredApp, path: registeredPath } = findRegisteredApp(slug);
-  const { supportedLocales, path: supportedPath } = getSupportedLocalesForSlug(slug, platform);
+  const { app: registeredApp } = findRegisteredApp(slug);
+  const resolvedCountry = country || (locale.includes("-") ? locale.split("-")[1].toLowerCase() : "us");
   const autoSeeds = [];
-  const autoCompetitors = [];
-  if (primaryLocaleData?.aso?.title) {
-    autoSeeds.push(primaryLocaleData.aso.title);
-  }
+  if (primaryLocaleData?.aso?.title) autoSeeds.push(primaryLocaleData.aso.title);
   const parsedKeywords = normalizeKeywords(primaryLocaleData?.aso?.keywords);
   autoSeeds.push(...parsedKeywords.slice(0, 5));
   if (config?.name) autoSeeds.push(config.name);
   if (config?.tagline) autoSeeds.push(config.tagline);
-  if (!config?.name && registeredApp?.name) autoSeeds.push(registeredApp.name);
-  if (!primaryLocaleData?.aso?.title) {
-    if (platform === "ios" && registeredApp?.appStore?.name) {
-      autoSeeds.push(registeredApp.appStore.name);
-    }
-    if (platform === "android" && registeredApp?.googlePlay?.name) {
-      autoSeeds.push(registeredApp.googlePlay.name);
-    }
-  }
+  if (registeredApp?.name) autoSeeds.push(registeredApp.name);
+  if (platform === "ios" && registeredApp?.appStore?.name)
+    autoSeeds.push(registeredApp.appStore.name);
+  if (platform === "android" && registeredApp?.googlePlay?.name)
+    autoSeeds.push(registeredApp.googlePlay.name);
+  const seeds = Array.from(/* @__PURE__ */ new Set([...seedKeywords, ...autoSeeds])).slice(0, 10);
+  const autoCompetitors = [];
   if (platform === "ios") {
     if (config?.appStoreAppId) {
       autoCompetitors.push({ appId: String(config.appStoreAppId), platform });
@@ -2593,17 +2514,212 @@ async function handleKeywordResearch(input) {
         platform
       });
     }
-  } else if (platform === "android" && config?.packageName) {
-    autoCompetitors.push({ appId: config.packageName, platform });
-  } else if (platform === "android" && registeredApp?.googlePlay?.packageName) {
-    autoCompetitors.push({
-      appId: registeredApp.googlePlay.packageName,
-      platform
+  } else {
+    if (config?.packageName) {
+      autoCompetitors.push({ appId: config.packageName, platform });
+    } else if (registeredApp?.googlePlay?.packageName) {
+      autoCompetitors.push({
+        appId: registeredApp.googlePlay.packageName,
+        platform
+      });
+    }
+  }
+  const competitors = Array.from(
+    new Map(
+      [...competitorApps, ...autoCompetitors].map((c) => [
+        `${c.platform}:${c.appId}`,
+        c
+      ])
+    ).values()
+  ).slice(0, 5);
+  const cwd = serverCwd || path11.resolve(process.cwd(), "external-tools", "mcp-appstore");
+  const cmd = serverCommand?.[0] || "node";
+  const args = serverCommand?.length ? serverCommand.slice(1) : ["server.js"];
+  const transport = new StdioClientTransport({ command: cmd, args, cwd });
+  const client = new Client(
+    { name: "keyword-research", version: "1.0.0" },
+    { capabilities: { tools: {} } }
+  );
+  await client.connect(transport);
+  const raw = {
+    searchApp: [],
+    getAppDetails: [],
+    similarApps: [],
+    keywordSuggestions: {
+      bySeeds: [],
+      byCategory: [],
+      bySimilarity: [],
+      byCompetition: [],
+      bySearchHints: [],
+      byApps: []
+    },
+    keywordScores: [],
+    reviewsAnalysis: [],
+    reviewsRaw: []
+  };
+  for (const term of seeds.slice(0, 3)) {
+    const res = await callToolJSON(client, "search_app", {
+      term,
+      platform,
+      num: 20,
+      country: resolvedCountry
+    });
+    raw.searchApp.push({
+      query: term,
+      platform,
+      country: resolvedCountry,
+      results: res?.results ?? res
+    });
+  }
+  for (const comp of competitors.slice(0, 5)) {
+    const res = await callToolJSON(client, "get_app_details", {
+      appId: comp.appId,
+      platform: comp.platform,
+      country: resolvedCountry
+    });
+    raw.getAppDetails.push(res);
+  }
+  if (competitors.length > 0) {
+    const first = competitors[0];
+    const res = await callToolJSON(client, "get_similar_apps", {
+      appId: first.appId,
+      platform,
+      num: 10,
+      country: resolvedCountry
+    });
+    raw.similarApps = res?.similarApps || res || [];
+  }
+  const firstComp = competitors[0]?.appId;
+  const appsList = competitors.map((c) => c.appId);
+  const suggestCalls = [
+    [
+      "suggest_keywords_by_seeds",
+      {
+        keywords: seeds,
+        platform,
+        num: numSuggestions,
+        country: resolvedCountry
+      },
+      "bySeeds"
+    ],
+    [
+      "suggest_keywords_by_category",
+      firstComp ? {
+        appId: firstComp,
+        platform,
+        num: numSuggestions,
+        country: resolvedCountry
+      } : null,
+      "byCategory"
+    ],
+    [
+      "suggest_keywords_by_similarity",
+      firstComp ? {
+        appId: firstComp,
+        platform,
+        num: numSuggestions,
+        country: resolvedCountry
+      } : null,
+      "bySimilarity"
+    ],
+    [
+      "suggest_keywords_by_competition",
+      firstComp ? {
+        appId: firstComp,
+        platform,
+        num: numSuggestions,
+        country: resolvedCountry
+      } : null,
+      "byCompetition"
+    ],
+    [
+      "suggest_keywords_by_search",
+      {
+        keywords: seeds.slice(0, 5),
+        platform,
+        num: numSuggestions,
+        country: resolvedCountry
+      },
+      "bySearchHints"
+    ],
+    [
+      "suggest_keywords_by_apps",
+      appsList.length ? {
+        apps: appsList,
+        platform,
+        num: numSuggestions,
+        country: resolvedCountry
+      } : null,
+      "byApps"
+    ]
+  ];
+  for (const [tool, args2, key] of suggestCalls) {
+    if (!args2) continue;
+    const res = await callToolJSON(client, tool, args2);
+    const suggestions = res?.suggestions || res || [];
+    raw.keywordSuggestions[key] = suggestions;
+  }
+  for (const comp of competitors.slice(0, 2)) {
+    const analysis = await callToolJSON(client, "analyze_reviews", {
+      appId: comp.appId,
+      platform: comp.platform,
+      country: resolvedCountry,
+      num: 150
+    });
+    raw.reviewsAnalysis.push(analysis);
+    const rawReviews = await callToolJSON(client, "fetch_reviews", {
+      appId: comp.appId,
+      platform: comp.platform,
+      country: resolvedCountry,
+      num: 80
+    });
+    raw.reviewsRaw.push(rawReviews);
+  }
+  const candidateSet = /* @__PURE__ */ new Set();
+  const addCandidates = (arr) => {
+    if (!arr) return;
+    if (Array.isArray(arr)) {
+      arr.forEach((v) => {
+        if (typeof v === "string") candidateSet.add(v);
+        if (v?.keyword) candidateSet.add(String(v.keyword));
+        if (v?.suggestions) addCandidates(v.suggestions);
+      });
+    }
+  };
+  seeds.forEach((s) => candidateSet.add(s));
+  Object.values(raw.keywordSuggestions).forEach((arr) => addCandidates(arr));
+  const candidates = Array.from(candidateSet).slice(0, 30);
+  for (const kw of candidates) {
+    const res = await callToolJSON(client, "get_keyword_scores", {
+      keyword: kw,
+      platform,
+      country: resolvedCountry
     });
+    raw.keywordScores.push(res);
   }
-  const resolvedSeeds = seedKeywords.length > 0 ? seedKeywords : Array.from(new Set(autoSeeds));
-  const resolvedCompetitors = competitorApps.length > 0 ? competitorApps : autoCompetitors;
-  const resolvedCountry = country || (locale?.includes("-") ? locale.split("-")[1].toLowerCase() : "us");
+  const scored = raw.keywordScores.map((s) => {
+    const trafficScore = typeof s?.scores?.traffic?.score === "number" ? s.scores.traffic.score : parseFloat(s?.traffic?.score ?? s?.scores?.traffic?.score ?? "0") || 0;
+    const difficultyScore = typeof s?.scores?.difficulty?.score === "number" ? s.scores.difficulty.score : parseFloat(
+      s?.difficulty?.score ?? s?.scores?.difficulty?.score ?? "0"
+    ) || 0;
+    return {
+      keyword: s.keyword || s?.scores?.keyword,
+      trafficScore,
+      difficultyScore,
+      raw: s
+    };
+  }).filter((s) => s.keyword);
+  const recommended = scored.sort((a, b) => b.trafficScore - a.trafficScore).slice(0, 15);
+  const summary = {
+    recommendedKeywords: recommended.map((r) => ({
+      keyword: r.keyword,
+      trafficScore: r.trafficScore,
+      difficultyScore: r.difficultyScore
+    })),
+    rationale: "Sorted by traffic score (desc). Blend of core/high-traffic and mid/longtail technical terms.",
+    nextActions: "Feed top 10\u201315 into improve-public Stage 1. If any sections are empty (suggestions/reviews), add more competitors/seeds and rerun."
+  };
+  await client.close();
   const researchDir = path11.join(
     getKeywordResearchDir(),
     "products",
@@ -2611,134 +2727,52 @@ async function handleKeywordResearch(input) {
     "locales",
     locale
   );
-  const defaultFileName = `keyword-research-${platform}-${resolvedCountry}.json`;
-  const fileName = filename || defaultFileName;
-  let outputPath = path11.join(researchDir, fileName);
-  let fileAction;
-  const parseJsonWithContext = (text) => {
-    try {
-      return JSON.parse(text);
-    } catch (err) {
-      const message = err instanceof Error ? err.message : String(err);
-      const match = /position (\d+)/i.exec(message) || /column (\d+)/i.exec(message) || /char (\d+)/i.exec(message);
-      if (match) {
-        const pos = Number(match[1]);
-        const start = Math.max(0, pos - 40);
-        const end = Math.min(text.length, pos + 40);
-        const context = text.slice(start, end);
-        throw new Error(
-          `Failed to parse researchData JSON: ${message}
-Context around ${pos}: ${context}`
-        );
-      }
-      throw new Error(`Failed to parse researchData JSON: ${message}`);
-    }
-  };
-  const loadResearchDataFromPath = (p) => {
-    if (!fs11.existsSync(p)) {
-      throw new Error(`researchDataPath not found: ${p}`);
-    }
-    const raw = fs11.readFileSync(p, "utf-8");
-    return parseJsonWithContext(raw);
-  };
-  if (writeTemplate || researchData) {
-    const payload = researchData ? parseJsonWithContext(researchData) : researchDataPath ? loadResearchDataFromPath(researchDataPath) : buildTemplate({
-      slug,
-      locale,
-      platform,
-      country: resolvedCountry,
-      seedKeywords: resolvedSeeds,
-      competitorApps: resolvedCompetitors
-    });
-    outputPath = saveJsonFile({ researchDir, fileName, payload });
-    fileAction = researchData ? "Saved provided researchData" : "Wrote template";
-  }
-  const templatePreview = JSON.stringify(
-    buildTemplate({
+  ensureDir(researchDir);
+  const fileName = `keyword-research-${platform}-${resolvedCountry}.json`;
+  const outputPath = path11.join(researchDir, fileName);
+  const payload = {
+    meta: {
       slug,
       locale,
       platform,
       country: resolvedCountry,
-      seedKeywords: resolvedSeeds,
-      competitorApps: resolvedCompetitors
-    }),
-    null,
-    2
-  );
+      seedKeywords: seeds,
+      competitorApps: competitors,
+      source: "mcp-appstore",
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+    },
+    plan: {
+      steps: [
+        "Start mcp-appstore server (node server.js in external-tools/mcp-appstore).",
+        "Confirm app IDs/locales: get_app_details(appId from config/registered-apps) to lock country/lang and 3\u20135 competitors.",
+        "Discover competitors: search_app(term=seed keyword, num=10\u201320), get_similar_apps(appId=top competitor, num=10).",
+        "Collect candidates (all of these, num=20\u201330): suggest_keywords_by_seeds/by_category/by_similarity/by_competition/by_search; suggest_keywords_by_apps(apps=[top competitors]).",
+        "Score shortlist: get_keyword_scores for 15\u201330 candidates per platform/country.",
+        "Context check: analyze_reviews (num=100\u2013200) and fetch_reviews (num=50\u2013100) on top apps for language/tone cues.",
+        "If keywordSuggestions/similar/reviews are sparse, rerun calls (add more competitors/seeds) until you have 10\u201315 strong keywords.",
+        "For any recommended keyword without scores, rerun get_keyword_scores to fill traffic/difficulty.",
+        "Keep rationale/nextActions in English by default unless you intentionally localize them."
+      ],
+      note: "Generated automatically by keyword-research"
+    },
+    data: { raw, summary }
+  };
+  fs11.writeFileSync(outputPath, JSON.stringify(payload, null, 2) + "\n", "utf-8");
   const lines = [];
-  lines.push(`# Keyword research plan (${slug})`);
-  lines.push(`Locale: ${locale} | Platform: ${platform} | Country: ${resolvedCountry}`);
-  lines.push(`Primary locale detected: ${primaryLocale}`);
-  if (supportedLocales.length > 0) {
-    lines.push(
-      `Registered supported locales (${platform}): ${supportedLocales.join(
-        ", "
-      )} (source: ${supportedPath})`
-    );
-    if (!supportedLocales.includes(locale)) {
-      lines.push(
-        `WARNING: locale ${locale} not in registered supported locales. Confirm this locale or update registered-apps.json.`
-      );
-    }
-  } else {
-    lines.push(
-      `Registered supported locales not found for ${platform} (checked: ${supportedPath}).`
-    );
-  }
-  lines.push(
-    `Seeds: ${resolvedSeeds.length > 0 ? resolvedSeeds.join(", ") : "(none set; add seedKeywords or ensure ASO keywords/title exist)"}`
-  );
-  lines.push(
-    `Competitors (from config if empty): ${resolvedCompetitors.length > 0 ? resolvedCompetitors.map((c) => `${c.platform}:${c.appId}`).join(", ") : "(none set; add competitorApps or set appStoreAppId/bundleId/packageName in config.json)"}`
-  );
-  lines.push("");
-  lines.push("How to run (uses mcp-appstore):");
-  lines.push(
-    `1) Start the local mcp-appstore server for this run: node server.js (cwd: /ABSOLUTE/PATH/TO/pabal-web-mcp/external-tools/mcp-appstore). LLM should start it before calling tools and stop it after, if the client supports process management; otherwise, start/stop manually.`
-  );
-  lines.push(
-    `2) Confirm IDs/locales: get_app_details(appId from config/registered-apps) to lock locale/country and competitor list.`
-  );
+  lines.push(`# keyword-research`);
+  lines.push(`Saved to ${outputPath}`);
   lines.push(
-    `3) Discover apps: search_app(term=seed, num=10-20, platform=${platform}, country=${resolvedCountry}); get_similar_apps(appId=top competitor, num=10).`
+    `Candidates scored: ${scored.length}, Recommended: ${summary.recommendedKeywords.length}`
   );
-  lines.push(
-    `4) Expand keywords (num=20-30 each): suggest_keywords_by_seeds/by_category/by_similarity/by_competition/by_search + suggest_keywords_by_apps(apps=[top competitors]).`
-  );
-  lines.push(
-    `5) Score shortlist: get_keyword_scores for 15\u201330 candidates (note: scores are heuristic per README).`
-  );
-  lines.push(
-    `6) Context check: analyze_reviews (num=100-200) and fetch_reviews (num=50-100) on top apps to harvest native phrasing; keep snippets for improve-public.`
-  );
-  lines.push(
-    `7) Save all raw responses + your final 10\u201315 keywords (mix of core/high-traffic, mid, longtail) to: ${outputPath} (structure mirrors .aso/pullData/.aso/pushData under products/<slug>/locales/<locale>)`
-  );
-  lines.push(
-    `8) If keywordSuggestions/similarApps/reviews are still empty or <10 solid candidates, add more competitors/seeds and rerun the calls above until you reach 10\u201315 strong keywords.`
-  );
-  lines.push(
-    `9) If any recommended keywords lack scores, rerun get_keyword_scores for those items. Keep rationale/nextActions in English by default unless you explicitly want them localized.`
-  );
-  if (fileAction) {
-    lines.push(`File: ${fileAction} at ${outputPath}`);
-  } else {
+  if (scored.length < 10 || summary.recommendedKeywords.length < 10 || Object.values(raw.keywordSuggestions).some(
+    (arr) => Array.isArray(arr) && arr.length === 0
+  )) {
     lines.push(
-      `Tip: set writeTemplate=true to create the JSON skeleton at ${outputPath}`
+      `Warning: results look sparse. Add more competitors/seeds and rerun.`
     );
   }
-  lines.push("");
-  lines.push("Suggested JSON shape:");
-  lines.push("```json");
-  lines.push(templatePreview);
-  lines.push("```");
   return {
-    content: [
-      {
-        type: "text",
-        text: lines.join("\n")
-      }
-    ]
+    content: [{ type: "text", text: lines.join("\n") }]
   };
 }
 

package/package.json

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