Library for automating captcha verification.
Last updated 2 years ago by fisch0920 .
MIT · Repository · Original npm · Tarball · package.json
$ cnpm install captcha-solver 
SYNC missed versions from official npm registry.


Library for automating captcha verification.

NPM Build Status JavaScript Style Guide

Nocaptcha Recaptcha

This module also has a CLI.


This module requires node >= 8.

npm install --save captcha-solver


const CaptchaSolver = require('captcha-solver')

const solver = new CaptchaSolver('browser')
const codes = await solver.solve()


Table of Contents


Main entrypoint for solving captchas.

Type: function (provider, opts)

  • provider (string | CaptchaSolverProvider) Name of built-in provider or an instance of a custom provider to use for solving.
  • opts (optional, default {})


Provider powering this solver.

Type: CaptchaSolverProvider


Creates a new captcha solving task.

Valid values for opts.type are:

  • image-to-text
  • recaptcha
  • recaptcha-proxyless
  • nocaptcha
  • nocaptcha-proxyless
  • funcaptcha
  • funcaptcha-proxyless

Note that not all providers support all captcha types. See provider.supportedTaskTypes for a Set containing all task types a given provider supports.

Note that most of these options will be unused depending on the task type.

Type: function (opts)

  • opts object Options
    • opts.type string Type of captcha to solve
    • opts.image (buffer | string)? Path, URL, or buffer of an image to process
    • opts.websiteURL string? Website URL for nocaptcha, recaptcha, and funcaptcha
    • opts.websiteKey string? Recaptcha website key
    • opts.websiteSToken string? Secret token for old versions of Recaptcha
    • opts.websitePublicKey string? Funcaptcha public key
    • opts.proxyType string? Proxy type (http/socks4/socks5)
    • opts.proxyAddress string? Proxy IP address (ipv4/ipv6)
    • opts.proxyPort (string | number)? Proxy port
    • opts.proxyLogin string? Proxy login for basic auth
    • opts.proxyPassword string? Proxy password
    • opts.userAgent string? Browser's User-Agent to emulate
    • opts.cookies string? Additional cookies to emulate


Fetches the result of a previously created captcha solving task.

Type: function (taskId, opts)

  • taskId string Unique task identifier
  • opts object? Options (optional, default {})
    • opts.retries number Number of retries to perform (optional, default 3)
    • opts.timeout number Max timeout to wait in ms before aborting (optional, default 30000)



Using this software to violate the terms and conditions of any third-party service is strictly against the intent of this software. By using this software, you are acknowledging this fact and absolving the author or any potential liability or wrongdoing it may cause. This software is meant for testing and experimental purposes only, so please act responsibly.


MIT © Travis Fischer

Current Tags

  • 0.0.6                                ...           latest (2 years ago)

6 Versions

  • 0.0.6                                ...           2 years ago
  • 0.0.5                                ...           2 years ago
  • 0.0.4                                ...           2 years ago
  • 0.0.3                                ...           2 years ago
  • 0.0.2                                ...           2 years ago
  • 0.0.1                                ...           2 years ago
Maintainers (1)
Today 0
This Week 0
This Month 1
Last Day 0
Last Week 1
Last Month 1
Dependencies (7)
Dev Dependencies (3)

Copyright 2014 - 2016 © |