pabal-web-mcp 1.3.0 → 1.3.2

package/dist/bin/mcp-server.js

@@ -1241,6 +1241,8 @@ ${researchSections.join("\n")}
   prompt += `Apply the selected keywords to ALL fields:
 `;
   prompt += `- \`aso.title\` (\u226430): **"App Name: Primary Keyword"** format (app name in English, keyword in target language, keyword starts with uppercase after the colon)
+`;
+  prompt += `  - **Do NOT translate/rename the app name**; keep the original English app name across all locales.
 `;
   prompt += `- \`aso.subtitle\` (\u226430): Complementary keywords
 `;
@@ -1445,6 +1447,8 @@ ${researchSections.join(
   prompt += `   - Example: "Aurora EOS: \uC624\uB85C\uB77C \uC608\uBCF4" (Korean), "Aurora EOS: \u30AA\u30FC\u30ED\u30E9\u4E88\u5831" (Japanese)
 `;
   prompt += `   - The keyword after the colon must start with an uppercase letter
+`;
+  prompt += `   - **Do NOT translate/rename the app name**; keep the original English app name across all locales.
 `;
   prompt += `4. Swap keywords in sentences while keeping:
 `;
@@ -2372,10 +2376,59 @@ Writing style reference for ${locale}: Found ${posts.length} existing post(s) us
 }
 
 // src/tools/keyword-research.ts
-import fs10 from "fs";
-import path10 from "path";
+import fs11 from "fs";
+import path11 from "path";
 import { z as z6 } from "zod";
 import { zodToJsonSchema as zodToJsonSchema6 } from "zod-to-json-schema";
+
+// src/utils/registered-apps.util.ts
+import fs10 from "fs";
+import os from "os";
+import path10 from "path";
+var DEFAULT_REGISTERED_APPS_PATH = path10.join(
+  os.homedir(),
+  ".config",
+  "pabal-mcp",
+  "registered-apps.json"
+);
+function safeReadJson(filePath) {
+  if (!fs10.existsSync(filePath)) return null;
+  try {
+    const raw = fs10.readFileSync(filePath, "utf-8");
+    const parsed = JSON.parse(raw);
+    if (!parsed?.apps || !Array.isArray(parsed.apps)) {
+      return null;
+    }
+    return parsed;
+  } catch {
+    return null;
+  }
+}
+function loadRegisteredApps(filePath = DEFAULT_REGISTERED_APPS_PATH) {
+  const data = safeReadJson(filePath);
+  return { apps: data?.apps || [], path: filePath };
+}
+function findRegisteredApp(slug, filePath) {
+  const { apps, path: usedPath } = loadRegisteredApps(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"),
@@ -2395,6 +2448,9 @@ var keywordResearchInputSchema = z6.object({
   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)."
   )
 });
 var jsonSchema6 = zodToJsonSchema6(keywordResearchInputSchema, {
@@ -2431,26 +2487,31 @@ function buildTemplate({
     },
     plan: {
       steps: [
-        "Start mcp-appstore server (npm start in external-tools/mcp-appstore).",
+        "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 competitors.",
         "Discover competitors: search_app(term=seed keyword), get_similar_apps(appId=known competitor).",
-        "Collect candidates: suggest_keywords_by_seeds, suggest_keywords_by_category, suggest_keywords_by_similarity, suggest_keywords_by_competition.",
+        "Collect candidates: 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 on top apps for language/tone cues."
+        "Context check: analyze_reviews and fetch_reviews on top apps for language/tone cues."
       ],
       note: "Run per platform/country. Save raw tool outputs plus curated top keywords."
     },
     data: {
       raw: {
         searchApp: [],
+        getAppDetails: [],
+        similarApps: [],
         keywordSuggestions: {
           bySeeds: [],
           byCategory: [],
           bySimilarity: [],
           byCompetition: [],
-          bySearchHints: []
+          bySearchHints: [],
+          byApps: []
         },
         keywordScores: [],
-        reviewsAnalysis: []
+        reviewsAnalysis: [],
+        reviewsRaw: []
       },
       summary: {
         recommendedKeywords: [],
@@ -2465,9 +2526,9 @@ function saveJsonFile({
   fileName,
   payload
 }) {
-  fs10.mkdirSync(researchDir, { recursive: true });
-  const outputPath = path10.join(researchDir, fileName);
-  fs10.writeFileSync(outputPath, JSON.stringify(payload, null, 2) + "\n", "utf-8");
+  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) {
@@ -2487,11 +2548,14 @@ async function handleKeywordResearch(input) {
     competitorApps = [],
     filename,
     writeTemplate = false,
-    researchData
+    researchData,
+    researchDataPath
   } = 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 autoSeeds = [];
   const autoCompetitors = [];
   if (primaryLocaleData?.aso?.title) {
@@ -2501,19 +2565,43 @@ async function handleKeywordResearch(input) {
   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 (platform === "ios") {
     if (config?.appStoreAppId) {
       autoCompetitors.push({ appId: String(config.appStoreAppId), platform });
     } else if (config?.bundleId) {
       autoCompetitors.push({ appId: config.bundleId, platform });
+    } else if (registeredApp?.appStore?.appId) {
+      autoCompetitors.push({
+        appId: String(registeredApp.appStore.appId),
+        platform
+      });
+    } else if (registeredApp?.appStore?.bundleId) {
+      autoCompetitors.push({
+        appId: registeredApp.appStore.bundleId,
+        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
+    });
   }
   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 researchDir = path10.join(
+  const researchDir = path11.join(
     getKeywordResearchDir(),
     "products",
     slug,
@@ -2522,18 +2610,36 @@ async function handleKeywordResearch(input) {
   );
   const defaultFileName = `keyword-research-${platform}-${resolvedCountry}.json`;
   const fileName = filename || defaultFileName;
-  let outputPath = path10.join(researchDir, fileName);
+  let outputPath = path11.join(researchDir, fileName);
   let fileAction;
-  if (writeTemplate || researchData) {
-    const payload = researchData ? (() => {
-      try {
-        return JSON.parse(researchData);
-      } catch (err) {
+  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: ${err instanceof Error ? err.message : String(err)}`
+          `Failed to parse researchData JSON: ${message}
+Context around ${pos}: ${context}`
         );
       }
-    })() : buildTemplate({
+      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,
@@ -2560,6 +2666,22 @@ async function handleKeywordResearch(input) {
   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)"}`
   );
@@ -2572,19 +2694,22 @@ async function handleKeywordResearch(input) {
     `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) Discover apps: search_app(term=seed, platform=${platform}, country=${country}); get_similar_apps(appId=known competitor).`
+    `2) Confirm IDs/locales: get_app_details(appId from config/registered-apps) to lock locale/country and competitor list.`
+  );
+  lines.push(
+    `3) Discover apps: search_app(term=seed, platform=${platform}, country=${resolvedCountry}); get_similar_apps(appId=known competitor).`
   );
   lines.push(
-    `3) Expand keywords: suggest_keywords_by_seeds, suggest_keywords_by_category, suggest_keywords_by_similarity, suggest_keywords_by_competition, suggest_keywords_by_search.`
+    `4) Expand keywords: suggest_keywords_by_seeds/by_category/by_similarity/by_competition/by_search + suggest_keywords_by_apps(apps=[top competitors]).`
   );
   lines.push(
-    `4) Score shortlist: get_keyword_scores for 15\u201330 candidates (note: scores are heuristic per README).`
+    `5) Score shortlist: get_keyword_scores for 15\u201330 candidates (note: scores are heuristic per README).`
   );
   lines.push(
-    `5) Context check: analyze_reviews on top apps to harvest native phrasing; keep snippets for improve-public.`
+    `6) Context check: analyze_reviews and fetch_reviews on top apps to harvest native phrasing; keep snippets for improve-public.`
   );
   lines.push(
-    `6) Save all raw responses + your final top 10\u201315 keywords to: ${outputPath} (structure mirrors .aso/pullData/.aso/pushData under products/<slug>/locales/<locale>)`
+    `7) Save all raw responses + your final top 10\u201315 keywords to: ${outputPath} (structure mirrors .aso/pullData/.aso/pushData under products/<slug>/locales/<locale>)`
   );
   if (fileAction) {
     lines.push(`File: ${fileAction} at ${outputPath}`);

package/package.json

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