Release v6.6.0

.github/workflows/build.yml

@@ -23,7 +23,7 @@ jobs:
         python-version: ["3.9", "3.10", "3.11", "3.12"]
 
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@v6
     - name: Set up Python ${{ matrix.python-version }}
       uses: actions/setup-python@v6
       with:

.github/workflows/install.yml

@@ -23,7 +23,7 @@ jobs:
         python-version: ["3.9", "3.10", "3.11", "3.12"]
 
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@v6
     - name: Set up Python ${{ matrix.python-version }}
       uses: actions/setup-python@v6
       with:

.github/workflows/lint.yml

@@ -27,7 +27,7 @@ jobs:
         python-version: ["3.12"]
 
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@v6
     - name: Set up Python ${{ matrix.python-version }}
       uses: actions/setup-python@v6
       with:

.github/workflows/sphinx.yml

@@ -14,7 +14,7 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
       - uses: actions/setup-python@v6
 
       - name: Build docs requirements

.github/workflows/test.yml

@@ -33,7 +33,7 @@ jobs:
         python-version: ["3.11"]
 
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
       - name: Set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@v6
         with:
@@ -48,7 +48,7 @@ jobs:
         run: make tests
 
       - name: Upload coverage to Codecov
-        uses: codecov/codecov-action@v5
+        uses: codecov/codecov-action@v6
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
           files: ${{github.workspace}}/coverage/coverage.xml

.github/workflows/zai-code-bot.yml

@@ -0,0 +1,45 @@
+name: Z.ai Code Bot
+
+concurrency:
+  group: zai-bot-${{ github.event.pull_request.number || github.event.issue.number }}
+  cancel-in-progress: false
+
+on:
+    pull_request:
+        types:
+            - opened
+            - synchronize
+            - reopened
+            - ready_for_review
+        branches:
+            - main
+            - prod
+    issue_comment:
+        types:
+            - created
+    pull_request_review_comment:
+        types:
+            - created
+
+permissions:
+    contents: read
+    pull-requests: write
+    issues: write
+
+jobs:
+    zai-bot:
+        if: |
+          (github.event_name == 'pull_request' && github.event.pull_request.draft == false) ||
+          (github.event_name == 'issue_comment' && github.event.issue.pull_request) ||
+          (github.event_name == 'pull_request_review_comment' && github.event.pull_request.draft == false)
+        runs-on: ubuntu-latest
+        steps:
+            - name: Checkout repository
+              uses: actions/checkout@v6
+
+            - name: Run Z.ai Bot
+              uses: AndreiDrang/zai-code-bot@main
+              with:
+                  ZAI_API_KEY: ${{ secrets.ZAI_API_KEY }}
+                  ZAI_MODEL: ${{ vars.ZAI_MODEL || 'glm-5.1' }}
+                  GITHUB_TOKEN: ${{ github.token }}

.gitignore

@@ -23,3 +23,4 @@ env/
 /src/coverage/lcov.info
 /docs/_build/
 /coverage/
+.osgrep

AGENTS.md

@@ -0,0 +1,68 @@
+# PROJECT KNOWLEDGE BASE
+
+**Generated:** 2026-02-20
+**Commit:** 86ee3e6
+**Branch:** master
+
+## OVERVIEW
+Python 3.9+ library for RuCaptcha/2Captcha/DeathByCaptcha service APIs. Supports 30+ CAPTCHA types with dual sync/async interfaces.
+
+## STRUCTURE
+```
+./
+├── src/python_rucaptcha/    # Main package (30+ captcha modules)
+│   └── core/                # Base classes, serializers, enums
+├── tests/                   # Pytest test suite (23+ files)
+├── docs/                    # Sphinx documentation
+├── pyproject.toml           # Build config (black 110, isort, pytest)
+└── Makefile                 # Build automation
+```
+
+## WHERE TO LOOK
+| Task | Location | Notes |
+|------|----------|-------|
+| Add new CAPTCHA | `src/python_rucaptcha/` | Create module inheriting `BaseCaptcha` |
+| Modify API flow | `src/python_rucaptcha/core/base.py` | `_processing_response()` methods |
+| Change serialization | `src/python_rucaptcha/core/serializer.py` | `MyBaseModel` class |
+| Add CAPTCHA enum | `src/python_rucaptcha/core/enums.py` | 25+ enum classes |
+| Run tests | `tests/` | Requires `RUCAPTCHA_KEY` env var |
+
+## CODE MAP
+| Symbol | Type | Location | Role |
+|--------|------|----------|------|
+| BaseCaptcha | Class | core/base.py | Parent for all captcha solvers |
+| MyBaseModel | Class | core/serializer.py | msgspec Struct wrapper |
+| CaptchaOptionsSer | Class | core/config.py | Service URL abstraction |
+| MyEnum | Class | core/enums.py | Custom enum with utils |
+
+## CONVENTIONS
+- **Line length**: 110 chars (pyproject.toml)
+- **Async mode**: `asyncio_mode = auto` in pytest
+- **No tox**: Uses Makefile directly for test/lint
+- **Import order**: isort with black profile
+
+## ANTI-PATTERNS (THIS PROJECT)
+- No TODO/FIXME/DEPRECATED comments in code
+- No explicit "DO NOT" directives
+- Logging warnings output full result objects (potential sensitive data)
+
+## UNIQUE STYLES
+- **25+ custom enums**: Each CAPTCHA type has dedicated enum (e.g., `HCaptchaEnm`)
+- **Service abstraction**: Unified API for 2Captcha/RuCaptcha/DeathByCaptcha
+- **msgspec**: Fast serialization (replaced pydantic v6.0)
+- **Dual sync/async**: Every captcha class has both handlers
+
+## COMMANDS
+```bash
+make install    # pip install -e .
+make tests      # Run pytest with coverage
+make lint       # autoflake + black + isort check
+make build      # Build package
+make doc        # Build Sphinx docs
+```
+
+## NOTES
+- Tests require live API keys (`RUCAPTCHA_KEY`, `DEATHBYCAPTCHA_KEY`)
+- CI runs on Python 3.11 (tests) / 3.12 (lint) — version mismatch
+- No cross-platform testing (only ubuntu-latest)
+- x.py in root is debug script (non-standard)

README.md

@@ -1,70 +1,160 @@
 # python-rucaptcha
 
-[![RuCaptchaHigh.png](https://s.vyjava.xyz/files/2024/12-December/17/45247a56/RuCaptchaHigh.png)](https://vyjava.xyz/dashboard/image/45247a56-3332-48ee-8df8-fc95bcfc52f0)
-
-<hr>
-
 [![PyPI version](https://badge.fury.io/py/python-rucaptcha.svg)](https://badge.fury.io/py/python-rucaptcha)
 [![Python versions](https://img.shields.io/pypi/pyversions/python-rucaptcha.svg?logo=python&logoColor=FBE072)](https://badge.fury.io/py/python-rucaptcha)
 [![Downloads](https://static.pepy.tech/badge/python-rucaptcha/month)](https://pepy.tech/project/python-rucaptcha)
-[![Static Badge](https://img.shields.io/badge/docs-Sphinx-green?label=Documentation&labelColor=gray)](https://andreidrang.github.io/python-rucaptcha/)
+[![Documentation](https://img.shields.io/badge/docs-Sphinx-green)](https://andreidrang.github.io/python-rucaptcha/)
 
-[![Maintainability](https://api.codeclimate.com/v1/badges/aec93bb04a277cf0dde9/maintainability)](https://codeclimate.com/github/AndreiDrang/python-rucaptcha/maintainability)
-[![Codacy Badge](https://app.codacy.com/project/badge/Grade/b4087362bd024b088b358b3e10e7a62f)](https://www.codacy.com/gh/AndreiDrang/python-rucaptcha/dashboard?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=AndreiDrang/python-rucaptcha&amp;utm_campaign=Badge_Grade)
-[![codecov](https://codecov.io/gh/AndreiDrang/python-rucaptcha/branch/master/graph/badge.svg?token=doybTUCfbD)](https://codecov.io/gh/AndreiDrang/python-rucaptcha)
+**Python 3.9+ library to solve CAPTCHAs automatically using RuCaptcha, 2Captcha, or DeathByCaptcha services.**
 
-[![Sphinx docs](https://github.com/AndreiDrang/python-rucaptcha/actions/workflows/sphinx.yml/badge.svg?branch=release)](https://github.com/AndreiDrang/python-rucaptcha/actions/workflows/sphinx.yml)
-[![Build](https://github.com/AndreiDrang/python-rucaptcha/actions/workflows/build.yml/badge.svg?branch=master)](https://github.com/AndreiDrang/python-rucaptcha/actions/workflows/build.yml)
-[![Installation](https://github.com/AndreiDrang/python-rucaptcha/actions/workflows/install.yml/badge.svg?branch=master)](https://github.com/AndreiDrang/python-rucaptcha/actions/workflows/install.yml)
-[![Tests](https://github.com/AndreiDrang/python-rucaptcha/actions/workflows/test.yml/badge.svg?branch=master)](https://github.com/AndreiDrang/python-rucaptcha/actions/workflows/test.yml)
-[![Lint](https://github.com/AndreiDrang/python-rucaptcha/actions/workflows/lint.yml/badge.svg?branch=master)](https://github.com/AndreiDrang/python-rucaptcha/actions/workflows/lint.yml)
+## What is this?
 
-Python3 library for [RuCaptcha](https://rucaptcha.com/?from=4170435) and [2Captcha](https://2captcha.com/?from=4170435) service API.
+This library automates CAPTCHA solving by connecting to third-party services. When your code encounters a CAPTCHA, python-rucaptcha sends it to the service, waits for a human to solve it, and returns the solution to your application.
 
-Tested on UNIX based OS.
+**Supports 30+ CAPTCHA types:**
+- reCAPTCHA v2/v3, hCaptcha, Cloudflare Turnstile
+- Image captchas, Audio captchas
+- GeeTest, KeyCaptcha, Amazon WAF, Tencent
+- And many more...
 
-The library is intended for software developers and is used to work with the [RuCaptcha](https://rucaptcha.com/?from=4170435) and [2Captcha](https://2captcha.com/?from=4170435) service API.
+## Quick Start
 
-Support of the service [Death By Captcha](https://deathbycaptcha.com?refid=1237267242) is integrated into this library, more information in the library documentation or in the [service docs](https://deathbycaptcha.com/api/2captcha?refid=1237267242).
+### 1. Install
+
+```bash
+pip install python-rucaptcha
+```
 
-Application in [RuCaptcha software](https://rucaptcha.com/software/python-rucaptcha) and [2Captcha software](https://2captcha.com/software/python-rucaptcha).
+### 2. Get an API Key
 
-## How to install?
+Sign up at [RuCaptcha](https://rucaptcha.com) or [2Captcha](https://2captcha.com), then copy your API key from the dashboard.
 
-### pip
+### 3. Solve a CAPTCHA
 
-```bash
-pip install python-rucaptcha
+```python
+from python_rucaptcha import HCaptcha
+
+# Your API key
+key = "your_api_key_here"
+
+# Solve hCaptcha
+result = HCaptcha(aptcha_key=key).captcha_handler(site_url="https://example.com", site_key="abc123")
+
+if result['code'] == 0:
+    print(f"Solved! Token: {result['token']}")
+else:
+    print(f"Error: {result['message']}")
+```
+
+### Solving Different CAPTCHA Types
+
+**reCAPTCHA v2:**
+```python
+from python_rucaptcha import ReCaptcha
+
+result = ReCaptcha(api_key).captcha_handler(
+    site_url="https://example.com",
+    site_key="your_site_key"
+)
+```
+
+**Image CAPTCHA:**
+```python
+from python_rucaptcha import ImageCaptcha
+
+result = ImageCaptcha(api_key).captcha_handler(
+    image_link="https://example.com/captcha.jpg"
+)
+```
+
+**ALTCHA:**
+```python
+from python_rucaptcha import AltchaCaptcha
+from python_rucaptcha.core.enums import AltchaEnm
+
+result = AltchaCaptcha(
+    rucaptcha_key=api_key,
+    websiteURL="https://example.com",
+    challengeURL="https://example.com/altcha/challenge",
+    method=AltchaEnm.AltchaTaskProxyless,
+).captcha_handler()
+```
+
+**Using async:**
+```python
+import asyncio
+from python_rucaptcha import HCaptcha
+
+async def solve():
+    result = await HCaptcha(api_key).aio_captcha_handler(
+        site_url="https://example.com",
+        site_key="abc123"
+    )
+    return result
+
+token = asyncio.run(solve())
 ```
 
+## Supported CAPTCHA Types
 
-## How to use?
+| CAPTCHA | Module | Description |
+|---------|--------|-------------|
+| reCAPTCHA v2/v3 | `ReCaptcha` | Google reCAPTCHA |
+| hCaptcha | `HCaptcha` | hCaptcha challenge |
+| Cloudflare Turnstile | `Turnstile` | Cloudflare protection |
+| Image | `ImageCaptcha` | Type the text from image |
+| Audio | `AudioCaptcha` | Listen and type audio |
+| GeeTest | `GeeTest` | Chinese geetest puzzles |
+| KeyCaptcha | `KeyCaptcha` | KeyCAPTCHA service |
+| Amazon WAF | `AmazonWaf` | AWS WAF challenge |
+| ALTCHA | `AltchaCaptcha` | ALTCHA challenge |
+| Binance | `BinanceCaptcha` | Token-based Binance challenge |
+| Grid | `GridCaptcha` | Select grid cells |
+| Coordinates | `CoordinatesCaptcha` | Click on coordinates |
+| And 20+ more | ... | See [full docs](https://andreidrang.github.io/python-rucaptcha/) |
 
-Is described in the [documentation-website](https://andreidrang.github.io/python-rucaptcha/).
+## Switching Services
 
-## How to test?
+Use the same code with different services:
 
-1. You need set ``RUCAPTCHA_KEY`` in your environment(get this value from you account).
-2. Run command ``make tests``, from root directory.
+```python
+from python_rucaptcha import HCaptcha
+from python_rucaptcha.core.enums import ServiceEnm
 
+# Use 2Captcha (default)
+result = HCaptcha("2captcha_key").captcha_handler(...)
+
+# Use RuCaptcha
+result = HCaptcha("rucaptcha_key", service_type=ServiceEnm.RuCaptcha).captcha_handler(...)
+
+# Use DeathByCaptcha
+result = HCaptcha("dbc_user:dbc_pass", service_type=ServiceEnm.DeathByCaptcha).captcha_handler(...)
+```
+
+## Testing
+
+```bash
+# Set your API key
+export RUCAPTCHA_KEY="your_key_here"
+
+# Run tests
+make tests
+```
 
-### Changelog
+## Documentation
 
-For full changelog info check - [Releases page](https://github.com/AndreiDrang/python-rucaptcha/releases).
+For advanced usage, configuration options, and all CAPTCHA types, see the [full documentation](https://andreidrang.github.io/python-rucaptcha/).
 
-- v.6.0 - Library refactoring. Stop using `pydantic`, start using `msgspec`. Move to API v2. Drop Python 3.8 support. More details at [Releases page](https://github.com/AndreiDrang/python-rucaptcha/releases). 
-- v.5.3 - Added support for [Death By Captcha](https://www.deathbycaptcha.com?refid=1237267242) and other services by changing `service_type` and `url_request` \ `url_response` parameters.
-- v.5.2 - Added Audio captcha method.
-- v.5.1 - Check [releases page](https://github.com/AndreiDrang/python-rucaptcha/releases).
-- v.5.0 - Added AmazonWAF captcha method.
-- v.4.2 - Added [Yandex Smart Captcha](https://rucaptcha.com/api-rucaptcha#yandex).
+## Support
 
-### Get API Key to work with the library
-1. On the page - https://rucaptcha.com/enterpage
-2. Find it: [![img.png](https://s.vyjava.xyz/files/2024/12-December/17/ac679557/img.png)](https://vyjava.xyz/dashboard/image/ac679557-f3cc-402f-bf95-6c45d252a2ef)
+- **Telegram:** [pythoncaptcha](https://t.me/pythoncaptcha)
+- **Email:** python-captcha@pm.me
+- **Issues:** [GitHub Issues](https://github.com/AndreiDrang/python-rucaptcha/issues)
 
-### Contacts
+## Changelog
 
-If you have any questions, please send a message to the [Telegram](https://t.me/pythoncaptcha) chat room.
+See [Releases](https://github.com/AndreiDrang/python-rucaptcha/releases) for full changelog.
 
-Or email python-captcha@pm.me
+- **v6.0** - Refactored to use msgspec (faster), API v2, dropped Python 3.8
+- **v5.3** - Added DeathByCaptcha support
+- **v5.2** - Added audio CAPTCHA solving

docs/conf.py

@@ -25,7 +25,9 @@
     text_captcha,
     image_captcha,
     lemin_captcha,
+    yidun_captcha,
     rotate_captcha,
+    binance_captcha,
     datadome_captcha,
     friendly_captcha,
     cyber_siara_captcha,

docs/index.rst

@@ -52,9 +52,12 @@ Check our other projects here - `RedPandaDev group <https://red-panda-dev.xyz/bl
    modules/tencent/example.rst
    modules/prosopo/example.rst
    modules/atb-captcha/example.rst
+   modules/captcha-binance/example.rst
    modules/captcha-fox/example.rst
    modules/captcha-temu/example.rst
    modules/captcha-vk/example.rst
+   modules/yidun-necaptcha/example.rst
+   modules/yandex-smart-captcha/example.rst
    modules/control/example.rst
 
 .. toctree::