How to Solve Captcha with Nanobrowser and CapSolver Integration

AI-powered browser automation has transformed how we interact with the web. Nanobrowser represents the cutting edge of this technology—an open-source Chrome extension that uses multi-agent AI systems to automate complex web tasks through natural language instructions.

However, even the most sophisticated AI agents encounter a common obstacle: CAPTCHA challenges. When your Nanobrowser agent navigates to a protected page, a reCAPTCHA or Cloudflare Turnstile can halt the entire workflow.

CapSolver provides the perfect complement to Nanobrowser's AI capabilities. By combining these tools, your autonomous agents can navigate through CAPTCHA-protected websites seamlessly, enabling truly hands-free web automation.

What is Nanobrowser?

Nanobrowser is an open-source Chrome extension for AI-powered web automation. It serves as a free alternative to OpenAI Operator, enabling users to automate browser tasks through natural language instructions without subscription fees.

Key Features of Nanobrowser

• Multi-Agent Architecture: Specialized AI agents work together—Planner reasons through tasks, Navigator executes interactions, Validator ensures success
• Local Execution: All processing occurs in your browser; credentials and data never leave your machine
• Flexible LLM Support: Connect OpenAI, Anthropic, Gemini, Ollama, Groq, and custom providers
• Zero Setup: Just install the extension and provide your API keys
• Interactive Chat: Real-time status updates and conversation management through a side panel

Multi-Agent System

Nanobrowser's power comes from its multi-agent architecture:

Supported Browsers

• Chrome (Full support)
• Edge (Full support)
• May function on other Chromium-based browsers

What is CapSolver?

CapSolver is a leading CAPTCHA solving service that provides AI-powered solutions for bypassing various CAPTCHA challenges. With support for multiple CAPTCHA types and lightning-fast response times, CapSolver integrates seamlessly into automated workflows.

Supported CAPTCHA Types

• reCAPTCHA v2 (image-based & invisible)
• reCAPTCHA v3 & v3 Enterprise
• Cloudflare Turnstile
• Cloudflare 5-second Challenge
• AWS WAF CAPTCHA
• Other widely used CAPTCHA and anti-bot mechanisms

Why Integrate CapSolver with Nanobrowser?

When building AI-powered automations that interact with protected websites, CAPTCHA challenges become a significant barrier. Here's why the integration matters:

1. Uninterrupted AI Workflows: Your agents continue executing tasks without manual CAPTCHA solving
2. True Automation: Achieve fully autonomous web operations from start to finish
3. Scalable Operations: Handle CAPTCHA challenges across multiple concurrent sessions
4. Cost-Effective: Pay only for successfully solved CAPTCHAs, the pricelist
5. High Success Rates: Industry-leading accuracy for all supported CAPTCHA types

Common Use Cases

Installation

Step 1: Install Nanobrowser

1. Visit the Chrome Web Store and search for "Nanobrowser"
2. Click Add to Chrome
3. Pin the extension to your toolbar for easy access

Alternatively, install from GitHub releases:

1. Download the latest release from GitHub
2. Go to chrome://extensions/
3. Enable Developer mode
4. Click Load unpacked and select the extension folder

Step 2: Configure Nanobrowser

1. Click the Nanobrowser icon in your toolbar
2. Go to Settings
3. Add your LLM API key (OpenAI, Anthropic, etc.)
4. Select your preferred model for each agent

Step 3: Install CapSolver Extension

1. Download the CapSolver browser extension from capsolver extension
2. Extract the extension files
3. Go to chrome://extensions/
4. Enable Developer mode
5. Click Load unpacked and select the CapSolver extension folder
6. Configure your CapSolver API key in the extension settings

Integration Methods

CapSolver Browser Extension

The simplest integration approach is running both extensions simultaneously. The CapSolver extension automatically detects and solves CAPTCHAs on any page your Nanobrowser agent visits.

Configuration

Configure the CapSolver extension with your API key:

How It Works

1. You give Nanobrowser a task: "Go to example.com and extract product prices"
2. The Navigator agent loads the page
3. CapSolver extension detects a reCAPTCHA
4. CapSolver automatically solves the CAPTCHA
5. Nanobrowser continues with the extraction task

This requires no special prompting—the extension handles CAPTCHAs transparently.

Extension Configuration Examples

CapSolver Extension Settings

Create or modify the CapSolver extension's configuration file:

---

## Task Prompt Templates

### Template 1: E-commerce Data Extraction

Task: Extract product information from an e-commerce site with bot protection

Target URL: https://shop.example.com/category/electronics

Instructions:

1. Navigate to the target URL
2. If you encounter Cloudflare protection or a CAPTCHA:
   • The CapSolver extension will handle it automatically
   • Wait up to 60 seconds for the page to fully load
3. Once on the product listing page, extract the following for each product:
   • Product name
   • Price (current and original if discounted)
   • Rating (stars and review count)
   • Availability status
4. Navigate through pagination (up to 5 pages)
5. If CAPTCHAs appear between pages, wait for auto-solve
6. Return all data as JSON

Expected output format:

{
    "products": [
        {
            "name": "...",
            "price": "...",
            "originalPrice": "...",
            "rating": "...",
            "reviews": "...",
            "inStock": true/false
        }
    ],
    "totalPages": 5,
    "captchasSolved": 0
}

Template 2: Form Submission with CAPTCHA

Task: Submit a contact form on a protected page

Target: https://example.com/contact

Form Data:
- Name: John Doe
- Email: john.doe@example.com
- Subject: Product Inquiry
- Message: I would like to learn more about your enterprise solutions.

Instructions:
1. Navigate to the contact page
2. Wait for any CAPTCHA to be solved automatically
3. Fill in all form fields with the provided data
4. Before clicking submit:
   - Verify a reCAPTCHA is present
   - Wait for CapSolver to generate a valid token
   - Confirm the CAPTCHA shows as solved (green checkmark)
5. Click the submit button
6. Wait for confirmation message
7. Report success or any errors

Note: If the form requires a CAPTCHA and it's not being solved,
wait an additional 30 seconds before retrying.

Template 3: Login Automation

Task: Automate login to a protected dashboard

Target: https://dashboard.example.com/login

Credentials:
- Username: provided_user
- Password: [wait for secure input]

Instructions:
1. Navigate to the login page
2. Handle any initial Cloudflare challenge:
   - Wait for Turnstile to be solved
   - Confirm page is fully loaded
3. Enter the username
4. Enter the password when provided
5. If reCAPTCHA is present:
   - Wait for CapSolver to solve it
   - Verify green checkmark appears
6. Click the login button
7. Handle any post-login CAPTCHAs
8. Confirm successful login by checking for dashboard elements
9. Report login status and any issues encountered

Timeout: 120 seconds total
CAPTCHA timeout: 60 seconds per challenge

Best Practices

1. Allow Adequate Time for CAPTCHA Solving

Always include waiting instructions in your prompts:

If a CAPTCHA appears, wait up to 60 seconds for the CapSolver
extension to solve it before proceeding or reporting an error.

2. Handle Multiple CAPTCHAs

Some workflows encounter multiple CAPTCHAs. Prepare your agents:

This workflow may encounter multiple CAPTCHA challenges:
- Initial page load (Cloudflare)
- Search results page (reCAPTCHA)
- Individual item pages (Turnstile)

For each CAPTCHA encountered, allow up to 45 seconds for auto-solve
before continuing to the next step.

3. Implement Fallback Behaviors

If a CAPTCHA is not solved within the timeout:
1. Refresh the page and try again
2. If it fails a second time, skip this item and continue
3. Log the failed URL for manual review

4. Respect Rate Limits

Between actions, add natural delays:
- After page navigation: 2-3 seconds
- After CAPTCHA solve: 1-2 seconds
- Between form fields: 0.5-1 second

This helps avoid triggering additional bot detection.

Troubleshooting

CAPTCHA Not Being Solved

1. Check CapSolver Extension

   • Ensure the extension is enabled
   • Verify API key is correct
   • Check balance is sufficient

2. Verify CAPTCHA Type Support

   • Confirm the CAPTCHA type is supported
   • Check if the specific site key is valid

3. Extension Conflicts

   • Disable other automation/ad-blocking extensions temporarily
   • Ensure extensions have proper permissions

Nanobrowser Agent Timeouts

1. Increase Wait Times

   • Some CAPTCHAs take longer to solve
   • Add explicit wait instructions in prompts

2. Check LLM Response

   • Verify your LLM API key is valid
   • Ensure adequate rate limits

Page Not Loading After CAPTCHA

1. Add Post-Solve Delay

   Copy

   After the CAPTCHA is solved, wait 3 seconds for the page to fully reload.

2. Check for JavaScript Redirects

   • Some sites redirect after CAPTCHA solve
   • Instruct agent to wait for final URL

Conclusion

The combination of Nanobrowser and CapSolver creates a powerful toolkit for AI-powered web automation:

• Nanobrowser provides intelligent multi-agent browser automation
• CapSolver handles CAPTCHA challenges automatically
• Together they enable fully autonomous web workflows

Whether you're building data extraction pipelines, automating repetitive tasks, or creating intelligent web agents, this combination provides the reliability and capability needed for production use.

Ready to get started? Sign up for CapSolver and use bonus code NANOBROWSER for an extra 6% bonus on your first recharge!

FAQ

What is Nanobrowser?

Nanobrowser is an open-source Chrome extension for AI-powered web automation. It uses a multi-agent system (Planner, Navigator, Validator) to execute complex web tasks through natural language instructions. It's a free alternative to OpenAI Operator.

How does CapSolver integrate with Nanobrowser?

The integration works by running both extensions simultaneously in Chrome. The CapSolver extension automatically detects and solves CAPTCHAs on any page that Nanobrowser's agents visit, requiring no special configuration.

What CAPTCHA types can CapSolver solve?

CapSolver supports reCAPTCHA v2 (image and invisible), reCAPTCHA v3, Cloudflare Turnstile, GeeTest, AWS WAF, and many more CAPTCHA types.

Do I need to modify my task prompts for CAPTCHA handling?

For basic workflows, no—the CapSolver extension works automatically. For complex workflows with multiple CAPTCHAs or specific timing requirements, adding explicit CAPTCHA handling instructions in your prompts improves reliability.

Can Nanobrowser work in headless mode?

No, Nanobrowser is a Chrome extension that requires a visible browser window. It's designed for interactive automation where you can observe the agents working.

How much does the integration cost?

Nanobrowser is free and open-source. CapSolver charges based on CAPTCHA type and volume. Visit capsolver.com for current pricing. Use code NANOBROWSER for a 6% bonus.

What LLM providers work with Nanobrowser?

Nanobrowser supports OpenAI, Anthropic (Claude), Google Gemini, Ollama (local models), Groq, Cerebras, and any OpenAI-compatible API endpoint.

How do I know if a CAPTCHA was solved?

The CapSolver extension shows a notification when a CAPTCHA is solved. In Nanobrowser, the agent will report page state changes—you'll see the workflow continue after the CAPTCHA disappears.

What if CapSolver fails to solve a CAPTCHA?

Include fallback instructions in your prompts: retry the page, skip the item, or report the failure for manual review. The CapSolver extension also supports automatic retries via configuration.