Skip to main content

Troubleshooting

Things not working? Let's fix that. Here are the most common issues and how to solve them.

Quick Wins​

Before diving deep, try these:

  • Start small - Test with 1 browser before scaling to 100
  • Use DevTools - Open Chrome DevTools to see what's actually happening
  • Check your proxies - Bad proxies cause 90% of issues
  • Slow down - Add delays between actions, websites hate robots that click too fast

Still stuck? Let's dig deeper.

Website Blocking You?​

Getting 403s, CAPTCHAs everywhere, or just blocked? Here's your checklist:

1. Fix Your Proxies​

Bad proxies are usually the culprit:

  • Datacenter proxies get detected instantly by good anti-bot systems
  • Residential proxies work much better (yes, they cost more)
  • Check your proxy quality at IPQualityScore
  • Match proxy location to the website (US proxies for US sites)
  • Rotate proxies, but not too fast

2. Slow Down​

Humans don't click 50 times per second:

  • Add 1-3 second delays between actions
  • Random delays look more natural than fixed ones
  • Respect the site's natural flow
  • Monitor for rate limit headers

3. Fix Your Browser Profile​

Try different setups:

  • Use our default fingerprints first (they're optimized)
  • If using custom fingerprints, keep them consistent
  • Enable these features if sites log you out:
    • Local Storage and IndexedDB (stores login sessions)
    • Service Workers (for sites like Telegram, but increases profile size)

4. Act Human​

The little things matter:

  • Navigation - Don't jump straight to target pages. Follow the natural flow
  • Mouse movement - Use curves, not straight lines
  • Scrolling - Vary speed, pause occasionally
  • Typing - Humans don't type at exactly 100ms intervals
  • Referrers - Coming from Google looks more natural than direct access

5. Still Getting CAPTCHAs?​

Some sites show CAPTCHAs to everyone (looking at you, Cloudflare Under Attack Mode). But if it's just you:

  • Create fresh profiles for new fingerprints
  • Check our CAPTCHA guide for optimization tips
  • Consider that some sites are just CAPTCHA-heavy
Getting Errors?

When contacting support, include:

  • Request and response headers
  • Error messages
  • The x-cloud-tracing-uuid header value

This helps us debug faster.

Performance Problems​

Everything Feels Slow?​

Welcome to cloud latency. Here's the reality:

Local vs Cloud Timing

  • Local: 5ms per command
  • Cloud: 100ms per command
  • With proxy: 300ms per command

That login flow with 10 commands? Goes from 50ms locally to 3 seconds in production.

Speed Hacks

  1. Run parallel operations - Don't process URLs one by one
  2. Reuse sessions - Skip login by saving cookies
  3. Block unnecessary stuff - CSS, images, ads
  4. Use domcontentloaded instead of waiting for full page loads
  5. Pick the right framework - Playwright/Puppeteer beat Selenium for speed

Persistent Profiles Save Time​

If you're logging in repeatedly, use persistent profiles:

  • Keep cookies between runs
  • Skip login flows
  • Maintain authenticated state
  • Store local data

Location Matters​

Your server in Tokyo hitting our US servers? That's your problem. Contact us about regional deployment.

CDP Errors in Logs​

Seeing these? They're normal, ignore them:

Protocol error Target.detachFromTarget: Target closed

  • Page closed before we could detach
  • Happens during navigation
  • Harmless race condition

Protocol error (Target.sendMessageToTarget): No session with given id

  • Tried to message a closed session
  • Common during cleanup
  • Also harmless

These aren't bugs. CDP is asynchronous and sometimes things close before messages arrive. It doesn't affect your automation.

Framework-Specific Tips​

Playwright​

# Fast input
await page.locator("input").fill("text")
# Not the slow typing simulation

Puppeteer​

// Fast navigation
await page.goto(url, {waitUntil: 'domcontentloaded'});
// Not waiting for everything to load

Selenium​

Consider switching to Playwright or Puppeteer. Seriously. The performance difference is huge.

Still Need Help?​

Tried everything? We're here:

Remember: most issues come down to proxies, speed, or trying to look too much like a robot. Fix those and you'll solve 90% of problems.