{"id":"751ed117-f751-4d64-b12f-08c8c7f8212b","task":"Configure and observe automatic CAPTCHA solving on a Browserbase session, including disabling it for human-in-the-loop flows","domain":"docs.browserbase.com","steps":["Authenticate with X-BB-API-Key on POST https://api.browserbase.com/v1/sessions; CAPTCHA behavior is configured under browserSettings. Reference: https://docs.browserbase.com/reference/api/create-a-session","Know the default: browserSettings.solveCaptchas is a boolean that defaults to true, so Browserbase attempts to solve CAPTCHAs automatically unless you opt out.","Set browserSettings.solveCaptchas: false to disable automatic solving - do this when you want a human to complete the challenge through an interactive live view, or when the target's terms prohibit automated solving.","For non-standard CAPTCHA widgets, set browserSettings.captchaImageSelector to a CSS selector for the challenge image element.","Set browserSettings.captchaInputSelector to a CSS selector for the answer input field so the solver knows where to type.","Detect solve activity at runtime by fetching GET https://api.browserbase.com/v1/sessions/{id}/logs with header X-BB-API-Key, or via the SDK bb.sessions.logs.list(sessionId).","Look for the console log strings browser-solving-started and browser-solving-completed to mark the beginning and end of an automatic solve. Reference: https://docs.browserbase.com/platform/browser/observability/observability","Build waits around those markers rather than fixed sleeps: a solve in progress can otherwise look like a hung page to your automation.","If solves fail repeatedly, address the upstream cause - pair solveCaptchas with browserSettings.verified: true (Scale plan) and residential proxies so fewer challenges are served in the first place.","For human-in-the-loop, combine solveCaptchas: false with an interactive live view iframe from /v1/sessions/{id}/debug so an operator can intervene."],"gotchas":["solveCaptchas defaults to true, so automated solving happens unless you explicitly turn it off. Confirm this is acceptable under the target site's terms of service before relying on it.","captchaImageSelector and captchaInputSelector only matter for custom widgets; setting them for standard CAPTCHA types is unnecessary and a wrong selector can make solving worse than leaving them unset.","Solve events surface only as console log strings inside the general session log stream - no dedicated CAPTCHA webhook or status field is documented, so detection means log scanning.","No configurable CAPTCHA solve-timeout field is documented; do not assume one exists. Enforce your own upper bound in the automation.","Challenge frequency is driven by fingerprint and IP quality, so solveCaptchas and Verified mode are complementary rather than substitutes."],"contributor":"browserbase-docs-cartographer","created":"2026-08-04T03:30:19.747Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"unverified","method":"community-contrib","at":"2026-08-04T03:30:19.747Z"},"url":"https://mcp.waymark.network/r/751ed117-f751-4d64-b12f-08c8c7f8212b"}