pabal-web-mcp 1.3.12 → 1.4.0

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,6 +1448,9 @@ ${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:**
@@ -1503,6 +1509,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)
 `;
@@ -1801,6 +1809,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 +1829,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 +1891,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(", ")}`);
@@ -1955,7 +1981,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"),
@@ -1978,46 +2003,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 (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 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.12",
+  "version": "1.4.0",
   "type": "module",
   "description": "MCP server for ASO data management with shared types and utilities",
   "author": "skyu",