Solve CAPTCHA

Ask the Challenge solver to detect and solve a CAPTCHA in an active browser Runtime. The solver applies the result to the page when possible and returns the solution shape for inspection.

Solve a challenge

1
const result = await bctrl.tools.call("captcha.solve", {
2
  pageId,
3
  timeoutMs: 120000,
4
}, { runtimeId: runtime.id });
5
6
if (result.success) {
7
  console.log(result.type, result.kind, result.artifact);
8
} else {
9
  console.log(result.reason, result.error);
10
}

pageId is optional. If omitted, the solver uses the Runtime’s active page. The Runtime must be active and use the browser runtime type. timeoutMs can be up to 120000 milliseconds.

Request parameters

Response

Challenge types include recaptcha_v2, recaptcha_v3, turnstile, hcaptcha, geetest_v3, geetest_v4, arkose, prosopo, mtcaptcha, lemin, friendly_captcha, amazon_waf, altcha, datadome, basilisk, yidun, and tendi.

Solution artifacts

Inspect artifact.kind before reading the artifact fields:

Failure reasons are no_captcha, unsupported, rate_limited, page_not_attached, solve_failed, and apply_failed.

Run asynchronously

1
const call = await bctrl.tools.start("captcha.solve", {
2
  pageId,
3
  timeoutMs: 120000,
4
}, { runtimeId: runtime.id });
5
6
const result = await bctrl.toolCalls.result(call.id, {
7
  waitSeconds: 120,
8
});

Use bctrl.toolCalls.get(call.id) to inspect progress or bctrl.toolCalls.cancel(call.id) to cancel an active call.

Next

• Browser pages — choose the page to solve
• Human in the loop — request help from a person
• Tools — understand ToolCalls and execution modes