pabal-web-mcp 1.3.6 → 1.3.7

package/dist/bin/mcp-server.js

@@ -2533,8 +2533,20 @@ async function handleKeywordResearch(input) {
     ).values()
   ).slice(0, 5);
   const cwd = serverCwd || path11.resolve(process.cwd(), "external-tools", "mcp-appstore");
-  const cmd = serverCommand?.[0] || "node";
-  const args = serverCommand?.length ? serverCommand.slice(1) : ["server.js"];
+  const cmd = serverCommand?.[0] || "npm";
+  const args = serverCommand?.length ? serverCommand.slice(1) : ["start"];
+  if (!fs11.existsSync(cwd)) {
+    throw new Error(
+      `mcp-appstore cwd not found: ${cwd}. Set 'serverCwd' to the absolute path (e.g., /Users/you/pabal-web-mcp/external-tools/mcp-appstore).`
+    );
+  }
+  const serverJsPath = path11.join(cwd, "server.js");
+  const usingNodeServer = cmd === "node" || args.includes("server.js");
+  if (usingNodeServer && !fs11.existsSync(serverJsPath)) {
+    throw new Error(
+      `mcp-appstore server.js not found under ${cwd}. Set 'serverCommand' (e.g., ["npm","start"] or ["node","/abs/path/server.js"]).`
+    );
+  }
   const transport = new StdioClientTransport({ command: cmd, args, cwd });
   const client = new Client(
     { name: "keyword-research", version: "1.0.0" },
@@ -2545,6 +2557,7 @@ async function handleKeywordResearch(input) {
     searchApp: [],
     getAppDetails: [],
     similarApps: [],
+    searchAppFallbackApps: [],
     keywordSuggestions: {
       bySeeds: [],
       byCategory: [],
@@ -2557,6 +2570,7 @@ async function handleKeywordResearch(input) {
     reviewsAnalysis: [],
     reviewsRaw: []
   };
+  const fallbackAppIds = [];
   for (const term of seeds.slice(0, 3)) {
     const res = await callToolJSON(client, "search_app", {
       term,
@@ -2570,7 +2584,13 @@ async function handleKeywordResearch(input) {
       country: resolvedCountry,
       results: res?.results ?? res
     });
+    const apps = (res?.results ?? res) || [];
+    apps.slice(0, 5).forEach((app) => {
+      const appId = app?.appId || app?.id;
+      if (appId) fallbackAppIds.push(String(appId));
+    });
   }
+  raw.searchAppFallbackApps = Array.from(new Set(fallbackAppIds));
   for (const comp of competitors.slice(0, 5)) {
     const res = await callToolJSON(client, "get_app_details", {
       appId: comp.appId,
@@ -2579,18 +2599,18 @@ async function handleKeywordResearch(input) {
     });
     raw.getAppDetails.push(res);
   }
-  if (competitors.length > 0) {
-    const first = competitors[0];
+  const firstCompId = competitors[0]?.appId || raw.searchAppFallbackApps[0];
+  if (firstCompId) {
     const res = await callToolJSON(client, "get_similar_apps", {
-      appId: first.appId,
+      appId: firstCompId,
       platform,
       num: 10,
       country: resolvedCountry
     });
     raw.similarApps = res?.similarApps || res || [];
   }
-  const firstComp = competitors[0]?.appId;
-  const appsList = competitors.map((c) => c.appId);
+  const firstComp = firstCompId;
+  const appsList = competitors.length ? competitors.map((c) => c.appId) : raw.searchAppFallbackApps.slice(0, 5);
   const suggestCalls = [
     [
       "suggest_keywords_by_seeds",
@@ -2675,6 +2695,23 @@ async function handleKeywordResearch(input) {
     });
     raw.reviewsRaw.push(rawReviews);
   }
+  if (competitors.length === 0 && raw.searchAppFallbackApps.length > 0) {
+    const fb = raw.searchAppFallbackApps[0];
+    const analysis = await callToolJSON(client, "analyze_reviews", {
+      appId: fb,
+      platform,
+      country: resolvedCountry,
+      num: 150
+    });
+    raw.reviewsAnalysis.push(analysis);
+    const rawReviews = await callToolJSON(client, "fetch_reviews", {
+      appId: fb,
+      platform,
+      country: resolvedCountry,
+      num: 80
+    });
+    raw.reviewsRaw.push(rawReviews);
+  }
   const candidateSet = /* @__PURE__ */ new Set();
   const addCandidates = (arr) => {
     if (!arr) return;
@@ -2688,6 +2725,12 @@ async function handleKeywordResearch(input) {
   };
   seeds.forEach((s) => candidateSet.add(s));
   Object.values(raw.keywordSuggestions).forEach((arr) => addCandidates(arr));
+  raw.reviewsAnalysis.forEach((ra) => {
+    const freq = ra?.analysis?.keywordFrequency || ra?.keywordFrequency;
+    if (freq && typeof freq === "object") {
+      addCandidates(Object.keys(freq));
+    }
+  });
   const candidates = Array.from(candidateSet).slice(0, 30);
   for (const kw of candidates) {
     const res = await callToolJSON(client, "get_keyword_scores", {
@@ -2710,14 +2753,26 @@ async function handleKeywordResearch(input) {
     };
   }).filter((s) => s.keyword);
   const recommended = scored.sort((a, b) => b.trafficScore - a.trafficScore).slice(0, 15);
+  const recommendedKeywords = recommended.map((r) => r.keyword).filter(Boolean);
+  const top1 = recommended[0];
+  const top3 = recommendedKeywords.slice(0, 3);
+  const rationaleText = top1 && top1.keyword ? `Highest traffic: ${top1.keyword} (traffic ${top1.trafficScore.toFixed(
+    2
+  )}, difficulty ${top1.difficultyScore.toFixed(
+    2
+  )}). Blend core/high-traffic and mid/longtail terms for coverage.` : "Sorted by traffic score (desc). Blend of core/high-traffic and mid/longtail technical terms.";
+  const nextActionsText = recommendedKeywords.length ? `Use top keywords in improve-public Stage 1. Emphasize: ${top3.join(
+    ", "
+  )}. Keep app name in English; target 10\u201315 keywords in keyword fields.` : "Run again to produce at least 10\u201315 keywords, then feed into improve-public Stage 1.";
   const summary = {
-    recommendedKeywords: recommended.map((r) => ({
+    recommendedKeywords,
+    recommendedDetails: recommended.map((r) => ({
       keyword: r.keyword,
       trafficScore: r.trafficScore,
       difficultyScore: r.difficultyScore
     })),
-    rationale: "Sorted by traffic score (desc). Blend of core/high-traffic and mid/longtail technical terms.",
-    nextActions: "Feed top 10\u201315 into improve-public Stage 1. If any sections are empty (suggestions/reviews), add more competitors/seeds and rerun."
+    rationale: rationaleText,
+    nextActions: nextActionsText
   };
   await client.close();
   const researchDir = path11.join(

package/package.json

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