appstore-mcp 1.0.0

package/src/services/app-store-service.ts

@@ -0,0 +1,236 @@
+import axios from 'axios';
+import { App, Platform, PricingType } from '../types';
+
+const ITUNES_SEARCH_URL = 'https://itunes.apple.com/search';
+const ITUNES_LOOKUP_URL = 'https://itunes.apple.com/lookup';
+const ITUNES_RSS_BASE = 'https://itunes.apple.com';
+
+interface SearchResponse {
+    resultCount: number;
+    results: ItunesSearchResult[];
+}
+
+interface ItunesSearchResult {
+    trackId: number;
+    trackName: string;
+    trackViewUrl: string;
+    artworkUrl100: string;
+    artistName: string;
+    averageUserRating?: number;
+    userRatingCount?: number;
+    releaseDate?: string;
+    currentVersionReleaseDate?: string;
+    description?: string;
+    version?: string;
+    price?: number;
+    formattedPrice?: string;
+    primaryGenreName?: string;
+    genres?: string[];
+    screenshotUrls?: string[];
+    ipadScreenshotUrls?: string[];
+    bundleId?: string;
+    minimumOsVersion?: string;
+    fileSizeBytes?: string;
+    contentAdvisoryRating?: string;
+}
+
+interface RssEntry {
+    'im:name': { label: string };
+    'im:image': { label: string }[];
+    id: {
+        label: string;
+        attributes: { 'im:id': string };
+    };
+    'im:artist': { label: string };
+    'im:releaseDate'?: { label: string };
+    summary?: { label: string };
+    'im:price'?: { label: string };
+    category?: {
+        attributes: { label: string };
+    };
+}
+
+interface RssResponse {
+    feed: {
+        entry: RssEntry[];
+    };
+}
+
+export class AppStoreService {
+    private static getFeedName(platform: Platform, pricingType: PricingType): string {
+        const feedMap: Record<Platform, Record<PricingType, string>> = {
+            iphone: {
+                free: 'topfreeapplications',
+                paid: 'toppaidapplications',
+                grossing: 'topgrossingapplications',
+            },
+            ipad: {
+                free: 'topfreeipadapplications',
+                paid: 'toppaidipadapplications',
+                grossing: 'topgrossingipadapplications',
+            },
+            mac: {
+                free: 'topfreemacapps',
+                paid: 'toppaidmacapps',
+                grossing: 'topgrossingmacapps',
+            },
+            tv: {
+                free: 'topfreeappletvapps',
+                paid: 'toppaidappletvapps',
+                grossing: 'topgrossingappletvapps',
+            },
+        };
+
+        return feedMap[platform][pricingType];
+    }
+
+    private static buildRssUrl(
+        countryCode: string,
+        feedName: string,
+        limit: number,
+        categoryId?: string
+    ): string {
+        const genrePart = categoryId ? `/genre=${categoryId}` : '';
+        return `${ITUNES_RSS_BASE}/${countryCode}/rss/${feedName}/limit=${limit}${genrePart}/json`;
+    }
+
+    private static parseSearchResult(item: ItunesSearchResult): App {
+        return {
+            id: String(item.trackId),
+            name: item.trackName,
+            url: item.trackViewUrl,
+            iconUrl: item.artworkUrl100,
+            artistName: item.artistName,
+            averageUserRating: item.averageUserRating,
+            userRatingCount: item.userRatingCount,
+            releaseDate: item.releaseDate,
+            currentVersionReleaseDate: item.currentVersionReleaseDate,
+            description: item.description,
+            version: item.version,
+            price: item.price,
+            formattedPrice: item.formattedPrice,
+            primaryGenreName: item.primaryGenreName,
+            genres: item.genres,
+            screenshotUrls: item.screenshotUrls,
+            ipadScreenshotUrls: item.ipadScreenshotUrls,
+            bundleId: item.bundleId,
+            minimumOsVersion: item.minimumOsVersion,
+            fileSizeBytes: item.fileSizeBytes,
+            contentAdvisoryRating: item.contentAdvisoryRating,
+        };
+    }
+
+    private static parseRssEntry(entry: RssEntry): App {
+        const images = entry['im:image'] || [];
+        const largestImage = images.length > 0 ? images[images.length - 1].label : '';
+
+        return {
+            id: entry.id.attributes['im:id'],
+            name: entry['im:name'].label,
+            url: entry.id.label,
+            iconUrl: largestImage,
+            artistName: entry['im:artist'].label,
+            releaseDate: entry['im:releaseDate']?.label,
+            description: entry.summary?.label,
+            formattedPrice: entry['im:price']?.label,
+            primaryGenreName: entry.category?.attributes.label,
+        };
+    }
+
+    static async searchApps(query: string, country: string = 'US', limit: number = 25): Promise<App[]> {
+        const params = {
+            term: query,
+            country: country,
+            media: 'software',
+            entity: 'software',
+            limit: limit,
+        };
+
+        const response = await axios.get<SearchResponse>(ITUNES_SEARCH_URL, { params });
+        return response.data.results.map(this.parseSearchResult);
+    }
+
+    static async getAppDetails(appId: string, country: string = 'US'): Promise<App | null> {
+        const params = {
+            id: appId,
+            country: country,
+        };
+
+        const response = await axios.get<SearchResponse>(ITUNES_LOOKUP_URL, { params });
+
+        if (response.data.resultCount === 0) {
+            return null;
+        }
+
+        return this.parseSearchResult(response.data.results[0]);
+    }
+
+    static async lookupMultipleApps(
+        appIds: string[],
+        country: string = 'US'
+    ): Promise<Map<string, App>> {
+        const params = {
+            id: appIds.join(','),
+            country: country,
+        };
+
+        const response = await axios.get<SearchResponse>(ITUNES_LOOKUP_URL, { params });
+        const appMap = new Map<string, App>();
+
+        for (const result of response.data.results) {
+            const app = this.parseSearchResult(result);
+            appMap.set(app.id, app);
+        }
+
+        return appMap;
+    }
+
+    static async getTrendingApps(
+        platform: Platform = 'iphone',
+        pricingType: PricingType = 'free',
+        country: string = 'US',
+        categoryId?: string,
+        limit: number = 25
+    ): Promise<App[]> {
+        const feedName = this.getFeedName(platform, pricingType);
+        const url = this.buildRssUrl(country, feedName, limit, categoryId);
+
+        const response = await axios.get<RssResponse>(url);
+        const entries = response.data.feed.entry || [];
+
+        return entries.map(this.parseRssEntry);
+    }
+
+    static async getAppReleaseInfo(
+        appId: string,
+        country: string = 'US'
+    ): Promise<{ releaseDate?: string; currentVersionReleaseDate?: string; version?: string } | null> {
+        const app = await this.getAppDetails(appId, country);
+
+        if (!app) {
+            return null;
+        }
+
+        return {
+            releaseDate: app.releaseDate,
+            currentVersionReleaseDate: app.currentVersionReleaseDate,
+            version: app.version,
+        };
+    }
+
+    static async getAppScreenshots(
+        appId: string,
+        country: string = 'US'
+    ): Promise<{ screenshotUrls: string[]; ipadScreenshotUrls: string[] } | null> {
+        const app = await this.getAppDetails(appId, country);
+
+        if (!app) {
+            return null;
+        }
+
+        return {
+            screenshotUrls: app.screenshotUrls || [],
+            ipadScreenshotUrls: app.ipadScreenshotUrls || [],
+        };
+    }
+}

package/src/types.ts

@@ -0,0 +1,77 @@
+export interface App {
+    id: string;
+    name: string;
+    url: string;
+    iconUrl: string;
+    artistName: string;
+    averageUserRating?: number;
+    userRatingCount?: number;
+    releaseDate?: string;
+    currentVersionReleaseDate?: string;
+    description?: string;
+    version?: string;
+    price?: number;
+    formattedPrice?: string;
+    primaryGenreName?: string;
+    genres?: string[];
+    screenshotUrls?: string[];
+    ipadScreenshotUrls?: string[];
+    bundleId?: string;
+    minimumOsVersion?: string;
+    fileSizeBytes?: string;
+    contentAdvisoryRating?: string;
+}
+
+export interface Category {
+    id: string;
+    name: string;
+    emoji: string;
+}
+
+export type Platform = 'iphone' | 'ipad' | 'mac' | 'tv';
+export type PricingType = 'free' | 'paid' | 'grossing';
+
+export interface Country {
+    code: string;
+    name: string;
+}
+
+export const APP_STORE_CATEGORIES: Category[] = [
+    { id: '6000', name: 'Business', emoji: '💼' },
+    { id: '6001', name: 'Weather', emoji: '🌤️' },
+    { id: '6002', name: 'Utilities', emoji: '🔧' },
+    { id: '6003', name: 'Travel', emoji: '✈️' },
+    { id: '6004', name: 'Sports', emoji: '⚽' },
+    { id: '6005', name: 'Social Networking', emoji: '👥' },
+    { id: '6006', name: 'Reference', emoji: '📚' },
+    { id: '6007', name: 'Productivity', emoji: '📊' },
+    { id: '6008', name: 'Photo & Video', emoji: '📷' },
+    { id: '6009', name: 'News', emoji: '📰' },
+    { id: '6010', name: 'Navigation', emoji: '🧭' },
+    { id: '6011', name: 'Music', emoji: '🎵' },
+    { id: '6012', name: 'Lifestyle', emoji: '🌟' },
+    { id: '6013', name: 'Health & Fitness', emoji: '💪' },
+    { id: '6014', name: 'Games', emoji: '🎮' },
+    { id: '6015', name: 'Finance', emoji: '💰' },
+    { id: '6016', name: 'Entertainment', emoji: '🎬' },
+    { id: '6017', name: 'Education', emoji: '🎓' },
+    { id: '6018', name: 'Books', emoji: '📖' },
+    { id: '6020', name: 'Medical', emoji: '🏥' },
+    { id: '6021', name: 'Magazines & Newspapers', emoji: '📰' },
+    { id: '6022', name: 'Catalogs', emoji: '📋' },
+    { id: '6023', name: 'Food & Drink', emoji: '🍔' },
+    { id: '6024', name: 'Shopping', emoji: '🛒' },
+];
+
+export const PLATFORMS: { value: Platform; label: string; emoji: string }[] = [
+    { value: 'iphone', label: 'iPhone', emoji: '📱' },
+    { value: 'ipad', label: 'iPad', emoji: '📲' },
+    { value: 'mac', label: 'Mac', emoji: '💻' },
+    { value: 'tv', label: 'Apple TV', emoji: '📺' },
+];
+
+export const PRICING_TYPES: { value: PricingType; label: string; emoji: string }[] = [
+    { value: 'free', label: 'Free', emoji: '🆓' },
+    { value: 'paid', label: 'Paid', emoji: '💵' },
+    { value: 'grossing', label: 'Top Grossing', emoji: '💰' },
+];

package/tsconfig.json

@@ -0,0 +1,21 @@
+{
+    "compilerOptions": {
+        "target": "ES2022",
+        "module": "commonjs",
+        "lib": ["ES2022"],
+        "outDir": "./dist",
+        "rootDir": "./src",
+        "strict": true,
+        "esModuleInterop": true,
+        "skipLibCheck": true,
+        "forceConsistentCasingInFileNames": true,
+        "resolveJsonModule": true,
+        "declaration": true,
+        "declarationMap": true,
+        "inlineSourceMap": true,
+        "noUnusedLocals": false,
+        "noUnusedParameters": false
+    },
+    "include": ["src/**/*"],
+    "exclude": ["node_modules", "dist"]
+}