pabal-web-mcp 1.3.13 → 1.4.1

package/dist/bin/mcp-server.js

@@ -1252,6 +1252,9 @@ ${researchSections.join("\n")}
 
 `;
   }
+  prompt += `**Priority:** When both iOS and Android research exist, keep iOS keywords first and only add Android keywords if there is room after meeting character limits.
+
+`;
   prompt += `## Step 2: Optimize All Fields (${primaryLocale})
 
 `;
@@ -1445,9 +1448,12 @@ ${optimizedPrimary}
   const hasPrimaryResearch = primaryResearchSections.length > 0;
   prompt += `## Keyword Research (Per Locale)
 
+`;
+  prompt += `When both iOS and Android research exist for a locale, treat iOS keywords as primary; use Android keywords only if space remains after fitting iOS keywords within character limits.
+
 `;
   if (hasPrimaryResearch) {
-    prompt += `**\u{1F4DA} ENGLISH (${primaryLocale}) Keywords - Use as fallback for locales without research:**
+    prompt += `**\u{1F4DA} ENGLISH (${primaryLocale}) Keywords - Use as fallback for locales without research (MUST TRANSLATE to target language):**
 ${primaryResearchSections.join("\n")}
 
 `;
@@ -1466,35 +1472,42 @@ ${researchSections.join(
 
 `;
     } else if (hasPrimaryResearch) {
-      prompt += `### Locale ${loc}: \u26A0\uFE0F No saved research - USE ENGLISH (${primaryLocale}) KEYWORDS
+      prompt += `### Locale ${loc}: \u26A0\uFE0F No saved research - TRANSLATE ENGLISH KEYWORDS TO ${loc.toUpperCase()}
 `;
       prompt += `No keyword research found at ${researchDir}.
 `;
-      prompt += `**FALLBACK:** Translate English keywords from primary locale (${primaryLocale}) into ${loc}:
+      prompt += `**CRITICAL FALLBACK STRATEGY:** You MUST translate English keywords from primary locale (${primaryLocale}) into ${loc}. DO NOT use English keywords directly.
+
+`;
+      prompt += `**Translation Steps:**
+`;
+      prompt += `1. Take the Tier 1/2/3 keywords from English research above (${primaryLocale})
 `;
-      prompt += `1. Take the Tier 1/2/3 keywords from English research above
+      prompt += `2. **TRANSLATE each English keyword into ${loc}** - use natural, native expressions (NOT literal word-for-word translation)
 `;
-      prompt += `2. Translate each English keyword naturally into ${loc} (not literal translation)
+      prompt += `3. Ensure translated keywords are what ${loc} users would actually search for in their language
 `;
-      prompt += `3. Use native expressions that ${loc} users would actually search for
+      prompt += `4. Verify translations are culturally appropriate and contextually relevant
 `;
-      prompt += `4. Verify translations are culturally appropriate
+      prompt += `5. Apply the **TRANSLATED** keywords (in ${loc} language) following the same tier strategy
 `;
-      prompt += `5. Apply translated keywords following the same tier strategy
+      prompt += `6. **DO NOT use English keywords in ${loc} locale** - all keywords must be in ${loc} language
 
 `;
     } else {
-      prompt += `### Locale ${loc}: \u26A0\uFE0F No research - USE ENGLISH KEYWORDS FROM optimizedPrimary
+      prompt += `### Locale ${loc}: \u26A0\uFE0F No research - TRANSLATE ENGLISH KEYWORDS FROM optimizedPrimary TO ${loc.toUpperCase()}
 `;
-      prompt += `No keyword research found. Extract keywords from the optimizedPrimary JSON above and translate them:
+      prompt += `No keyword research found. Extract keywords from the optimizedPrimary JSON above and **TRANSLATE them to ${loc}**:
 `;
-      prompt += `1. Extract keywords from \`aso.keywords\` in optimizedPrimary
+      prompt += `1. Extract keywords from \`aso.keywords\` in optimizedPrimary (these are in English/${primaryLocale})
 `;
-      prompt += `2. Translate each English keyword naturally into ${loc}
+      prompt += `2. **TRANSLATE each English keyword naturally into ${loc}** - use native search expressions
 `;
-      prompt += `3. Use native expressions that ${loc} users would actually search for
+      prompt += `3. Ensure translated keywords match what ${loc} users would actually search for
 `;
-      prompt += `4. Apply translated keywords to all ASO fields
+      prompt += `4. Apply the **TRANSLATED** keywords (in ${loc} language) to all ASO fields
+`;
+      prompt += `5. **DO NOT use English keywords in ${loc} locale** - all keywords must be translated to ${loc}
 
 `;
     }
@@ -1503,6 +1516,8 @@ ${researchSections.join(
 
 `;
   prompt += `For EACH locale:
+`;
+  prompt += `- Priority: Keep iOS-sourced keywords first; add Android keywords only if there is remaining space after iOS keywords fit within field limits.
 `;
   prompt += `1. Take the TRANSLATED content (below)
 `;
@@ -1581,9 +1596,9 @@ ${researchSections.join(
 `;
   prompt += `Process EACH locale in this batch sequentially:
 `;
-  prompt += `1. Use saved keyword research OR translate from primary locale if missing (see fallback strategy above)
+  prompt += `1. Use saved keyword research (in target language) OR **TRANSLATE English keywords from primary locale** if missing (see fallback strategy above - MUST translate, not use English directly)
 `;
-  prompt += `2. Replace keywords in ALL fields:
+  prompt += `2. Replace keywords in ALL fields (use translated keywords in target language):
 `;
   prompt += `   - \`aso.keywords\` array
 `;
@@ -1639,11 +1654,11 @@ ${researchSections.join(
 `;
   prompt += `**1. Keyword Source**
 `;
-  prompt += `   - If saved research exists: Cite file(s) used; list selected top 10 keywords
+  prompt += `   - If saved research exists: Cite file(s) used; list selected top 10 keywords (in target language)
 `;
-  prompt += `   - If using fallback: List translated keywords from primary locale with translation rationale
+  prompt += `   - If using fallback: List **TRANSLATED** keywords from primary locale (English \u2192 target language) with translation rationale
 `;
-  prompt += `   - Show final 10 keywords in target language with tier assignments
+  prompt += `   - Show final 10 keywords **IN TARGET LANGUAGE** with tier assignments - DO NOT show English keywords
 
 `;
   prompt += `**2. Updated JSON** (complete locale structure with keyword replacements)
@@ -1801,6 +1816,12 @@ Parse error: ${data.parseError}
   lines.push("\n----");
   return lines.join("\n");
 }
+function getPlatformPriority(platform) {
+  const normalized = (platform || "").toLowerCase();
+  if (normalized === "ios") return 0;
+  if (normalized === "android") return 1;
+  return 2;
+}
 function mergeKeywordData(entries) {
   const merged = {
     tier1_core: [],
@@ -1815,7 +1836,12 @@ function mergeKeywordData(entries) {
   const seenKeywords = /* @__PURE__ */ new Set();
   const seenGaps = /* @__PURE__ */ new Set();
   const seenPatterns = /* @__PURE__ */ new Set();
-  for (const entry of entries) {
+  const entriesByPriority = [...entries].sort((a, b) => {
+    const aPriority = getPlatformPriority(extractMeta(a.data).platform);
+    const bPriority = getPlatformPriority(extractMeta(b.data).platform);
+    return aPriority - bPriority;
+  });
+  for (const entry of entriesByPriority) {
     if (entry.data?.parseError) continue;
     const meta = extractMeta(entry.data);
     if (meta.platform && !merged.platforms.includes(meta.platform)) {
@@ -1872,8 +1898,15 @@ function mergeKeywordData(entries) {
 }
 function formatMergedData(merged, researchDir) {
   const lines = [];
-  lines.push(`### Combined Keyword Research (${merged.platforms.join(" + ")})`);
+  const hasIos = merged.platforms.some(
+    (platform) => platform && platform.toLowerCase() === "ios"
+  );
+  const platformLabel = merged.platforms.length > 0 ? merged.platforms.join(" + ") : "Unknown";
+  lines.push(
+    `### Combined Keyword Research (${platformLabel})${hasIos ? " \u2014 iOS prioritized" : ""}`
+  );
   lines.push(`Source: ${researchDir}`);
+  lines.push(`Priority: iOS > Android > others (use Android only after iOS keywords fit character limits)`);
   if (merged.tier1_core.length > 0) {
     lines.push(`
 **Tier 1 (Core - use in title/subtitle):** ${merged.tier1_core.join(", ")}`);
@@ -2004,7 +2037,7 @@ This tool returns a PROMPT containing:
 
 ## KEYWORD SOURCES
 - Uses SAVED keyword research from .aso/keywordResearch/products/[slug]/locales/
-- iOS and Android research are automatically combined
+- iOS and Android research are automatically combined (iOS prioritized; Android fills remaining slots when limits apply)
 - If locale research is missing, use English keywords and translate
 
 **CRITICAL:** Only processes existing locale files. Does NOT create new files.`,

package/package.json

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