pabal-web-mcp 1.3.1 → 1.3.3

package/dist/bin/mcp-server.js

@@ -2448,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, {
@@ -2489,9 +2492,10 @@ function buildTemplate({
         "Discover competitors: search_app(term=seed keyword), get_similar_apps(appId=known competitor).",
         "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 and fetch_reviews on top apps for language/tone cues."
+        "Context check: analyze_reviews and fetch_reviews 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."
       ],
-      note: "Run per platform/country. Save raw tool outputs plus curated top keywords."
+      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: {
@@ -2513,7 +2517,7 @@ function buildTemplate({
       summary: {
         recommendedKeywords: [],
         rationale: "",
-        nextActions: "Feed top 10\u201315 into improve-public Stage 1."
+        nextActions: "Feed 10\u201315 mixed keywords (core/mid/longtail) into improve-public Stage 1."
       }
     }
   };
@@ -2545,7 +2549,8 @@ async function handleKeywordResearch(input) {
     competitorApps = [],
     filename,
     writeTemplate = false,
-    researchData
+    researchData,
+    researchDataPath
   } = input;
   const { config, locales } = loadProductLocales(slug);
   const primaryLocale = resolvePrimaryLocale(config, locales);
@@ -2608,16 +2613,34 @@ async function handleKeywordResearch(input) {
   const fileName = filename || defaultFileName;
   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,
@@ -2687,7 +2710,10 @@ async function handleKeywordResearch(input) {
     `6) Context check: analyze_reviews and fetch_reviews on top apps to harvest native phrasing; keep snippets for improve-public.`
   );
   lines.push(
-    `7) 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 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.`
   );
   if (fileAction) {
     lines.push(`File: ${fileAction} at ${outputPath}`);

package/package.json

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