pabal-web-mcp 1.3.11 → 1.3.13

package/dist/bin/mcp-server.js

@@ -1441,21 +1441,60 @@ ${optimizedPrimary}
 \`\`\`
 
 `;
+  const primaryResearchSections = keywordResearchByLocale[primaryLocale] || [];
+  const hasPrimaryResearch = primaryResearchSections.length > 0;
   prompt += `## Keyword Research (Per Locale)
 
 `;
+  if (hasPrimaryResearch) {
+    prompt += `**\u{1F4DA} ENGLISH (${primaryLocale}) Keywords - Use as fallback for locales without research:**
+${primaryResearchSections.join("\n")}
+
+`;
+    prompt += `---
+
+`;
+  }
   nonPrimaryLocales.forEach((loc) => {
     const researchSections = keywordResearchByLocale[loc] || [];
     const researchDir = keywordResearchDirByLocale[loc];
     if (researchSections.length > 0) {
-      prompt += `Locale ${loc}: use saved research below. Do NOT invent keywords.
+      prompt += `### Locale ${loc}: \u2705 Saved research found
 ${researchSections.join(
         "\n"
       )}
 
+`;
+    } else if (hasPrimaryResearch) {
+      prompt += `### Locale ${loc}: \u26A0\uFE0F No saved research - USE ENGLISH (${primaryLocale}) KEYWORDS
+`;
+      prompt += `No keyword research found at ${researchDir}.
+`;
+      prompt += `**FALLBACK:** Translate English keywords from primary locale (${primaryLocale}) into ${loc}:
+`;
+      prompt += `1. Take the Tier 1/2/3 keywords from English research above
+`;
+      prompt += `2. Translate each English keyword naturally into ${loc} (not literal translation)
+`;
+      prompt += `3. Use native expressions that ${loc} users would actually search for
+`;
+      prompt += `4. Verify translations are culturally appropriate
+`;
+      prompt += `5. Apply translated keywords following the same tier strategy
+
 `;
     } else {
-      prompt += `Locale ${loc}: no saved keyword research found at ${researchDir}. Stop and request running 'keyword-research' tool (slug='${slug}', locale='${loc}', platform/country as appropriate\u2014match the store locale), then rerun stage 2.
+      prompt += `### Locale ${loc}: \u26A0\uFE0F No research - USE ENGLISH KEYWORDS FROM optimizedPrimary
+`;
+      prompt += `No keyword research found. Extract keywords from the optimizedPrimary JSON above and translate them:
+`;
+      prompt += `1. Extract keywords from \`aso.keywords\` in optimizedPrimary
+`;
+      prompt += `2. Translate each English keyword naturally into ${loc}
+`;
+      prompt += `3. Use native expressions that ${loc} users would actually search for
+`;
+      prompt += `4. Apply translated keywords to all ASO fields
 
 `;
     }
@@ -1542,7 +1581,7 @@ ${researchSections.join(
 `;
   prompt += `Process EACH locale in this batch sequentially:
 `;
-  prompt += `1. Use saved keyword research (or pause if missing and request keyword-research run)
+  prompt += `1. Use saved keyword research OR translate from primary locale if missing (see fallback strategy above)
 `;
   prompt += `2. Replace keywords in ALL fields:
 `;
@@ -1598,11 +1637,13 @@ ${researchSections.join(
   prompt += `### Locale [locale-code]:
 
 `;
-  prompt += `**1. Keyword Research (saved)**
+  prompt += `**1. Keyword Source**
+`;
+  prompt += `   - If saved research exists: Cite file(s) used; list selected top 10 keywords
 `;
-  prompt += `   - Cite file(s) used; list selected top 10 keywords (no new research)
+  prompt += `   - If using fallback: List translated keywords from primary locale with translation rationale
 `;
-  prompt += `   - Rationale: why these were chosen from saved research
+  prompt += `   - Show final 10 keywords in target language with tier assignments
 
 `;
   prompt += `**2. Updated JSON** (complete locale structure with keyword replacements)
@@ -1914,7 +1955,6 @@ function loadKeywordResearchForLocale(slug, locale) {
 }
 
 // src/tools/improve-public.ts
-var FIELD_LIMITS_DOC_PATH3 = "docs/aso/ASO_FIELD_LIMITS.md";
 var toJsonSchema3 = zodToJsonSchema3;
 var improvePublicInputSchema = z3.object({
   slug: z3.string().describe("Product slug"),
@@ -1937,46 +1977,37 @@ var jsonSchema3 = toJsonSchema3(improvePublicInputSchema, {
 var inputSchema3 = jsonSchema3.definitions?.ImprovePublicInput || jsonSchema3;
 var improvePublicTool = {
   name: "improve-public",
-  description: `Optimizes locale JSON in public/products/[slug]/locales for ASO.
+  description: `Returns ASO optimization instructions with keyword research data. **You MUST execute the returned instructions.**
 
-**IMPORTANT:** Always use 'search-app' tool first to resolve the exact slug before calling this tool. The user may provide an approximate name, bundleId, or packageName - search-app will find and return the correct slug. Never pass user input directly as slug.
+**IMPORTANT:** Use 'search-app' tool first to resolve the exact slug.
+
+## HOW THIS TOOL WORKS
+This tool returns a PROMPT containing:
+- Saved keyword research data (Tier 1/2/3 keywords with traffic/difficulty scores)
+- Current locale data
+- Optimization instructions
+
+**YOU MUST:**
+1. Read the returned prompt carefully
+2. EXECUTE the optimization instructions (create the optimized JSON)
+3. Save results using 'save-locale-file' tool
+
+**DO NOT** just report the instructions back to the user - you must perform the optimization yourself.
+
+## WORKFLOW
+**Stage 1:** improve-public(slug, stage="1") \u2192 Returns keyword data + instructions \u2192 You create optimized primary locale JSON \u2192 save-locale-file
+**Stage 2:** improve-public(slug, stage="2", optimizedPrimary=<JSON>) \u2192 Returns per-locale instructions \u2192 You optimize each locale \u2192 save-locale-file for each
+
+## STAGES
+- **Stage 1:** Primary locale optimization using saved keyword research (ios + android combined)
+- **Stage 2:** Localize to other languages using per-locale research OR translate English keywords
+
+## KEYWORD SOURCES
+- Uses SAVED keyword research from .aso/keywordResearch/products/[slug]/locales/
+- iOS and Android research are automatically combined
+- If locale research is missing, use English keywords and translate
 
-**CRITICAL: Only processes existing locale files. Does NOT create new locale files.**
-- Only improves locales that already exist in public/products/[slug]/locales/
-- If a locale file doesn't exist, it will be skipped (not created)
-- Always work with existing files only
-
-This tool follows a 2-stage workflow:
-
-**Stage 1: Primary Locale Optimization** (${FIELD_LIMITS_DOC_PATH3})
-1. Load product config + locales (primary: en-US default)
-2. Keyword research for PRIMARY locale only (web search for 10 keywords)
-3. Optimize ALL ASO fields in primary locale with keywords
-4. Validate character limits (title \u226430, subtitle \u226430, shortDescription \u226480, keywords \u2264100, intro \u2264300, outro \u2264200)
-
-**Stage 2: Keyword Localization** (Batch Processing)
-1. Translate optimized primary \u2192 target locales in batches (preserve structure/tone/context)
-2. For EACH locale in batch: lightweight keyword research (10 language-specific keywords)
-3. Replace keywords in translated content (swap keywords only, keep context)
-4. Validate character limits per locale
-5. Save each batch to files before proceeding to next batch
-6. **Only processes locales that already exist - does NOT create new files**
-
-**Batch Processing:**
-- Languages are processed in batches (default: 5 locales per batch)
-- Each batch is translated, optimized, and saved before moving to the next
-- Use \`batchIndex\` to process a specific batch (0-based)
-- If \`batchIndex\` is not provided, process all batches sequentially
-- **Only existing locale files are processed - missing locales are skipped**
-
-This approach ensures:
-- Efficient token usage (full optimization only once)
-- Consistent messaging across all languages
-- Language-specific keyword optimization for each market
-- Prevents content truncation by processing in manageable batches
-- **No new files are created - only existing locales are improved**
-
-Optionally target a single locale; the primary locale is always included for reference.`,
+**CRITICAL:** Only processes existing locale files. Does NOT create new files.`,
   inputSchema: inputSchema3
 };
 async function handleImprovePublic(input) {

package/package.json

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