sensor-tower-mcp-pro 1.2.10

package/dist/tools/store-marketing.js

@@ -0,0 +1,170 @@
+"use strict";
+/**
+ * Store Marketing tools for Sensor Tower MCP
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerStoreMarketingTools = registerStoreMarketingTools;
+const utils_1 = require("../utils");
+function registerStoreMarketingTools(client) {
+    return {
+        get_featured_today_stories: {
+            description: 'Retrieve featured Today stories from the App Store.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    country: { type: 'string', description: 'ISO country code', default: 'US' },
+                    start_date: { type: 'string', description: 'Start date (YYYY-MM-DD)' },
+                    end_date: { type: 'string', description: 'End date (YYYY-MM-DD)' },
+                },
+                required: [],
+            },
+            handler: async (args) => {
+                const params = { country: args.country || 'US' };
+                if (args.start_date)
+                    params.start_date = (0, utils_1.validateDateFormat)(args.start_date);
+                if (args.end_date)
+                    params.end_date = (0, utils_1.validateDateFormat)(args.end_date);
+                return client.makeRequest('/v1/ios/featured/today/stories', params);
+            },
+        },
+        get_featured_apps: {
+            description: 'Retrieve featured apps on the App Store Apps & Games pages.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    category: { type: 'string', description: 'Category identifier' },
+                    country: { type: 'string', description: 'ISO country code', default: 'US' },
+                    start_date: { type: 'string', description: 'Start date (YYYY-MM-DD)' },
+                    end_date: { type: 'string', description: 'End date (YYYY-MM-DD)' },
+                },
+                required: ['category'],
+            },
+            handler: async (args) => {
+                const params = {
+                    category: args.category,
+                    country: args.country || 'US',
+                };
+                if (args.start_date)
+                    params.start_date = (0, utils_1.validateDateFormat)(args.start_date);
+                if (args.end_date)
+                    params.end_date = (0, utils_1.validateDateFormat)(args.end_date);
+                return client.makeRequest('/v1/ios/featured/apps', params);
+            },
+        },
+        get_featured_creatives: {
+            description: 'Retrieve featured creatives and their positions over time.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    os: { type: 'string', enum: ['ios', 'android'], description: 'Operating system' },
+                    app_id: { type: 'string', description: 'App identifier' },
+                    countries: { type: 'string', description: 'Comma-separated country codes' },
+                    types: { type: 'string', description: 'Comma-separated creative types' },
+                    start_date: { type: 'string', description: 'Start date (YYYY-MM-DD)' },
+                    end_date: { type: 'string', description: 'End date (YYYY-MM-DD)' },
+                },
+                required: ['os', 'app_id'],
+            },
+            handler: async (args) => {
+                const os = (0, utils_1.validateOsParameter)(args.os, ['ios', 'android']);
+                const params = { app_id: args.app_id };
+                if (args.countries)
+                    params.countries = args.countries;
+                if (args.types)
+                    params.types = args.types;
+                if (args.start_date)
+                    params.start_date = (0, utils_1.validateDateFormat)(args.start_date);
+                if (args.end_date)
+                    params.end_date = (0, utils_1.validateDateFormat)(args.end_date);
+                return client.makeRequest(`/v1/${os}/featured/creatives`, params);
+            },
+        },
+        get_keywords: {
+            description: 'Get current keyword rankings for an app.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    os: { type: 'string', enum: ['ios', 'android'], description: 'Operating system' },
+                    app_id: { type: 'string', description: 'App identifier' },
+                    country: { type: 'string', description: 'ISO country code', default: 'US' },
+                },
+                required: ['os', 'app_id'],
+            },
+            handler: async (args) => {
+                const os = (0, utils_1.validateOsParameter)(args.os, ['ios', 'android']);
+                return client.makeRequest(`/v1/${os}/keywords/get_current_keywords`, {
+                    app_id: args.app_id,
+                    country: args.country || 'US',
+                });
+            },
+        },
+        get_reviews: {
+            description: 'Get app reviews and ratings data.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    os: { type: 'string', enum: ['ios', 'android'], description: 'Operating system' },
+                    app_id: { type: 'string', description: 'App identifier' },
+                    country: { type: 'string', description: 'ISO country code' },
+                    start_date: { type: 'string', description: 'Filter reviews from this date' },
+                    end_date: { type: 'string', description: 'Filter reviews up to this date' },
+                    rating_filter: { type: 'string', description: 'Filter by rating or sentiment' },
+                    search_term: { type: 'string', description: 'Filter by review content' },
+                    username: { type: 'string', description: 'Filter by reviewer username' },
+                    limit: { type: 'number', description: 'Max reviews (1-200)', default: 50 },
+                    page: { type: 'number', description: 'Page number', default: 1 },
+                },
+                required: ['os', 'app_id', 'country'],
+            },
+            handler: async (args) => {
+                const os = (0, utils_1.validateOsParameter)(args.os, ['ios', 'android']);
+                const params = {
+                    app_id: args.app_id,
+                    country: args.country,
+                };
+                if (args.start_date)
+                    params.start_date = (0, utils_1.validateDateFormat)(args.start_date);
+                if (args.end_date)
+                    params.end_date = (0, utils_1.validateDateFormat)(args.end_date);
+                if (args.rating_filter)
+                    params.rating_filter = args.rating_filter;
+                if (args.search_term)
+                    params.search_term = args.search_term;
+                if (args.username)
+                    params.username = args.username;
+                if (args.limit)
+                    params.limit = args.limit;
+                if (args.page)
+                    params.page = args.page;
+                return client.makeRequest(`/v1/${os}/review/get_reviews`, params);
+            },
+        },
+        research_keyword: {
+            description: 'Retrieve keyword research metadata including related terms and difficulty.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    os: { type: 'string', enum: ['ios', 'android'], description: 'Operating system' },
+                    term: { type: 'string', description: 'Keyword term to research' },
+                    country: { type: 'string', description: 'ISO country code' },
+                    app_id: { type: 'number', description: 'App ID for ranking prediction (iOS only)' },
+                    page: { type: 'number', description: 'Page number' },
+                },
+                required: ['os', 'term', 'country'],
+            },
+            handler: async (args) => {
+                const os = (0, utils_1.validateOsParameter)(args.os, ['ios', 'android']);
+                const params = {
+                    term: args.term,
+                    country: args.country,
+                };
+                if (args.app_id)
+                    params.app_id = args.app_id;
+                if (args.page)
+                    params.page = args.page;
+                return client.makeRequest(`/v1/${os}/keywords/research_keyword`, params);
+            },
+        },
+    };
+}
+//# sourceMappingURL=store-marketing.js.map

package/dist/tools/store-marketing.js.map

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

package/dist/tools/utilities.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Utility tools for Sensor Tower MCP
+ */
+export declare function registerUtilityTools(): {
+    get_country_codes: {
+        description: string;
+        inputSchema: {
+            type: string;
+            properties: {};
+            required: never[];
+        };
+        handler: () => Promise<{
+            countries: {
+                code: string;
+                name: string;
+            }[];
+            total_count: number;
+        }>;
+    };
+    get_category_ids: {
+        description: string;
+        inputSchema: {
+            type: string;
+            properties: {
+                os: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: any) => Promise<{
+            categories: {
+                id: string;
+                name: string;
+            }[];
+            os: any;
+            total_count: number;
+        }>;
+    };
+    get_chart_types: {
+        description: string;
+        inputSchema: {
+            type: string;
+            properties: {};
+            required: never[];
+        };
+        handler: () => Promise<{
+            chart_types: {
+                topfreeapplications: string;
+                toppaidapplications: string;
+                topgrossingapplications: string;
+                topfreeipadapplications: string;
+                toppaidipadadapplications: string;
+                topgrossingipadadapplications: string;
+            };
+        }>;
+    };
+    health_check: {
+        description: string;
+        inputSchema: {
+            type: string;
+            properties: {};
+            required: never[];
+        };
+        handler: () => Promise<{
+            status: string;
+            service: string;
+            transport: string;
+            api_base_url: string;
+            tools_available: number;
+        }>;
+    };
+};
+//# sourceMappingURL=utilities.d.ts.map

package/dist/tools/utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilities.d.ts","sourceRoot":"","sources":["../../src/tools/utilities.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA8FR,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4C9B"}

package/dist/tools/utilities.js

@@ -0,0 +1,140 @@
+"use strict";
+/**
+ * Utility tools for Sensor Tower MCP
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerUtilityTools = registerUtilityTools;
+function registerUtilityTools() {
+    // Country codes data
+    const countryCodes = [
+        { code: 'US', name: 'United States' },
+        { code: 'GB', name: 'United Kingdom' },
+        { code: 'CA', name: 'Canada' },
+        { code: 'AU', name: 'Australia' },
+        { code: 'DE', name: 'Germany' },
+        { code: 'FR', name: 'France' },
+        { code: 'JP', name: 'Japan' },
+        { code: 'KR', name: 'South Korea' },
+        { code: 'CN', name: 'China' },
+        { code: 'BR', name: 'Brazil' },
+        { code: 'IN', name: 'India' },
+        { code: 'MX', name: 'Mexico' },
+        { code: 'ES', name: 'Spain' },
+        { code: 'IT', name: 'Italy' },
+        { code: 'RU', name: 'Russia' },
+        { code: 'WW', name: 'Worldwide' },
+    ];
+    // iOS categories
+    const iosCategories = [
+        { id: '6000', name: 'Business' },
+        { id: '6001', name: 'Weather' },
+        { id: '6002', name: 'Utilities' },
+        { id: '6003', name: 'Travel' },
+        { id: '6004', name: 'Sports' },
+        { id: '6005', name: 'Social Networking' },
+        { id: '6006', name: 'Reference' },
+        { id: '6007', name: 'Productivity' },
+        { id: '6008', name: 'Photo & Video' },
+        { id: '6009', name: 'News' },
+        { id: '6010', name: 'Navigation' },
+        { id: '6011', name: 'Music' },
+        { id: '6012', name: 'Lifestyle' },
+        { id: '6013', name: 'Health & Fitness' },
+        { id: '6014', name: 'Games' },
+        { id: '6015', name: 'Finance' },
+        { id: '6016', name: 'Entertainment' },
+        { id: '6017', name: 'Education' },
+        { id: '6018', name: 'Books' },
+        { id: '6020', name: 'Medical' },
+        { id: '6021', name: 'Magazines & Newspapers' },
+        { id: '6022', name: 'Catalogs' },
+        { id: '6023', name: 'Food & Drink' },
+        { id: '6024', name: 'Shopping' },
+    ];
+    // Android categories
+    const androidCategories = [
+        { id: 'GAME', name: 'Games' },
+        { id: 'BUSINESS', name: 'Business' },
+        { id: 'COMMUNICATION', name: 'Communication' },
+        { id: 'EDUCATION', name: 'Education' },
+        { id: 'ENTERTAINMENT', name: 'Entertainment' },
+        { id: 'FINANCE', name: 'Finance' },
+        { id: 'HEALTH_AND_FITNESS', name: 'Health & Fitness' },
+        { id: 'LIFESTYLE', name: 'Lifestyle' },
+        { id: 'MUSIC_AND_AUDIO', name: 'Music & Audio' },
+        { id: 'NEWS_AND_MAGAZINES', name: 'News & Magazines' },
+        { id: 'PHOTOGRAPHY', name: 'Photography' },
+        { id: 'PRODUCTIVITY', name: 'Productivity' },
+        { id: 'SHOPPING', name: 'Shopping' },
+        { id: 'SOCIAL', name: 'Social' },
+        { id: 'SPORTS', name: 'Sports' },
+        { id: 'TOOLS', name: 'Tools' },
+        { id: 'TRAVEL_AND_LOCAL', name: 'Travel & Local' },
+        { id: 'VIDEO_PLAYERS', name: 'Video Players & Editors' },
+        { id: 'WEATHER', name: 'Weather' },
+    ];
+    return {
+        get_country_codes: {
+            description: 'Get list of available country codes for Sensor Tower API.',
+            inputSchema: {
+                type: 'object',
+                properties: {},
+                required: [],
+            },
+            handler: async () => {
+                return { countries: countryCodes, total_count: countryCodes.length };
+            },
+        },
+        get_category_ids: {
+            description: 'Get list of category IDs for iOS or Android.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    os: { type: 'string', enum: ['ios', 'android'], description: 'Operating system' },
+                },
+                required: ['os'],
+            },
+            handler: async (args) => {
+                const categories = args.os === 'ios' ? iosCategories : androidCategories;
+                return { categories, os: args.os, total_count: categories.length };
+            },
+        },
+        get_chart_types: {
+            description: 'List available ranking chart identifiers used by Sensor Tower.',
+            inputSchema: {
+                type: 'object',
+                properties: {},
+                required: [],
+            },
+            handler: async () => {
+                const chartTypes = {
+                    topfreeapplications: 'Top Free Apps',
+                    toppaidapplications: 'Top Paid Apps',
+                    topgrossingapplications: 'Top Grossing Apps',
+                    topfreeipadapplications: 'Top Free iPad Apps (iOS only)',
+                    toppaidipadadapplications: 'Top Paid iPad Apps (iOS only)',
+                    topgrossingipadadapplications: 'Top Grossing iPad Apps (iOS only)',
+                };
+                return { chart_types: chartTypes };
+            },
+        },
+        health_check: {
+            description: 'Lightweight status endpoint for monitoring and orchestration.',
+            inputSchema: {
+                type: 'object',
+                properties: {},
+                required: [],
+            },
+            handler: async () => {
+                return {
+                    status: 'healthy',
+                    service: 'Sensor Tower MCP Server (npm)',
+                    transport: 'stdio',
+                    api_base_url: 'https://api.sensortower.com',
+                    tools_available: 43,
+                };
+            },
+        },
+    };
+}
+//# sourceMappingURL=utilities.js.map

package/dist/tools/utilities.js.map

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

package/dist/tools/your-metrics.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Your Metrics tools for Sensor Tower MCP (Connected Apps)
+ */
+import { SensorTowerClient } from '../client';
+export declare function registerYourMetricsTools(client: SensorTowerClient): {
+    analytics_metrics: {
+        description: string;
+        inputSchema: {
+            type: string;
+            properties: {
+                app_ids: {
+                    type: string;
+                    description: string;
+                };
+                countries: {
+                    type: string;
+                    description: string;
+                };
+                start_date: {
+                    type: string;
+                    description: string;
+                };
+                end_date: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: any) => Promise<unknown>;
+    };
+    sources_metrics: {
+        description: string;
+        inputSchema: {
+            type: string;
+            properties: {
+                app_ids: {
+                    type: string;
+                    description: string;
+                };
+                countries: {
+                    type: string;
+                    description: string;
+                };
+                start_date: {
+                    type: string;
+                    description: string;
+                };
+                end_date: {
+                    type: string;
+                    description: string;
+                };
+                limit: {
+                    type: string;
+                    description: string;
+                };
+                offset: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: any) => Promise<unknown>;
+    };
+    sales_reports: {
+        description: string;
+        inputSchema: {
+            type: string;
+            properties: {
+                os: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                app_ids: {
+                    type: string;
+                    description: string;
+                };
+                countries: {
+                    type: string;
+                    description: string;
+                };
+                date_granularity: {
+                    type: string;
+                    enum: string[];
+                };
+                start_date: {
+                    type: string;
+                    description: string;
+                };
+                end_date: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: any) => Promise<unknown>;
+    };
+    unified_sales_reports: {
+        description: string;
+        inputSchema: {
+            type: string;
+            properties: {
+                start_date: {
+                    type: string;
+                    description: string;
+                };
+                end_date: {
+                    type: string;
+                    description: string;
+                };
+                date_granularity: {
+                    type: string;
+                    enum: string[];
+                };
+                unified_app_ids: {
+                    type: string;
+                    description: string;
+                };
+                itunes_app_ids: {
+                    type: string;
+                    description: string;
+                };
+                android_app_ids: {
+                    type: string;
+                    description: string;
+                };
+                countries: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: any) => Promise<unknown>;
+    };
+};
+//# sourceMappingURL=your-metrics.d.ts.map

package/dist/tools/your-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"your-metrics.d.ts","sourceRoot":"","sources":["../../src/tools/your-metrics.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAG9C,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;wBActC,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAwBH,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA2BH,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA2BH,GAAG;;EAiB9B"}