Store Scraper MCP

Instructions

Implementation Reference

• src/server.js:308-343 (handler)

  The handler function that implements the core logic of the 'developer' tool: validates input, builds URL, fetches data from App Store, parses apps, and formats response.

  async function handleDeveloper(args) {
    try {
      const { devId, country = 'us', lang = 'en' } = args;
  
      if (!devId) {
        throw new Error('devId is required');
      }
  
      const url = buildDeveloperUrl({ devId, country, lang });
      const data = await fetchJSON(url);
      const apps = parseApps(data);
  
      return {
        content: [
          {
            type: 'text',
            text: JSON.stringify({
              developerId: devId,
              apps,
              count: apps.length,
            }, null, 2),
          },
        ],
      };
    } catch (error) {
      return {
        content: [
          {
            type: 'text',
            text: JSON.stringify({ error: error.message }, null, 2),
          },
        ],
        isError: true,
      };
    }
  }

• src/server.js:1083-1105 (schema)

  The input schema definition for the 'developer' tool, registered in ListToolsRequestSchema handler.

    name: 'developer',
    description: 'Get all apps by a developer',
    inputSchema: {
      type: 'object',
      properties: {
        devId: {
          type: 'number',
          description: 'iTunes artistId of the developer (e.g., 284882218 for Facebook)',
        },
        country: {
          type: 'string',
          description: 'Two-letter country code (default: us)',
          default: 'us',
        },
        lang: {
          type: 'string',
          description: 'Language code (default: en)',
          default: 'en',
        },
      },
      required: ['devId'],
    },
  },

• src/server.js:1457-1458 (registration)

  Registration of the 'developer' tool handler in the switch statement of CallToolRequestSchema handler.

  case 'similar':
    return await handleSimilar(args);

• src/endpoints/appStore.js:62-72 (helper)

  Helper function to construct the iTunes lookup URL for developer apps, used by the 'developer' handler.

  export function buildDeveloperUrl(params) {
    const { devId, country = 'us', lang = 'en' } = params;
    const queryParams = new URLSearchParams({
      id: devId.toString(),
      country: country,
      lang: lang,
      entity: 'software',
    });
    
    return `${ITUNES_BASE}/lookup?${queryParams.toString()}`;
  }