{
  "name": "Social Browser Browser API",
  "version": "2026.09.11",
  "canonical": "https://social-browser.com/browser-api",
  "transport": {
    "discovery": "HTTP JSON",
    "control": "Chrome DevTools Protocol over WebSocket",
    "cdpVersion": "1.3"
  },
  "discovery": [
    "/json/version",
    "/json/list"
  ],
  "identityRules": {
    "runtimeIdsStable": false,
    "rediscoverAfter": [
      "restart",
      "reconnect"
    ],
    "examples": [
      "targetId",
      "webContentsId",
      "webSocketDebuggerUrl"
    ]
  },
  "preferredPaths": [
    "Browser API/CDP",
    "SOCIALBROWSER.page",
    "SOCIALBROWSER.page.runPuppeteer()"
  ],
  "notes": [
    "This is a Social Browser capability contract, not an OpenAPI description of CDP.",
    "Availability can depend on browser version, current policy and runtime target state."
  ],
  "schemaVersion": "1.1",
  "generatedHelpers": {
    "javascript": "/downloads/browser-api/social-browser-api.js",
    "python": "/downloads/browser-api/social_browser_api.py",
    "readme": "/downloads/browser-api/README.txt",
    "generator": "scripts/generate-browser-api-sdk.js",
    "scope": "Discovery and target-resolution helpers; CDP control remains protocol-native."
  },
  "discoverySemantics": {
    "versionEndpoint": "/json/version",
    "targetsEndpoint": "/json/list",
    "targetSelection": [
      "id",
      "type",
      "title",
      "url"
    ],
    "webSocketField": "webSocketDebuggerUrl"
  },
  "safety": {
    "bindAddress": "127.0.0.1",
    "rule": "Do not expose the debugging endpoint to untrusted networks.",
    "runtimeIdsMustBeRediscovered": true
  }
}