aso-mcp 1.0.0

package/build/data-sources/custom-scoring.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Custom ASO Scoring Algorithm
+ * Provides self-calculated metrics independent of Apple Search Ads popularity issues.
+ */
+export interface CustomScore {
+    visibilityScore: number;
+    competitiveScore: number;
+    opportunityScore: number;
+    overallScore: number;
+}
+export interface KeywordOpportunity {
+    keyword: string;
+    score: number;
+    reason: string;
+}
+/**
+ * Calculates visibility score from an app's ASO metrics.
+ * Weights factors like rating, review count, and ranking.
+ */
+export declare function calculateVisibilityScore(params: {
+    rating: number;
+    reviewCount: number;
+    rankInKeyword?: number;
+    totalAppsInKeyword?: number;
+}): number;
+/**
+ * Calculates the competitive score for a keyword.
+ * Determines difficulty by analyzing the strength of top-ranking apps.
+ */
+export declare function calculateCompetitiveScore(topApps: {
+    rating: number;
+    reviews: number;
+    free: boolean;
+}[]): number;
+/**
+ * Keyword opportunity score: High traffic + low difficulty = high opportunity
+ */
+export declare function calculateOpportunityScore(traffic: number, difficulty: number): number;
+/**
+ * Combines all scores to produce an overall ASO score.
+ */
+export declare function calculateOverallScore(params: {
+    visibilityScore: number;
+    competitiveScore: number;
+    opportunityScore: number;
+}): number;
+/**
+ * Extracts keywords from an app's title.
+ * Filters out stop words.
+ */
+export declare function extractTitleKeywords(title: string): string[];
+//# sourceMappingURL=custom-scoring.d.ts.map

package/build/data-sources/custom-scoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-scoring.d.ts","sourceRoot":"","sources":["../../src/data-sources/custom-scoring.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,GAAG,MAAM,CAiBT;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;CACf,EAAE,GAAG,MAAM,CAoBX;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,MAAM,CAKR;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,GAAG,MAAM,CAST;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAiB5D"}

package/build/data-sources/custom-scoring.js

@@ -0,0 +1,83 @@
+/**
+ * Custom ASO Scoring Algorithm
+ * Provides self-calculated metrics independent of Apple Search Ads popularity issues.
+ */
+/**
+ * Calculates visibility score from an app's ASO metrics.
+ * Weights factors like rating, review count, and ranking.
+ */
+export function calculateVisibilityScore(params) {
+    const { rating, reviewCount, rankInKeyword, totalAppsInKeyword } = params;
+    // Rating contribution (0-3 points): 4.5+ = 3, 4.0+ = 2, 3.0+ = 1
+    const ratingScore = rating >= 4.5 ? 3 : rating >= 4.0 ? 2 : rating >= 3.0 ? 1 : 0;
+    // Review count contribution (0-3 points): logarithmic scale
+    const reviewScore = Math.min(3, Math.log10(Math.max(1, reviewCount)) / 1.5);
+    // Ranking contribution (0-4 points)
+    let rankScore = 2; // default medium
+    if (rankInKeyword !== undefined && totalAppsInKeyword) {
+        const percentile = 1 - rankInKeyword / totalAppsInKeyword;
+        rankScore = percentile * 4;
+    }
+    return Math.min(10, ratingScore + reviewScore + rankScore);
+}
+/**
+ * Calculates the competitive score for a keyword.
+ * Determines difficulty by analyzing the strength of top-ranking apps.
+ */
+export function calculateCompetitiveScore(topApps) {
+    if (topApps.length === 0)
+        return 0;
+    const avgRating = topApps.reduce((sum, a) => sum + (a.rating || 0), 0) / topApps.length;
+    const avgReviews = topApps.reduce((sum, a) => sum + (a.reviews || 0), 0) / topApps.length;
+    const freeRatio = topApps.filter((a) => a.free).length / topApps.length;
+    // High rating = harder (0-3)
+    const ratingDifficulty = (avgRating / 5) * 3;
+    // Many reviews = harder (0-4, logarithmic)
+    const reviewDifficulty = Math.min(4, Math.log10(Math.max(1, avgReviews)) / 1.25);
+    // Mostly free = harder (0-3)
+    const freeDifficulty = freeRatio * 3;
+    return Math.min(10, ratingDifficulty + reviewDifficulty + freeDifficulty);
+}
+/**
+ * Keyword opportunity score: High traffic + low difficulty = high opportunity
+ */
+export function calculateOpportunityScore(traffic, difficulty) {
+    if (traffic === 0 && difficulty === 0)
+        return 5;
+    // high traffic + low difficulty = high score
+    const raw = (traffic * 1.5 - difficulty * 0.8 + 5);
+    return Math.max(0, Math.min(10, raw));
+}
+/**
+ * Combines all scores to produce an overall ASO score.
+ */
+export function calculateOverallScore(params) {
+    const { visibilityScore, competitiveScore, opportunityScore } = params;
+    // Weights: visibility 40%, opportunity 35%, competitive (inverse) 25%
+    const competitiveInverse = 10 - competitiveScore;
+    return (visibilityScore * 0.4 +
+        opportunityScore * 0.35 +
+        competitiveInverse * 0.25);
+}
+/**
+ * Extracts keywords from an app's title.
+ * Filters out stop words.
+ */
+export function extractTitleKeywords(title) {
+    const stopWords = new Set([
+        "the", "a", "an", "and", "or", "but", "in", "on", "at", "to", "for",
+        "of", "with", "by", "from", "is", "it", "this", "that", "are", "was",
+        "be", "has", "had", "not", "no", "do", "does", "did",
+        // Turkish stop words
+        "ve", "ile", "bir", "bu", "da", "de", "mi", "mu", "için", "gibi",
+        "olan", "olarak", "den", "dan", "ya", "en",
+        // App Store common
+        "-", "&", "|", ":", "/",
+    ]);
+    return title
+        .toLowerCase()
+        .split(/[\s\-&|:\/,\.]+/)
+        .map((w) => w.trim())
+        .filter((w) => w.length > 1 && !stopWords.has(w));
+}
+//# sourceMappingURL=custom-scoring.js.map

package/build/data-sources/custom-scoring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-scoring.js","sourceRoot":"","sources":["../../src/data-sources/custom-scoring.ts"],"names":[],"mappings":"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"}

package/build/server.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=server.d.ts.map

package/build/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":""}

package/build/server.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import dotenv from "dotenv";
+// Phase 1 tools
+import { registerSearchKeywords } from "./tools/search-keywords.js";
+import { registerSuggestKeywords } from "./tools/suggest-keywords.js";
+import { registerGetAppDetails } from "./tools/get-app-details.js";
+// Phase 2 tools
+import { registerAnalyzeCompetitors } from "./tools/analyze-competitors.js";
+import { registerOptimizeMetadata } from "./tools/optimize-metadata.js";
+import { registerAnalyzeReviews } from "./tools/analyze-reviews.js";
+import { registerTrackRanking } from "./tools/track-ranking.js";
+import { registerKeywordGap } from "./tools/keyword-gap.js";
+// Phase 3 tools
+import { registerLocalizedKeywords } from "./tools/localized-keywords.js";
+import { registerGetAsoReport } from "./tools/get-aso-report.js";
+// ASO Generation tools
+import { registerDiscoverKeywords } from "./tools/discover-keywords.js";
+import { registerGenerateAsoBrief } from "./tools/generate-aso-brief.js";
+// Phase 5: App Store Connect tools
+import { registerConnectSetup } from "./tools/connect-setup.js";
+import { registerConnectGetApp } from "./tools/connect-get-app.js";
+import { registerConnectGetMetadata } from "./tools/connect-get-metadata.js";
+import { registerConnectUpdateMetadata } from "./tools/connect-update-metadata.js";
+import { registerConnectListLocalizations } from "./tools/connect-list-localizations.js";
+// Utility tools
+import { registerClearCache } from "./tools/clear-cache.js";
+import { initCache } from "./cache/sqlite-cache.js";
+dotenv.config();
+const server = new McpServer({
+    name: "aso-mcp",
+    version: "1.0.0",
+});
+// Initialize cache
+initCache();
+// Register Phase 1 tools
+registerSearchKeywords(server);
+registerSuggestKeywords(server);
+registerGetAppDetails(server);
+// Register Phase 2 tools
+registerAnalyzeCompetitors(server);
+registerOptimizeMetadata(server);
+registerAnalyzeReviews(server);
+registerTrackRanking(server);
+registerKeywordGap(server);
+// Register Phase 3 tools
+registerLocalizedKeywords(server);
+registerGetAsoReport(server);
+// Register ASO Generation tools
+registerDiscoverKeywords(server);
+registerGenerateAsoBrief(server);
+// Register Phase 5: App Store Connect tools
+registerConnectSetup(server);
+registerConnectGetApp(server);
+registerConnectGetMetadata(server);
+registerConnectUpdateMetadata(server);
+registerConnectListLocalizations(server);
+// Register Utility tools
+registerClearCache(server);
+// Start server
+const transport = new StdioServerTransport();
+await server.connect(transport);
+// Graceful shutdown
+process.on("SIGINT", async () => {
+    await server.close();
+    process.exit(0);
+});
+//# sourceMappingURL=server.js.map

package/build/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/build/tools/analyze-competitors.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerAnalyzeCompetitors(server: McpServer): void;
+//# sourceMappingURL=analyze-competitors.d.ts.map

package/build/tools/analyze-competitors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-competitors.d.ts","sourceRoot":"","sources":["../../src/tools/analyze-competitors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAWpE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,QA6H3D"}

package/build/tools/analyze-competitors.js

@@ -0,0 +1,112 @@
+import { z } from "zod";
+import { searchApps } from "../data-sources/app-store.js";
+import { getScores } from "../data-sources/aso-scoring.js";
+import { getFromCache, setCache } from "../cache/sqlite-cache.js";
+import { CACHE_TTL } from "../utils/constants.js";
+import { calculateCompetitiveScore, extractTitleKeywords, } from "../data-sources/custom-scoring.js";
+export function registerAnalyzeCompetitors(server) {
+    server.tool("analyze_competitors", "Fetches and compares metadata of top-ranking apps for a keyword, and performs keyword gap analysis. Used to understand the competitive landscape.", {
+        keyword: z.string().describe("Keyword to analyze"),
+        country: z
+            .string()
+            .default("tr")
+            .describe("Country code (tr, us, de, gb, fr...)"),
+        num: z
+            .number()
+            .default(10)
+            .describe("Number of competitor apps to analyze"),
+    }, async ({ keyword, country, num }) => {
+        const cacheKey = `competitors:${keyword}:${country}:${num}`;
+        const cached = getFromCache(cacheKey);
+        if (cached) {
+            return { content: [{ type: "text", text: cached }] };
+        }
+        try {
+            const topApps = await searchApps(keyword, country, num);
+            // Extract title keywords for each app
+            const appsWithKeywords = topApps.map((app) => {
+                const titleKeywords = extractTitleKeywords(app.title || "");
+                return {
+                    title: app.title,
+                    developer: app.developer,
+                    rating: app.score || 0,
+                    reviews: app.reviews || 0,
+                    free: app.free,
+                    price: app.price || 0,
+                    url: app.url,
+                    titleKeywords,
+                };
+            });
+            // Keyword frequency analysis
+            const keywordFrequency = {};
+            for (const app of appsWithKeywords) {
+                for (const kw of app.titleKeywords) {
+                    keywordFrequency[kw] = (keywordFrequency[kw] || 0) + 1;
+                }
+            }
+            // Common keywords (appearing in 2+ apps)
+            const commonKeywords = Object.entries(keywordFrequency)
+                .filter(([, count]) => count >= 2)
+                .sort((a, b) => b[1] - a[1])
+                .map(([kw]) => kw);
+            // All unique keywords
+            const allKeywords = [...new Set(appsWithKeywords.flatMap((a) => a.titleKeywords))];
+            // Keyword gap: keywords not in commonKeywords (opportunity)
+            const commonSet = new Set(commonKeywords);
+            const keywordGap = allKeywords.filter((kw) => !commonSet.has(kw));
+            // Metrics
+            const avgRating = appsWithKeywords.reduce((s, a) => s + a.rating, 0) /
+                appsWithKeywords.length;
+            const avgReviews = appsWithKeywords.reduce((s, a) => s + a.reviews, 0) /
+                appsWithKeywords.length;
+            const freePercentage = (appsWithKeywords.filter((a) => a.free).length /
+                appsWithKeywords.length) *
+                100;
+            // Top developers
+            const devFrequency = {};
+            for (const app of appsWithKeywords) {
+                devFrequency[app.developer] = (devFrequency[app.developer] || 0) + 1;
+            }
+            const topDevelopers = Object.entries(devFrequency)
+                .sort((a, b) => b[1] - a[1])
+                .slice(0, 5)
+                .map(([dev]) => dev);
+            // Competitive score
+            const competitiveScore = calculateCompetitiveScore(appsWithKeywords);
+            // Main keyword score
+            let keywordScores = { traffic: 0, difficulty: 0 };
+            try {
+                keywordScores = await getScores(keyword, country);
+            }
+            catch {
+                // Continue if scoring fails
+            }
+            const result = {
+                keyword,
+                country,
+                competitiveScore: Math.round(competitiveScore * 10) / 10,
+                keywordScores,
+                apps: appsWithKeywords,
+                commonKeywords,
+                keywordGap,
+                metrics: {
+                    avgRating: Math.round(avgRating * 100) / 100,
+                    avgReviews: Math.round(avgReviews),
+                    freePercentage: Math.round(freePercentage),
+                    topDevelopers,
+                    totalAppsAnalyzed: appsWithKeywords.length,
+                },
+            };
+            const resultText = JSON.stringify(result, null, 2);
+            setCache(cacheKey, resultText, CACHE_TTL.SEARCH_RESULTS);
+            return { content: [{ type: "text", text: resultText }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=analyze-competitors.js.map

package/build/tools/analyze-competitors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-competitors.js","sourceRoot":"","sources":["../../src/tools/analyze-competitors.ts"],"names":[],"mappings":"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"}

package/build/tools/analyze-reviews.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerAnalyzeReviews(server: McpServer): void;
+//# sourceMappingURL=analyze-reviews.d.ts.map

package/build/tools/analyze-reviews.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-reviews.d.ts","sourceRoot":"","sources":["../../src/tools/analyze-reviews.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAwEpE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,QA4IvD"}

package/build/tools/analyze-reviews.js

@@ -0,0 +1,188 @@
+import { z } from "zod";
+import { getAppDetails, getReviews } from "../data-sources/app-store.js";
+import { getFromCache, setCache } from "../cache/sqlite-cache.js";
+import { CACHE_TTL } from "../utils/constants.js";
+// Simple sentiment keywords
+const POSITIVE_WORDS = new Set([
+    // Turkish
+    "harika", "mukemmel", "super", "guzel", "kolay", "hizli", "sevdim",
+    "basarili", "kaliteli", "tavsiye", "ederim", "ideal", "faydali",
+    "kullanisli", "pratik", "efektif", "begendim",
+    // English
+    "great", "amazing", "awesome", "love", "excellent", "perfect",
+    "good", "best", "fantastic", "wonderful", "helpful", "easy",
+    "fast", "recommend", "nice", "useful",
+]);
+const NEGATIVE_WORDS = new Set([
+    // Turkish
+    "kotu", "berbat", "yavaş", "hata", "bug", "cokma", "calısmiyor",
+    "bozuk", "sikiyor", "reklam", "pahali", "gereksiz", "zor",
+    "karmasik", "siliyorum", "cöp", "rezalet", "felaket", "saçma",
+    // English
+    "bad", "terrible", "awful", "hate", "worst", "horrible", "slow",
+    "crash", "bug", "broken", "ads", "expensive", "useless",
+    "annoying", "frustrating", "delete", "uninstall",
+]);
+const FEATURE_INDICATORS = [
+    // Turkish
+    "eklensin", "eklenmeli", "olsa", "istiyorum", "lazim", "gerek",
+    "olmali", "bekliyorum", "güncelleme", "özellik",
+    // English
+    "should", "please add", "would be nice", "wish", "need", "want",
+    "feature request", "missing",
+];
+function analyzeSentiment(text) {
+    const lower = text.toLowerCase();
+    const words = lower.split(/\s+/);
+    let positiveCount = 0;
+    let negativeCount = 0;
+    for (const word of words) {
+        if (POSITIVE_WORDS.has(word))
+            positiveCount++;
+        if (NEGATIVE_WORDS.has(word))
+            negativeCount++;
+    }
+    if (positiveCount > negativeCount)
+        return "positive";
+    if (negativeCount > positiveCount)
+        return "negative";
+    return "neutral";
+}
+function isFeatureRequest(text) {
+    const lower = text.toLowerCase();
+    return FEATURE_INDICATORS.some((indicator) => lower.includes(indicator));
+}
+function extractKeywords(text) {
+    const stopWords = new Set([
+        "the", "a", "an", "and", "or", "but", "in", "on", "at", "to", "for",
+        "of", "is", "it", "this", "that", "ve", "ile", "bir", "bu", "da",
+        "de", "mi", "mu", "icin", "çok", "var", "ben", "app", "uygulama",
+    ]);
+    return text
+        .toLowerCase()
+        .split(/[\s,.!?;:]+/)
+        .filter((w) => w.length > 2 && !stopWords.has(w));
+}
+export function registerAnalyzeReviews(server) {
+    server.tool("analyze_reviews", "Performs sentiment analysis on an app's user reviews, extracts complaints and feature requests. Provides keyword insights for ASO.", {
+        appId: z
+            .string()
+            .describe("App Store app ID or bundle ID"),
+        country: z
+            .string()
+            .default("tr")
+            .describe("Country code"),
+        pages: z
+            .number()
+            .default(3)
+            .describe("Number of review pages to fetch (each page ~50 reviews)"),
+    }, async ({ appId, country, pages }) => {
+        const cacheKey = `reviews:${appId}:${country}:${pages}`;
+        const cached = getFromCache(cacheKey);
+        if (cached) {
+            return { content: [{ type: "text", text: cached }] };
+        }
+        try {
+            // Get app info (numeric ID required)
+            const app = await getAppDetails(appId, country);
+            const numericId = app.id;
+            // Fetch reviews
+            const allReviews = [];
+            for (let page = 1; page <= pages; page++) {
+                try {
+                    const pageReviews = await getReviews(numericId, country, page);
+                    allReviews.push(...pageReviews);
+                }
+                catch {
+                    break; // no more pages
+                }
+            }
+            if (allReviews.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                appId,
+                                message: "No reviews found for this app.",
+                            }),
+                        },
+                    ],
+                };
+            }
+            // Sentiment analysis
+            let positive = 0;
+            let negative = 0;
+            let neutral = 0;
+            const complaints = [];
+            const featureRequests = [];
+            const keywordMap = {};
+            for (const review of allReviews) {
+                const text = review.text || review.body || "";
+                const title = review.title || "";
+                const fullText = `${title} ${text}`;
+                const sentiment = analyzeSentiment(fullText);
+                if (sentiment === "positive")
+                    positive++;
+                else if (sentiment === "negative")
+                    negative++;
+                else
+                    neutral++;
+                // Complaints (negative reviews)
+                if (sentiment === "negative" && text.length > 10) {
+                    complaints.push(text.length > 150 ? text.slice(0, 150) + "..." : text);
+                }
+                // Feature requests
+                if (isFeatureRequest(fullText)) {
+                    featureRequests.push(fullText.length > 150 ? fullText.slice(0, 150) + "..." : fullText);
+                }
+                // Keyword extraction
+                for (const kw of extractKeywords(fullText)) {
+                    keywordMap[kw] = (keywordMap[kw] || 0) + 1;
+                }
+            }
+            // Most frequent keywords (ASO insight)
+            const keywordInsights = Object.entries(keywordMap)
+                .sort((a, b) => b[1] - a[1])
+                .slice(0, 20)
+                .map(([keyword, count]) => ({ keyword, count }));
+            // Rating distribution
+            const ratingDist = { 1: 0, 2: 0, 3: 0, 4: 0, 5: 0 };
+            for (const review of allReviews) {
+                const score = review.score || review.rating;
+                if (score >= 1 && score <= 5) {
+                    ratingDist[Math.round(score)]++;
+                }
+            }
+            const total = allReviews.length;
+            const result = {
+                appId,
+                appTitle: app.title,
+                country,
+                totalReviewed: total,
+                sentiment: {
+                    positive,
+                    negative,
+                    neutral,
+                    positivePercent: Math.round((positive / total) * 100),
+                    negativePercent: Math.round((negative / total) * 100),
+                    neutralPercent: Math.round((neutral / total) * 100),
+                },
+                ratingDistribution: ratingDist,
+                topComplaints: complaints.slice(0, 10),
+                featureRequests: featureRequests.slice(0, 10),
+                keywordInsights,
+            };
+            const resultText = JSON.stringify(result, null, 2);
+            setCache(cacheKey, resultText, CACHE_TTL.REVIEWS);
+            return { content: [{ type: "text", text: resultText }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=analyze-reviews.js.map

package/build/tools/analyze-reviews.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-reviews.js","sourceRoot":"","sources":["../../src/tools/analyze-reviews.ts"],"names":[],"mappings":"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"}

package/build/tools/clear-cache.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerClearCache(server: McpServer): void;
+//# sourceMappingURL=clear-cache.d.ts.map

package/build/tools/clear-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clear-cache.d.ts","sourceRoot":"","sources":["../../src/tools/clear-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,QAmCnD"}

package/build/tools/clear-cache.js

@@ -0,0 +1,32 @@
+import { clearCache, getCacheStats } from "../cache/sqlite-cache.js";
+export function registerClearCache(server) {
+    server.tool("clear_cache", "Clears the local ASO data cache. Use when you want fresh data from the App Store instead of cached results. Returns cache stats before and after clearing.", {}, async () => {
+        try {
+            const before = getCacheStats();
+            clearCache();
+            const after = getCacheStats();
+            const result = {
+                status: "cleared",
+                before: {
+                    totalEntries: before.totalEntries,
+                    expiredEntries: before.expiredEntries,
+                },
+                after: {
+                    totalEntries: after.totalEntries,
+                },
+                entriesRemoved: before.totalEntries - after.totalEntries,
+                dbPath: before.dbPath,
+            };
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=clear-cache.js.map

package/build/tools/clear-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clear-cache.js","sourceRoot":"","sources":["../../src/tools/clear-cache.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAErE,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAClD,MAAM,CAAC,IAAI,CACT,aAAa,EACb,4JAA4J,EAC5J,EAAE,EACF,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;YAC/B,UAAU,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;YAE9B,MAAM,MAAM,GAAG;gBACb,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE;oBACN,YAAY,EAAE,MAAM,CAAC,YAAY;oBACjC,cAAc,EAAE,MAAM,CAAC,cAAc;iBACtC;gBACD,KAAK,EAAE;oBACL,YAAY,EAAE,KAAK,CAAC,YAAY;iBACjC;gBACD,cAAc,EAAE,MAAM,CAAC,YAAY,GAAG,KAAK,CAAC,YAAY;gBACxD,MAAM,EAAE,MAAM,CAAC,MAAM;aACtB,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC5E,CAAC;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;gBACrE,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/build/tools/connect-get-app.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerConnectGetApp(server: McpServer): void;
+//# sourceMappingURL=connect-get-app.d.ts.map

package/build/tools/connect-get-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-get-app.d.ts","sourceRoot":"","sources":["../../src/tools/connect-get-app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,QA2DtD"}