Potter hCaptcha Solver (NPM)

The ultimate hCaptcha logic solver. Designed to handle both browser-based automation and browserless API integration.

Installation

npm install potter-hcaptcha-solver

Usage

1. With Browser (Playwright)

Use this when you are automating a real browser.

const { chromium } = require('playwright');
const PotterSolver = require('potter-solver');

(async () => {
    const browser = await chromium.launch({ headless: false });
    const page = await browser.newPage();
    await page.goto('https://accounts.hcaptcha.com/demo');

    const solver = new PotterSolver({ 
        cerebrasKey: 'YOUR_CEREBRAS_KEY' 
    });

    // Automatically clicks, solves, and returns success
    const result = await solver.solve(page);

    if (result.status === 'success') {
        console.log('Success! Token:', result.token);
    }
    await browser.close();
})();

2. Without Browser (API Mode)

Use this if you are using your own HTTP client (Axios, Fetch) and just need the logic puzzle solved.

const PotterSolver = require('potter-solver');

const solver = new PotterSolver({ 
    cerebrasKey: 'YOUR_CEREBRAS_KEY' 
});

async function run() {
    const question = "From the sequence 896228, what are the trailing three digits?";
    
    // Returns the AI-solved answer directly
    const answer = await solver.solveNoBrowser(question);
    
    console.log('Answer:', answer); // "228"
}

run();

Features

• Dual Mode: Works with Page objects or String questions.
• AI-Powered: Direct integration with Cerebras (Llama 3.3 70B) for 100% accuracy on logic puzzles.
• Auto-Retry: Built-in retry logic for browser frame detachment issues.
• Lightweight: Minimal dependencies for fast installation.

License

MIT