naftiko: 1.0.0-alpha2
info:
  label: Bright Data Scraping Browser
  description: |
    Observability surface for Bright Data Scraping Browser sessions. Browser control itself flows over
    a CDP/WebSocket endpoint driven by Puppeteer/Playwright/Selenium; this capability exposes the REST
    inventory endpoints.
  tags:
  - Bright Data
  - Scraping Browser
  - Browser Automation
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    BRIGHTDATA_API_TOKEN: BRIGHTDATA_API_TOKEN
capability:
  consumes:
  - type: http
    namespace: scraping-browser
    baseUri: https://api.brightdata.com
    description: Bright Data Scraping Browser REST control plane.
    resources:
    - name: sessions
      path: /browser_sessions
      operations:
      - name: listSessions
        method: GET
        description: List Scraping Browser sessions.
        outputRawFormat: json
        outputParameters:
        - name: sessions
          type: array
          value: $.
        inputParameters:
        - name: zone
          in: query
          type: string
    - name: session
      path: /browser_sessions/{session_id}
      operations:
      - name: getSession
        method: GET
        description: Get a specific session.
        outputRawFormat: json
        outputParameters:
        - name: session
          type: object
          value: $.
        inputParameters:
        - name: session_id
          in: path
          type: string
          required: true
    authentication:
      type: apikey
      key: Authorization
      value: 'Bearer {{env.BRIGHTDATA_API_TOKEN}}'
      placement: header
  exposes:
  - type: mcp
    namespace: scraping-browser-mcp
    port: 9090
    transport: http
    description: MCP adapter for Bright Data Scraping Browser inventory.
    tools:
    - name: bright-data-browser-list-sessions
      description: List active Scraping Browser sessions.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: scraping-browser.listSessions
      with:
        zone: tools.zone
      outputParameters:
      - type: array
        mapping: $.
    - name: bright-data-browser-get-session
      description: Inspect a specific Scraping Browser session.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: scraping-browser.getSession
      with:
        session_id: tools.session_id
      outputParameters:
      - type: object
        mapping: $.