PHPackages                             cap\_monster/client - 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. [Authentication & Authorization](/categories/authentication)
4. /
5. cap\_monster/client

ActiveLibrary[Authentication & Authorization](/categories/authentication)

cap\_monster/client
===================

PHP client for the CapMonster Cloud captcha-solving API (reCAPTCHA v2/v3, hCaptcha, FunCaptcha, GeeTest, Turnstile, image-to-text and more)

v1.0.1(1mo ago)05MITPHPPHP ^8.2

Since Jul 4Pushed 1mo agoCompare

[ Source](https://github.com/akomyagin/CapMonster)[ Packagist](https://packagist.org/packages/cap_monster/client)[ Docs](https://github.com/akomyagin/CapMonster)[ RSS](/packages/cap-monster-client/feed)WikiDiscussions master Synced 1w ago

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

CapMonster Cloud PHP Client
===========================

[](#capmonster-cloud-php-client)

A PHP 8.2+ client for the [CapMonster Cloud](https://capmonster.cloud/) captcha-solving API. Bring your own [PSR-18](https://www.php-fig.org/psr/psr-18/) HTTP client, build a task DTO, get a solution back.

Requirements
------------

[](#requirements)

- PHP 8.2+
- A [PSR-18](https://www.php-fig.org/psr/psr-18/) HTTP client implementation (e.g. `symfony/http-client`, `guzzlehttp/guzzle` with `php-http/guzzle7-adapter`, etc.)

Installation
------------

[](#installation)

```
composer require cap_monster/client
```

Usage
-----

[](#usage)

```
use CapMonsterClient\CapMonsterClient;
use CapMonsterClient\CapMonsterConfiguration;
use CapMonsterClient\Dto\Task\NoCaptchaTask;

$configuration = new CapMonsterConfiguration('YOUR_CAPMONSTER_CLIENT_KEY');
$client = new CapMonsterClient($yourPsr18HttpClient, $configuration);

$task = new NoCaptchaTask(
    websiteUrl: 'https://example.com/page-with-captcha',
    websiteKey: 'site-key-from-the-page'
);

$solution = $client->runTask($task); // blocks, polling getTaskResult until ready or timeout
echo $solution->getGRecaptchaResponse();

$balance = $client->getBalance();
```

`runTask()` handles `createTask` + polling `getTaskResult` for you, and throws `CapMonsterClient\Common\Exception\CapMonsterException` (wrapping a `CapMonsterClient\Enum\ErrorType`) on any API or timeout error.

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

[](#supported-captcha-types)

`ImageToTextTask`, `NoCaptchaTask`/`NoCaptchaTaskProxyless` (reCAPTCHA v2), `RecaptchaV2EnterpriseTask`, `RecaptchaV3TaskProxyless`, `RecaptchaV3EnterpriseTask`, `FunCaptchaTask`/`FunCaptchaTaskProxyless`, `HCaptchaTask`/`HCaptchaTaskProxyless`, `GeeTestTask` (v3 & v4), `TurnstileTask`, `TurnstileChallengeTask`, `TurnstileWaitingRoomTask`, `ComplexImageTask`, `DataDomeTask`, `ImpervaTask`, `BasiliskTask`, `TenDITask`, `AmazonTask`, `BinanceTask`, `ProsopoTask`, `YidunTask`, `MTCaptchaTask`, `AltchaTask`, `CastleTask`, `TSPDTask`, `HuntTask`, `AlibabaTask`.

Each task's exact request/response shape is documented in the source repository's `docs/API_CONTRACT.md` (not shipped in the installed package — see the [GitHub repo](https://github.com/akomyagin/CapMonster)).

> **Note:** per CapMonster Cloud support (July 2026) and confirmed against the live API, hCaptcha is currently **not** being solved by the service — `createTask` with an `HCaptchaTask`/`HCaptchaTaskProxyless` payload is immediately rejected with `ERROR_TASK_NOT_SUPPORTED` (no balance charged), despite the task being fully implemented here per the documented wire format. Check with CapMonster support for current availability before relying on it.

Configuration
-------------

[](#configuration)

`CapMonsterConfiguration` accepts an optional array of overrides (base URL, per-task polling timeouts, HTTP headers, callback URL, max poll attempts) — see `CapMonsterConfiguration::__construct()` for the full option set.

Verified against the live API
-----------------------------

[](#verified-against-the-live-api)

`ImageToTextTask`, `NoCaptchaTask` (reCAPTCHA v2), and `TurnstileTask` have each been run end-to-end against the real `api.capmonster.cloud` (real account, real balance deduction) and correctly solved. `HCaptchaTask` was confirmed rejected by the live API as described above.

License
-------

[](#license)

MIT

###  Health Score

39

—

LowBetter than 84% of packages

Maintenance90

Actively maintained with recent releases

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

2

Last Release

48d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/efbc1f96c811134d40a07c321f5936f618572686af7c3278f8fee66f2f100ff9?d=identicon)[alkom68](/maintainers/alkom68)

---

Top Contributors

[![akomyagin](https://avatars.githubusercontent.com/u/5756595?v=4)](https://github.com/akomyagin "akomyagin (11 commits)")

---

Tags

recaptchacaptchaturnstilefuncaptchageetestcaptcha solverhcaptchaCapmonster

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/cap-monster-client/health.svg)

```
[![Health](https://phpackages.com/badges/cap-monster-client/health.svg)](https://phpackages.com/packages/cap-monster-client)
```

###  Alternatives

[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.4M236](/packages/sulu-sulu)[solvercaptcha/solvecaptcha-php

PHP package for easy integration with solvecaptcha API.

143.6k](/packages/solvercaptcha-solvecaptcha-php)[2captcha/2captcha

PHP package for easy integration with 2captcha API

86514.3k4](/packages/2captcha-2captcha)[telnyx/telnyx-php

Official Telnyx PHP SDK — APIs for Voice, SMS, MMS, WhatsApp, Fax, SIP Trunking, Wireless IoT, Call Control, and more. Build global communications on Telnyx's private carrier-grade network.

36826.2k2](/packages/telnyx-telnyx-php)[surfoo/geocaching-php-sdk

Geocaching PHP SDK

143.7k1](/packages/surfoo-geocaching-php-sdk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)