getListingPhotos

Instructions

Implementation Reference

• photoTools.ts:4-14 (schema)

  Defines the tool schema including input validation for the listing ID parameter.

  {
    name: 'getListingPhotos',
    description: 'Extract photo URLs from an Airbnb listing',
    inputSchema: {
      type: 'object',
      properties: {
        id: { type: 'string', description: 'Airbnb listing ID' },
      },
      required: ['id'],
    },
  },

• index.ts:138-141 (registration)

  Registers the getListingPhotos tool by including photoAnalysisTools in the main AIRBNB_TOOLS array used for listing tools.

    AIRBNB_SEARCH_TOOL,
    AIRBNB_LISTING_DETAILS_TOOL,
    ...photoAnalysisTools,
  ];

• index.ts:666-670 (registration)

  Registers the dispatching logic for getListingPhotos tool calls in the main CallToolRequestHandler switch statement.

  case "getListingPhotos":
  case "analyzeListingPhotos": {
    result = await handlePhotoAnalysisTool(request.params.name, request.params.arguments);
    break;
  }

• photoTools.ts:28-83 (handler)

  Main handler function for getListingPhotos tool: validates input, extracts photos, formats and returns MCP response.

  export async function handlePhotoAnalysisTool(toolName: string, toolInput: any) {
    try {
      const listingId = toolInput.id;
      if (!listingId) {
        return {
          content: [{ type: 'text', text: JSON.stringify({ error: 'Listing ID required' }) }],
          isError: true,
        };
      }
  
      const photos = await extractListingPhotos(listingId);
  
      if (toolName === 'getListingPhotos') {
        return {
          content: [
            {
              type: 'text',
              text: JSON.stringify({
                success: photos.extractionSuccess,
                photoCount: photos.photoCount,
                photoUrls: photos.photoUrls,
              }),
            },
          ],
          isError: !photos.extractionSuccess,
        };
      }
  
      if (toolName === 'analyzeListingPhotos') {
        return {
          content: [
            {
              type: 'text',
              text: JSON.stringify({
                success: photos.extractionSuccess,
                photoCount: photos.photoCount,
                analysisPrompt: formatPhotosForAnalysis(photos),
                photoUrls: photos.photoUrls,
              }),
            },
          ],
          isError: !photos.extractionSuccess,
        };
      }
  
      return {
        content: [{ type: 'text', text: JSON.stringify({ error: 'Unknown tool' }) }],
        isError: true,
      };
    } catch (error) {
      return {
        content: [{ type: 'text', text: JSON.stringify({ error: (error instanceof Error ? error.message : 'Unknown error') }) }],
        isError: true,
      };
    }
  }

• photoAnalyzer.ts:4-42 (helper)

  Helper function that performs the actual web scraping to extract photo URLs from the Airbnb listing page.

  export async function extractListingPhotos(listingId: string) {
    try {
      const url = `https://www.airbnb.com/rooms/${listingId}`;
      const response = await fetch(url, {
        headers: { 'User-Agent': 'Mozilla/5.0' },
      });
  
      if (!response.ok) throw new Error(`HTTP ${response.status}`);
  
      const html = await response.text();
      const $ = cheerio.load(html);
      const photoUrls: string[] = [];
  
      $('img[src*="airbnb"]').each((_: any, el: any) => {
        const src = $(el).attr('src');
        const alt = $(el).attr('alt');
        if (src && alt?.includes('photo') && photoUrls.length < 50) {
          if (!photoUrls.includes(src)) photoUrls.push(src);
        }
      });
  
      return {
        listingId,
        photoUrls,
        photoCount: photoUrls.length,
        extractionSuccess: photoUrls.length > 0,
        timestamp: new Date().toISOString(),
      };
    } catch (error) {
      return {
        listingId,
        photoUrls: [],
        photoCount: 0,
        extractionSuccess: false,
        error: (error instanceof Error ? error.message : 'Unknown error'),
        timestamp: new Date().toISOString(),
      };
    }
  }