Tripadvisor Travel Content

naftiko: "1.0.0-alpha1"

info:
  label: "Tripadvisor Travel Content"
  description: >-
    Workflow capability for integrating Tripadvisor's travel content into applications.
    Combines location search, detail retrieval, photos, and reviews into a unified
    travel discovery and content enrichment workflow. Designed for travel apps,
    destination guides, hotel comparison sites, and restaurant recommendation platforms.
  tags:
    - Attractions
    - Content
    - Hotels
    - Locations
    - Restaurants
    - Reviews
    - Travel
  created: "2026-05-03"
  modified: "2026-05-03"

binds:
  - namespace: env
    keys:
      TRIPADVISOR_API_KEY: TRIPADVISOR_API_KEY

capability:
  consumes:
    - import: tripadvisor-content
      location: ./shared/content-api.yaml

  exposes:
    - type: rest
      port: 8080
      namespace: tripadvisor-travel-content-api
      description: "Unified REST API for discovering and displaying Tripadvisor travel content."
      resources:
        - path: /v1/locations/search
          name: location-search
          description: "Search for hotels, restaurants, and attractions"
          operations:
            - method: GET
              name: search-locations
              description: "Search Tripadvisor for locations by keyword and category"
              call: "tripadvisor-content.search-for-locations"
              with:
                searchQuery: "rest.searchQuery"
                category: "rest.category"
                language: "rest.language"
                latLong: "rest.latLong"
                radius: "rest.radius"
                radiusUnit: "rest.radiusUnit"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/locations/nearby
          name: nearby-search
          description: "Find nearby locations by coordinates"
          operations:
            - method: GET
              name: search-nearby
              description: "Find locations near a specific latitude/longitude"
              call: "tripadvisor-content.search-for-nearby-locations"
              with:
                latLong: "rest.latLong"
                category: "rest.category"
                language: "rest.language"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/locations/{locationId}
          name: location-details
          description: "Get full details for a specific location"
          operations:
            - method: GET
              name: get-location
              description: "Get name, address, rating, and listing URL for a location"
              call: "tripadvisor-content.get-location-details"
              with:
                locationId: "rest.locationId"
                language: "rest.language"
                currency: "rest.currency"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/locations/{locationId}/photos
          name: location-photos
          description: "Get photos for a location"
          operations:
            - method: GET
              name: get-photos
              description: "Get recent photos in multiple sizes"
              call: "tripadvisor-content.get-location-photos"
              with:
                locationId: "rest.locationId"
                language: "rest.language"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/locations/{locationId}/reviews
          name: location-reviews
          description: "Get recent traveler reviews"
          operations:
            - method: GET
              name: get-reviews
              description: "Get up to 5 most recent reviews for a location"
              call: "tripadvisor-content.get-location-reviews"
              with:
                locationId: "rest.locationId"
                language: "rest.language"
              outputParameters:
                - type: object
                  mapping: "$."

    - type: mcp
      port: 9090
      namespace: tripadvisor-travel-content-mcp
      transport: http
      description: "MCP server for AI-assisted travel content discovery and enrichment using Tripadvisor."
      tools:
        - name: search-travel-locations
          description: >-
            Search Tripadvisor for hotels, restaurants, or attractions by keyword,
            category, address, or geographic coordinates. Returns up to 10 matching
            locations with IDs, names, and addresses.
          hints:
            readOnly: true
            openWorld: true
          call: "tripadvisor-content.search-for-locations"
          with:
            searchQuery: "tools.searchQuery"
            category: "tools.category"
            language: "tools.language"
            latLong: "tools.latLong"
            radius: "tools.radius"
            radiusUnit: "tools.radiusUnit"
          outputParameters:
            - type: object
              mapping: "$."
        - name: find-nearby-attractions
          description: >-
            Find hotels, restaurants, or attractions near a specific geographic point.
            Provide latitude and longitude to discover what's nearby.
          hints:
            readOnly: true
            openWorld: true
          call: "tripadvisor-content.search-for-nearby-locations"
          with:
            latLong: "tools.latLong"
            category: "tools.category"
            language: "tools.language"
          outputParameters:
            - type: object
              mapping: "$."
        - name: get-location-details
          description: >-
            Get comprehensive details for a Tripadvisor location including name,
            address, overall rating, review count, ranking, categories, trip types,
            and direct link to the Tripadvisor listing.
          hints:
            readOnly: true
            openWorld: false
          call: "tripadvisor-content.get-location-details"
          with:
            locationId: "tools.locationId"
            language: "tools.language"
            currency: "tools.currency"
          outputParameters:
            - type: object
              mapping: "$."
        - name: get-location-photos
          description: >-
            Get recent high-quality photos for a Tripadvisor location.
            Returns photos in multiple size formats (thumbnail, small, medium, large, original).
          hints:
            readOnly: true
            openWorld: false
          call: "tripadvisor-content.get-location-photos"
          with:
            locationId: "tools.locationId"
            language: "tools.language"
          outputParameters:
            - type: object
              mapping: "$."
        - name: get-traveler-reviews
          description: >-
            Get the most recent traveler reviews for a Tripadvisor location.
            Reviews include rating, text, author, travel date, and trip type.
          hints:
            readOnly: true
            openWorld: false
          call: "tripadvisor-content.get-location-reviews"
          with:
            locationId: "tools.locationId"
            language: "tools.language"
          outputParameters:
            - type: object
              mapping: "$."