Store Scraper MCP

Instructions

Implementation Reference

• src/server.js:701-736 (handler)

  The handler function that implements the core logic for the 'gp_developer' tool. It constructs the developer URL, fetches the HTML, parses the app list using parseGPList, and returns structured JSON data or an error.

  async function handleGPDeveloper(args) {
    try {
      const { devId, country = 'us', lang = 'en', num = 60 } = args;
  
      if (!devId) {
        throw new Error('devId is required');
      }
  
      const url = buildGPDeveloperUrl({ devId, country, lang, num });
      const html = await fetchText(url);
      const apps = parseGPList(html); // Uses same parser as list
  
      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:1306-1329 (schema)

  The input schema definition for the 'gp_developer' tool, specifying parameters like devId (required), country, lang, and num.

  inputSchema: {
    type: 'object',
    properties: {
      devId: {
        type: 'string',
        description: 'Google Play developer ID',
      },
      country: {
        type: 'string',
        description: 'Two-letter country code (default: us)',
        default: 'us',
      },
      lang: {
        type: 'string',
        description: 'Language code (default: en)',
        default: 'en',
      },
      num: {
        type: 'number',
        description: 'Number of results (default: 60)',
        default: 60,
      },
    },
    required: ['devId'],

• src/server.js:1304-1331 (registration)

  The tool registration in the ListTools handler, defining name, description, and input schema for 'gp_developer'.

    name: 'gp_developer',
    description: '[Google Play] Get all apps by a developer',
    inputSchema: {
      type: 'object',
      properties: {
        devId: {
          type: 'string',
          description: 'Google Play developer ID',
        },
        country: {
          type: 'string',
          description: 'Two-letter country code (default: us)',
          default: 'us',
        },
        lang: {
          type: 'string',
          description: 'Language code (default: en)',
          default: 'en',
        },
        num: {
          type: 'number',
          description: 'Number of results (default: 60)',
          default: 60,
        },
      },
      required: ['devId'],
    },
  },

• src/server.js:1474-1475 (registration)

  The dispatch case in the CallToolRequestSchema handler that routes calls to the gp_developer handler function.

  case 'gp_developer':
    return await handleGPDeveloper(args);

• src/server.js:45-45 (helper)

  Import alias for the URL builder function used in the gp_developer handler, from './endpoints/googlePlay.js'.

  buildDeveloperUrl as buildGPDeveloperUrl,