PHPackages                             capskip/capskip - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [HTTP &amp; Networking](/categories/http)
4. /
5. capskip/capskip

ActiveLibrary[HTTP &amp; Networking](/categories/http)

capskip/capskip
===============

PHP SDK for the CapSkip local captcha solver

v1.1.0(1mo ago)06MITPHPPHP &gt;=8.0CI passing

Since Jul 15Pushed 1w agoCompare

[ Source](https://github.com/capskip/capskip-php)[ Packagist](https://packagist.org/packages/capskip/capskip)[ Docs](https://capskip.com)[ RSS](/packages/capskip-capskip/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (3)Dependencies (2)Versions (4)Used By (0)

CapSkip PHP SDK — Captcha Solver for PHP
========================================

[](#capskip-php-sdk--captcha-solver-for-php)

[![Packagist](https://camo.githubusercontent.com/a7a8b879080490a2c9d4fa9a4a3ae66044768e57afdb93154c55d62734ef4082/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f636170736b69702f636170736b69702e737667)](https://packagist.org/packages/capskip/capskip)[![PHP 8.0+](https://camo.githubusercontent.com/ef6afd4ccdaa708a9b1a0a353d6d03a13ca1f03887b8db701d4118dc30a6735a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d382e302532422d3737376262342e737667)](https://www.php.net/)[![License: MIT](https://camo.githubusercontent.com/784362b26e4b3546254f1893e778ba64616e362bd6ac791991d2c9e880a3a64e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d677265656e2e737667)](LICENSE)[![Tests](https://github.com/capskip/capskip-php/actions/workflows/ci.yml/badge.svg)](https://github.com/capskip/capskip-php/actions/workflows/ci.yml)

**Solve reCAPTCHA v2, reCAPTCHA v3, Cloudflare Turnstile, GeeTest and image captchas from PHP.**

Official PHP client for [CapSkip](https://capskip.com), a **local captcha solver** that runs on your own machine. Licensed once, not billed per solve.

```
composer require capskip/capskip
```

---

How it works
------------

[](#how-it-works)

CapSkip is a desktop app. It does the solving on your machine and exposes the standard captcha-solver HTTP API — the same `in.php` / `res.php` endpoints every 2captcha-compatible client already speaks — on `127.0.0.1:8080`.

This SDK is a thin wrapper over that API, with the method names you would expect: `normal()`, `recaptcha()`, `turnstile()`, `geetest()`. Nothing leaves your network, and there is no credit balance to keep an eye on.

Supported captcha types
-----------------------

[](#supported-captcha-types)

CaptchaMethod**Image captcha solver** (distorted text / OCR)`$solver->normal($file)`**reCAPTCHA v2 solver** (checkbox)`$solver->recaptcha($sitekey, $url)`**reCAPTCHA v2 invisible solver**`$solver->recaptcha($sitekey, $url, ['invisible' => 1])`**reCAPTCHA Enterprise solver**`$solver->recaptcha($sitekey, $url, ['enterprise' => 1])`**reCAPTCHA v3 solver**`$solver->recaptcha($sitekey, $url, ['version' => 'v3', 'action' => 'submit'])`reCAPTCHA v3 Enterprise`$solver->recaptcha($sitekey, $url, ['version' => 'v3', 'enterprise' => 1])`**Cloudflare Turnstile solver** (widget)`$solver->turnstile($sitekey, $url)`Cloudflare Turnstile (challenge page)`$solver->turnstile($sitekey, $url, ['data' => ..., 'pagedata' => ...])`**GeeTest v3 solver** (slide puzzle)`$solver->geetest($gt, $challenge, $url)`**hCaptcha and FunCaptcha/Arkose are not supported.** hCaptcha is the one people misidentify most often, since it also puts a `data-sitekey` on the widget — check for `class="h-captcha"` or a `js.hcaptcha.com` script before reaching for `recaptcha()`.

Point the SDK at the [live captcha demo pages](https://capskip.com/captcha-demo/) to sanity-check your setup against real widgets.

---

Quick start (5 minutes)
-----------------------

[](#quick-start-5-minutes)

### 1. Install the CapSkip captcha solver

[](#1-install-the-capskip-captcha-solver)

Download and run the CapSkip desktop app — [CapSkipInstaller.msi](https://capskip.com/download/CapSkipInstaller.msi). Leave it running in the background.

In CapSkip settings, note:

- **API port** (default: `8080`)
- **API key** (optional — if validation is disabled, any string works)

### 2. Install the SDK

[](#2-install-the-sdk)

```
composer require capskip/capskip
```

Or from source:

```
git clone https://github.com/capskip/capskip-php.git
cd capskip-php
composer install
```

### 3. Solve your first captcha

[](#3-solve-your-first-captcha)

```
