Stop Wasting API Calls: Detect What's Blocking Your Agent Before You Solve

Most AI agents handle web blocks the same way: hit a wall, throw a CAPTCHA solver at it, hope for the best.

The problem? Half the time it's not a CAPTCHA.

I've been building GateSolve, a CAPTCHA solving API for AI agents. And the most common failure pattern I see is agents submitting solve requests for pages that aren't actually blocked by a CAPTCHA.

They're blocked by:

• 
  JS challenges (Cloudflare interstitials that auto-resolve in 5-10 seconds)


• 
  Auth walls (login pages that need credentials, not CAPTCHA tokens)


• 
  Silent blocks (403 responses with no CAPTCHA at all)


• 
  Rate limits (429 responses that just need a backoff)

Solving a CAPTCHA on an auth-walled page does nothing. You burn credits and get nowhere.

The Fix: Classify Before You Solve

I built a free endpoint that classifies any URL's access block:

curl "https://gatesolve.dev/api/detect?url=https://example.com"

Response:

{

  "url": "https://example.com",

  "classification": "public-ok",

  "httpStatus": 200,

  "solvable": false,

  "confidence": 0.9,

  "details": "Page accessible, no blocks detected",

  "recommendation": "No action needed. URL is publicly accessible."

}

The classifications:

Real Example: CAPTCHA Detected

When a real CAPTCHA is found:

{

  "url": "https://some-protected-site.com",

  "classification": "captcha",

  "captchaType": "cloudflare-turnstile",

  "httpStatus": 403,

  "solvable": true,

  "confidence": 0.9,

  "recommendation": "Submit to GateSolve /api/solve with type=\"cloudflare-turnstile\". Extract siteKey from the page source."

}

Now you know what you're dealing with before spending a solve credit.

For Browser Automation: Client-Side Detection

If you're using Puppeteer or Playwright, our plugins now include detectBlock() — a DOM-level check that classifies the page after goto():

import { detectBlock, solveOnPage } from '@gatesolve/puppeteer-plugin';



const page = await browser.newPage();

await page.goto('https://target-site.com');



const block = await detectBlock(page);



if (block.classification === 'captcha' && block.solvable) {

  // Actually a CAPTCHA - solve it

  await solveOnPage(page, { apiKey: 'gs_...' });

} else if (block.classification === 'js-challenge') {

  // Just wait for Cloudflare to resolve

  await page.waitForTimeout(10000);

} else if (block.classification === 'auth-wall') {

  // Need credentials, not a CAPTCHA solve

  console.log('Login required');

}

This prevents the most common automation failure: your agent assumes the page loaded, tries to find elements on a Cloudflare interstitial, fails, retries, and spirals into a loop.

Install

# Puppeteer

npm install @gatesolve/puppeteer-plugin



# Playwright

npm install @gatesolve/playwright-plugin



# Python SDK

pip install gatesolve

The /api/detect endpoint requires no API key and no signup. Just hit it with a URL.

Links:

• 
  GateSolve — CAPTCHA solving API for AI agents


• 
  Status Page — Live system metrics


• API Docs


• Python SDK


• Puppeteer Plugin


• Playwright Plugin

Building agent infrastructure is weird. The biggest wins come from helping agents NOT do things — like not wasting a CAPTCHA solve on a login page.