aso-mcp 1.0.0

package/build/tools/get-aso-report.js

@@ -0,0 +1,168 @@
+import { z } from "zod";
+import { getAppDetails, searchApps, getReviews, getSimilarApps, } from "../data-sources/app-store.js";
+import { batchGetScores } from "../data-sources/aso-scoring.js";
+import { getFromCache, setCache } from "../cache/sqlite-cache.js";
+import { CACHE_TTL, CHAR_LIMITS } from "../utils/constants.js";
+import { extractTitleKeywords, calculateVisibilityScore, calculateCompetitiveScore, calculateOpportunityScore, calculateOverallScore, } from "../data-sources/custom-scoring.js";
+export function registerGetAsoReport(server) {
+    server.tool("get_aso_report", "Generates a comprehensive ASO report for an app. Gathers app details, keyword scores, competitor analysis, review summary, and metadata status in one call. The ideal tool for AI to perform in-depth ASO analysis.", {
+        appId: z
+            .string()
+            .describe("App Store app ID or bundle ID"),
+        country: z
+            .string()
+            .default("tr")
+            .describe("Country code"),
+        competitors: z
+            .number()
+            .default(5)
+            .describe("Number of competitors to analyze"),
+    }, async ({ appId, country, competitors }) => {
+        const cacheKey = `report:${appId}:${country}:${competitors}`;
+        const cached = getFromCache(cacheKey);
+        if (cached) {
+            return { content: [{ type: "text", text: cached }] };
+        }
+        try {
+            // 1. App details
+            const app = await getAppDetails(appId, country);
+            const titleKeywords = extractTitleKeywords(app.title || "");
+            // 2. Title keyword scores (in parallel)
+            const keywordScores = await batchGetScores(titleKeywords.slice(0, 10), country);
+            // 3. Search by app name — competitors
+            let competitorApps = [];
+            try {
+                competitorApps = await searchApps(app.title?.split(/[-:|]/)[0]?.trim() || appId, country, competitors + 1);
+                // Remove self
+                competitorApps = competitorApps.filter((a) => a.id !== app.id && a.appId !== app.appId).slice(0, competitors);
+            }
+            catch {
+                // continue
+            }
+            // 4. Similar apps
+            let similarApps = [];
+            try {
+                similarApps = (await getSimilarApps(app.id, country)).slice(0, 5);
+            }
+            catch {
+                // continue
+            }
+            // 5. Review summary
+            let reviewSummary = {
+                total: 0,
+                positive: 0,
+                negative: 0,
+                neutral: 0,
+                sampleComplaints: [],
+            };
+            try {
+                const reviews = await getReviews(app.id, country, 1);
+                reviewSummary.total = reviews.length;
+                for (const r of reviews) {
+                    const score = r.score || r.rating || 3;
+                    if (score >= 4)
+                        reviewSummary.positive++;
+                    else if (score <= 2)
+                        reviewSummary.negative++;
+                    else
+                        reviewSummary.neutral++;
+                    if (score <= 2 && reviewSummary.sampleComplaints.length < 3) {
+                        const text = (r.text || r.body || "").slice(0, 120);
+                        if (text)
+                            reviewSummary.sampleComplaints.push(text);
+                    }
+                }
+            }
+            catch {
+                // continue
+            }
+            // 6. Scores
+            const visibilityScore = calculateVisibilityScore({
+                rating: app.score || 0,
+                reviewCount: app.reviews || 0,
+            });
+            const competitiveScore = calculateCompetitiveScore(competitorApps.map((a) => ({
+                rating: a.score || 0,
+                reviews: a.reviews || 0,
+                free: a.free ?? true,
+            })));
+            const avgTraffic = keywordScores.length > 0
+                ? keywordScores.reduce((s, k) => s + k.traffic, 0) /
+                    keywordScores.length
+                : 0;
+            const avgDifficulty = keywordScores.length > 0
+                ? keywordScores.reduce((s, k) => s + k.difficulty, 0) /
+                    keywordScores.length
+                : 0;
+            const opportunityScore = calculateOpportunityScore(avgTraffic, avgDifficulty);
+            const overallScore = calculateOverallScore({
+                visibilityScore,
+                competitiveScore,
+                opportunityScore,
+            });
+            // 7. Metadata analysis
+            const titleLength = (app.title || "").length;
+            const competitorKeywords = [
+                ...new Set(competitorApps.flatMap((a) => extractTitleKeywords(a.title || ""))),
+            ];
+            const missingKeywords = competitorKeywords.filter((kw) => !titleKeywords.includes(kw));
+            const result = {
+                app: {
+                    id: app.id,
+                    appId: app.appId,
+                    title: app.title,
+                    developer: app.developer,
+                    rating: app.score,
+                    reviews: app.reviews,
+                    price: app.price,
+                    free: app.free,
+                    genre: app.genre,
+                    url: app.url,
+                    icon: app.icon,
+                    version: app.version,
+                    updated: app.updated,
+                    description: (app.description || "").slice(0, 500),
+                },
+                scores: {
+                    overall: Math.round(overallScore * 10) / 10,
+                    visibility: Math.round(visibilityScore * 10) / 10,
+                    competitive: Math.round(competitiveScore * 10) / 10,
+                    opportunity: Math.round(opportunityScore * 10) / 10,
+                },
+                metadata: {
+                    titleLength,
+                    titleLimit: CHAR_LIMITS.TITLE,
+                    titleRemaining: CHAR_LIMITS.TITLE - titleLength,
+                    titleKeywords,
+                    missingCompetitorKeywords: missingKeywords.slice(0, 10),
+                },
+                keywordAnalysis: keywordScores,
+                competitors: competitorApps.slice(0, competitors).map((a) => ({
+                    title: a.title,
+                    developer: a.developer,
+                    rating: a.score || 0,
+                    reviews: a.reviews || 0,
+                    free: a.free,
+                    titleKeywords: extractTitleKeywords(a.title || ""),
+                })),
+                similarApps: similarApps.map((a) => ({
+                    title: a.title,
+                    developer: a.developer,
+                    rating: a.score || 0,
+                })),
+                reviews: reviewSummary,
+                country,
+            };
+            const resultText = JSON.stringify(result, null, 2);
+            setCache(cacheKey, resultText, CACHE_TTL.APP_DETAILS);
+            return { content: [{ type: "text", text: resultText }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=get-aso-report.js.map

package/build/tools/get-aso-report.js.map

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

package/build/tools/keyword-gap.d.ts

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

package/build/tools/keyword-gap.d.ts.map

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

package/build/tools/keyword-gap.js

@@ -0,0 +1,116 @@
+import { z } from "zod";
+import { getAppDetails } 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 { extractTitleKeywords, calculateOpportunityScore, } from "../data-sources/custom-scoring.js";
+export function registerKeywordGap(server) {
+    server.tool("keyword_gap", "Analyzes the keyword difference between two apps. Shows which keywords are unique to each app and which are shared. Identifies opportunity keywords.", {
+        appId1: z
+            .string()
+            .describe("First app ID or bundle ID"),
+        appId2: z
+            .string()
+            .describe("Second app ID or bundle ID"),
+        country: z
+            .string()
+            .default("tr")
+            .describe("Country code"),
+    }, async ({ appId1, appId2, country }) => {
+        const cacheKey = `gap:${appId1}:${appId2}:${country}`;
+        const cached = getFromCache(cacheKey);
+        if (cached) {
+            return { content: [{ type: "text", text: cached }] };
+        }
+        try {
+            // Get details for both apps
+            const [app1, app2] = await Promise.all([
+                getAppDetails(appId1, country),
+                getAppDetails(appId2, country),
+            ]);
+            // Extract keywords: title + description
+            const extractAllKeywords = (app) => {
+                const titleKws = extractTitleKeywords(app.title || "");
+                const descKws = extractTitleKeywords((app.description || "").slice(0, 500));
+                return [...new Set([...titleKws, ...descKws])];
+            };
+            const keywords1 = extractAllKeywords(app1);
+            const keywords2 = extractAllKeywords(app2);
+            const set1 = new Set(keywords1);
+            const set2 = new Set(keywords2);
+            const onlyApp1 = keywords1.filter((kw) => !set2.has(kw));
+            const onlyApp2 = keywords2.filter((kw) => !set1.has(kw));
+            const shared = keywords1.filter((kw) => set2.has(kw));
+            // Opportunity keywords: in app2 but not in app1, with high traffic
+            const opportunities = [];
+            // Opportunities for app1 (in app2 but not in app1)
+            for (const kw of onlyApp2.slice(0, 15)) {
+                try {
+                    const scores = await getScores(kw, country);
+                    opportunities.push({
+                        keyword: kw,
+                        traffic: scores.traffic,
+                        difficulty: scores.difficulty,
+                        opportunityScore: calculateOpportunityScore(scores.traffic, scores.difficulty),
+                        source: `Unique to ${app2.title}`,
+                    });
+                }
+                catch {
+                    // continue
+                }
+            }
+            // Opportunities for app2 (in app1 but not in app2)
+            for (const kw of onlyApp1.slice(0, 15)) {
+                try {
+                    const scores = await getScores(kw, country);
+                    opportunities.push({
+                        keyword: kw,
+                        traffic: scores.traffic,
+                        difficulty: scores.difficulty,
+                        opportunityScore: calculateOpportunityScore(scores.traffic, scores.difficulty),
+                        source: `Unique to ${app1.title}`,
+                    });
+                }
+                catch {
+                    // continue
+                }
+            }
+            // Sort opportunities by score
+            opportunities.sort((a, b) => b.opportunityScore - a.opportunityScore);
+            const result = {
+                app1: {
+                    appId: appId1,
+                    title: app1.title,
+                    totalKeywords: keywords1.length,
+                },
+                app2: {
+                    appId: appId2,
+                    title: app2.title,
+                    totalKeywords: keywords2.length,
+                },
+                country,
+                comparison: {
+                    onlyApp1,
+                    onlyApp2,
+                    shared,
+                    overlapPercentage: shared.length > 0
+                        ? Math.round((shared.length /
+                            new Set([...keywords1, ...keywords2]).size) *
+                            100)
+                        : 0,
+                },
+                opportunities: opportunities.slice(0, 20),
+            };
+            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=keyword-gap.js.map

package/build/tools/keyword-gap.js.map

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

package/build/tools/localized-keywords.d.ts

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

package/build/tools/localized-keywords.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localized-keywords.d.ts","sourceRoot":"","sources":["../../src/tools/localized-keywords.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQpE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,QAyI1D"}

package/build/tools/localized-keywords.js

@@ -0,0 +1,107 @@
+import { z } from "zod";
+import { getScores } from "../data-sources/aso-scoring.js";
+import { searchApps } from "../data-sources/app-store.js";
+import { getFromCache, setCache } from "../cache/sqlite-cache.js";
+import { CACHE_TTL } from "../utils/constants.js";
+import { getCountryName } from "../utils/localization.js";
+export function registerLocalizedKeywords(server) {
+    server.tool("localized_keywords", "Adapts a set of keywords to different markets. Retrieves keyword scores (traffic/difficulty) for each country and shows top-ranking apps in each market. Used for multi-country ASO strategy.", {
+        keywords: z
+            .array(z.string())
+            .describe("List of keywords to analyze"),
+        sourceCountry: z
+            .string()
+            .default("tr")
+            .describe("Source country code"),
+        targetCountries: z
+            .array(z.string())
+            .describe("Target country codes (e.g. ['us', 'de', 'gb', 'fr'])"),
+    }, async ({ keywords, sourceCountry, targetCountries }) => {
+        const allCountries = [
+            sourceCountry,
+            ...targetCountries.filter((c) => c !== sourceCountry),
+        ];
+        const cacheKey = `localized:${keywords.join(",")}:${allCountries.join(",")}`;
+        const cached = getFromCache(cacheKey);
+        if (cached) {
+            return { content: [{ type: "text", text: cached }] };
+        }
+        try {
+            const localizations = [];
+            for (const country of allCountries) {
+                const kwResults = [];
+                for (const keyword of keywords.slice(0, 15)) {
+                    try {
+                        const scores = await getScores(keyword, country);
+                        // Get the top app for this keyword
+                        let topApp = "";
+                        try {
+                            const apps = await searchApps(keyword, country, 1);
+                            topApp = apps[0]?.title || "";
+                        }
+                        catch {
+                            // continue
+                        }
+                        kwResults.push({
+                            keyword,
+                            traffic: scores.traffic,
+                            difficulty: scores.difficulty,
+                            topApp,
+                        });
+                    }
+                    catch {
+                        kwResults.push({
+                            keyword,
+                            traffic: 0,
+                            difficulty: 0,
+                            topApp: "",
+                        });
+                    }
+                }
+                const avgTraffic = kwResults.length > 0
+                    ? kwResults.reduce((s, k) => s + k.traffic, 0) / kwResults.length
+                    : 0;
+                const best = [...kwResults].sort((a, b) => b.traffic - a.traffic || a.difficulty - b.difficulty)[0];
+                localizations.push({
+                    country,
+                    countryName: getCountryName(country),
+                    keywords: kwResults,
+                    bestKeyword: best?.keyword || null,
+                    avgTraffic: Math.round(avgTraffic * 10) / 10,
+                });
+            }
+            // Sort countries by average traffic
+            localizations.sort((a, b) => b.avgTraffic - a.avgTraffic);
+            // Keyword-based cross-country comparison
+            const crossCountry = {};
+            for (const kw of keywords.slice(0, 15)) {
+                crossCountry[kw] = localizations.map((loc) => {
+                    const kwData = loc.keywords.find((k) => k.keyword === kw);
+                    return {
+                        country: loc.country,
+                        traffic: kwData?.traffic ?? 0,
+                        difficulty: kwData?.difficulty ?? 0,
+                    };
+                });
+            }
+            const result = {
+                sourceCountry,
+                targetCountries,
+                totalKeywords: keywords.length,
+                localizations,
+                crossCountryComparison: crossCountry,
+                bestMarket: localizations[0]?.country || sourceCountry,
+            };
+            const resultText = JSON.stringify(result, null, 2);
+            setCache(cacheKey, resultText, CACHE_TTL.KEYWORD_SCORES);
+            return { content: [{ type: "text", text: resultText }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=localized-keywords.js.map

package/build/tools/localized-keywords.js.map

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

package/build/tools/optimize-metadata.d.ts

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

package/build/tools/optimize-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimize-metadata.d.ts","sourceRoot":"","sources":["../../src/tools/optimize-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQpE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,QAgMzD"}

package/build/tools/optimize-metadata.js

@@ -0,0 +1,156 @@
+import { z } from "zod";
+import { getAppDetails, searchApps } from "../data-sources/app-store.js";
+import { batchGetScores } from "../data-sources/aso-scoring.js";
+import { getFromCache, setCache } from "../cache/sqlite-cache.js";
+import { CACHE_TTL, CHAR_LIMITS } from "../utils/constants.js";
+import { extractTitleKeywords } from "../data-sources/custom-scoring.js";
+export function registerOptimizeMetadata(server) {
+    server.tool("optimize_metadata", "Provides optimization suggestions for an app's title, subtitle, and keyword field. Includes character limit checks. Improves metadata based on target keywords.", {
+        appId: z
+            .string()
+            .describe("App Store app ID or bundle ID"),
+        targetKeywords: z
+            .array(z.string())
+            .describe("List of target keywords"),
+        country: z
+            .string()
+            .default("tr")
+            .describe("Country code (tr, us, de, gb, fr...)"),
+    }, async ({ appId, targetKeywords, country }) => {
+        const cacheKey = `metadata:${appId}:${targetKeywords.join(",")}:${country}`;
+        const cached = getFromCache(cacheKey);
+        if (cached) {
+            return { content: [{ type: "text", text: cached }] };
+        }
+        try {
+            const app = await getAppDetails(appId, country);
+            // Get keyword scores (in parallel)
+            const keywordScores = {};
+            const batchResults = await batchGetScores(targetKeywords.slice(0, 15), country);
+            for (const r of batchResults) {
+                keywordScores[r.keyword] = { traffic: r.traffic, difficulty: r.difficulty };
+            }
+            // Sort keywords by traffic
+            const sortedKeywords = [...targetKeywords].sort((a, b) => {
+                const aScore = keywordScores[a]?.traffic ?? 0;
+                const bScore = keywordScores[b]?.traffic ?? 0;
+                return bScore - aScore;
+            });
+            // Current title keywords
+            const currentTitleKeywords = extractTitleKeywords(app.title || "");
+            // Title suggestion: include highest traffic keywords
+            const titleKeywordsToInclude = sortedKeywords.slice(0, 3);
+            const appName = (app.title || "").split(/[-:|]/)[0].trim();
+            const suggestedTitleParts = [appName];
+            const remainingChars = CHAR_LIMITS.TITLE - appName.length - 3;
+            if (remainingChars > 3) {
+                const suffix = titleKeywordsToInclude
+                    .filter((kw) => !appName.toLowerCase().includes(kw.toLowerCase()))
+                    .join(" ");
+                if (suffix.length <= remainingChars) {
+                    suggestedTitleParts.push(suffix);
+                }
+            }
+            const suggestedTitle = suggestedTitleParts.join(" - ").slice(0, CHAR_LIMITS.TITLE);
+            // Subtitle suggestion
+            const subtitleKeywords = sortedKeywords
+                .filter((kw) => !suggestedTitle.toLowerCase().includes(kw.toLowerCase()))
+                .slice(0, 4);
+            const suggestedSubtitle = subtitleKeywords
+                .join(", ")
+                .slice(0, CHAR_LIMITS.SUBTITLE);
+            // Keyword field suggestion (keywords not in title and subtitle)
+            const usedKeywords = new Set([
+                ...extractTitleKeywords(suggestedTitle),
+                ...extractTitleKeywords(suggestedSubtitle),
+            ].map((k) => k.toLowerCase()));
+            const keywordFieldWords = sortedKeywords
+                .filter((kw) => !usedKeywords.has(kw.toLowerCase()))
+                .concat(sortedKeywords.flatMap((kw) => kw
+                .split(/\s+/)
+                .filter((w) => w.length > 1 && !usedKeywords.has(w.toLowerCase()))));
+            const uniqueFieldWords = [...new Set(keywordFieldWords)];
+            let keywordField = "";
+            for (const word of uniqueFieldWords) {
+                const next = keywordField
+                    ? keywordField + "," + word
+                    : word;
+                if (next.length <= CHAR_LIMITS.KEYWORD_FIELD) {
+                    keywordField = next;
+                }
+            }
+            // Competitor analysis: what top apps use for the same keyword
+            let competitorKeywords = [];
+            try {
+                const topApps = await searchApps(sortedKeywords[0] || app.title, country, 5);
+                competitorKeywords = [
+                    ...new Set(topApps.flatMap((a) => extractTitleKeywords(a.title || ""))),
+                ].filter((kw) => !usedKeywords.has(kw));
+            }
+            catch {
+                // continue
+            }
+            // Warnings
+            const warnings = [];
+            if (suggestedTitle.length > CHAR_LIMITS.TITLE) {
+                warnings.push(`Title is ${suggestedTitle.length} chars — limit is ${CHAR_LIMITS.TITLE}`);
+            }
+            if (suggestedSubtitle.length > CHAR_LIMITS.SUBTITLE) {
+                warnings.push(`Subtitle is ${suggestedSubtitle.length} chars — limit is ${CHAR_LIMITS.SUBTITLE}`);
+            }
+            if (keywordField.length > CHAR_LIMITS.KEYWORD_FIELD) {
+                warnings.push(`Keyword field is ${keywordField.length} chars — limit is ${CHAR_LIMITS.KEYWORD_FIELD}`);
+            }
+            if (keywordField.includes(" ")) {
+                warnings.push("Do not use spaces in the keyword field — separate with commas");
+            }
+            const result = {
+                appId,
+                country,
+                current: {
+                    title: app.title || "",
+                    titleLength: (app.title || "").length,
+                    titleKeywords: currentTitleKeywords,
+                },
+                suggested: {
+                    title: suggestedTitle,
+                    titleLength: suggestedTitle.length,
+                    subtitle: suggestedSubtitle,
+                    subtitleLength: suggestedSubtitle.length,
+                    keywordField,
+                    keywordFieldLength: keywordField.length,
+                },
+                characterLimits: {
+                    title: {
+                        used: suggestedTitle.length,
+                        max: CHAR_LIMITS.TITLE,
+                        remaining: CHAR_LIMITS.TITLE - suggestedTitle.length,
+                    },
+                    subtitle: {
+                        used: suggestedSubtitle.length,
+                        max: CHAR_LIMITS.SUBTITLE,
+                        remaining: CHAR_LIMITS.SUBTITLE - suggestedSubtitle.length,
+                    },
+                    keywords: {
+                        used: keywordField.length,
+                        max: CHAR_LIMITS.KEYWORD_FIELD,
+                        remaining: CHAR_LIMITS.KEYWORD_FIELD - keywordField.length,
+                    },
+                },
+                keywordScores,
+                competitorKeywords: competitorKeywords.slice(0, 15),
+                warnings,
+            };
+            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=optimize-metadata.js.map

package/build/tools/optimize-metadata.js.map

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

package/build/tools/search-keywords.d.ts

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

package/build/tools/search-keywords.d.ts.map

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