Optimize README and package metadata for search

Reworks the README around the terms people actually search for: a
supported-captcha table keyed by how each type gets searched, a section
on why solving locally beats a per-solve cloud API, a 2captcha
alternative section, worked Selenium and Playwright snippets, and an FAQ
aimed at question searches. Adds a PyPI badge and internal links to the
other CapSkip clients.

Expands PyPI keywords from 8 to 30 and rewrites the package description,
since PyPI search weights both heavily. Adds the 3.13, OS Independent,
Browsers and Utilities classifiers.

No behaviour change: 90 tests still passing.

Author: capskip

README.md

@@ -1,20 +1,51 @@
-# CapSkip Python SDK
+# CapSkip Python SDK — Captcha Solver for Python
 
+[![PyPI](https://img.shields.io/pypi/v/capskip.svg)](https://pypi.org/project/capskip/)
 [![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
 [![Tests](https://github.com/capskip/capskip-python/actions/workflows/ci.yml/badge.svg)](https://github.com/capskip/capskip-python/actions/workflows/ci.yml)
 
-Official Python client for the [CapSkip](https://capskip.com) **local** captcha solver.
+**Solve reCAPTCHA v2, reCAPTCHA v3, Cloudflare Turnstile, GeeTest and image captchas from Python.**
 
-CapSkip runs on your machine and exposes a standard captcha-solver HTTP API (the familiar `in.php` / `res.php` endpoints). This SDK wraps that API with clean, familiar method names, so you can solve captchas locally — no per-solve API fees beyond your CapSkip license.
+Official Python client for [CapSkip](https://capskip.com), a **local captcha solver** that runs on your own machine. Licensed once, not billed per solve.
+
+```bash
+pip install capskip
+```
+
+---
+
+## 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
+
+| Captcha | Method |
+|---|---|
+| **Image captcha solver** (distorted text / OCR) | `solver.normal(file)` |
+| **reCAPTCHA v2 solver** (checkbox) | `solver.recaptcha(sitekey, url)` |
+| **reCAPTCHA v2 invisible solver** | `solver.recaptcha(..., invisible=1)` |
+| **reCAPTCHA Enterprise solver** | `solver.recaptcha(..., enterprise=1)` |
+| **reCAPTCHA v3 solver** | `solver.recaptcha(..., version="v3", action="submit")` |
+| reCAPTCHA v3 Enterprise | `solver.recaptcha(..., version="v3", enterprise=1)` |
+| **Cloudflare Turnstile solver** (widget) | `solver.turnstile(sitekey, url)` |
+| Cloudflare Turnstile (challenge page) | `solver.turnstile(..., 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)
 
-### 1. Install CapSkip
+### 1. Install the CapSkip captcha solver
 
-Download and run the CapSkip desktop app from [capskip.com](https://capskip.com). Leave it running in the background.
+Download and run the CapSkip desktop app from [capskip.com](https://capskip.com/download/). Leave it running in the background.
 
 In CapSkip settings, note:
 
@@ -54,19 +85,20 @@ print(result["code"])  # g-recaptcha-response token
 
 ---
 
-## Supported captcha types
+## Why solve captchas locally
 
-| Type | SDK method |
-|---|---|
-| Image CAPTCHA (distorted text) | `solver.normal(file)` |
-| reCAPTCHA v2 (checkbox) | `solver.recaptcha(sitekey, url)` |
-| reCAPTCHA v2 Invisible | `solver.recaptcha(..., invisible=1)` |
-| reCAPTCHA v2 Enterprise | `solver.recaptcha(..., enterprise=1)` |
-| reCAPTCHA v3 | `solver.recaptcha(..., version="v3")` |
-| reCAPTCHA v3 Enterprise | `solver.recaptcha(..., version="v3", enterprise=1)` |
-| Cloudflare Turnstile (widget) | `solver.turnstile(sitekey, url)` |
-| Cloudflare Turnstile (challenge page) | `solver.turnstile(..., data=..., pagedata=...)` |
-| GeeTest v3 (slide) | `solver.geetest(gt, challenge, url)` |
+Cloud captcha APIs charge per solve, which turns a retry loop into an expense and routes every page URL and sitekey you touch through someone else's queue.
+
+CapSkip flips that around:
+
+- **Unlimited solving** — one license, no per-captcha charge, no balance to top up
+- **Runs on `127.0.0.1`** — the SDK never talks to a third-party server
+- **No per-key rate limit** — throughput is whatever your machine can manage
+- **Fast** — image captchas come back in well under a second; a typical reCAPTCHA v2 lands in 30–45 seconds
+
+### Coming from 2captcha or Anti-Captcha
+
+CapSkip answers on the same `in.php` / `res.php` endpoints, so it works as a **2captcha API alternative**: an existing integration usually needs nothing more than its host pointed at `127.0.0.1:8080`. The [migration notes](https://capskip.com/2captcha-api-alternative/) cover the details, if you would rather keep your current client library than switch to this one.
 
 ---
 
@@ -217,6 +249,44 @@ More examples: [`examples/`](examples/)
 
 ---
 
+## Selenium, Playwright and Scrapy
+
+The SDK hands back a token; your existing browser tooling does the driving. The shape is the same whichever you use:
+
+1. Read the sitekey off the page (`data-sitekey`, or the widget's config object).
+2. Call the matching solve method with that sitekey and the page URL.
+3. Write the token into the response field and submit.
+
+### Selenium
+
+```python
+sitekey = driver.find_element(By.CSS_SELECTOR, "[data-sitekey]").get_attribute("data-sitekey")
+token = solver.recaptcha(sitekey=sitekey, url=driver.current_url)["code"]
+
+driver.execute_script(
+    "document.getElementById('g-recaptcha-response').value = arguments[0];", token
+)
+driver.find_element(By.CSS_SELECTOR, "form").submit()
+```
+
+### Playwright
+
+```python
+from capskip import AsyncCapSkip
+
+solver = AsyncCapSkip()
+sitekey = await page.get_attribute("[data-sitekey]", "data-sitekey")
+result = await solver.recaptcha(sitekey=sitekey, url=page.url)
+
+await page.evaluate(
+    "t => document.getElementById('g-recaptcha-response').value = t", result["code"]
+)
+```
+
+Scrapy and plain `requests` work the same way — solve first, then send the token as whatever form field the site expects. Longer walkthroughs: [Selenium](https://capskip.com/selenium-captcha-solver/) and [Playwright](https://capskip.com/playwright-captcha-solver/).
+
+---
+
 ## Return value
 
 Every solve method returns:
@@ -253,6 +323,42 @@ except TimeoutException:
 
 ---
 
+## FAQ
+
+### How do I solve a captcha in Python?
+
+Install the CapSkip desktop app, `pip install capskip`, then call the method that matches the widget — `recaptcha()`, `turnstile()`, `geetest()` or `normal()`. Each one polls until CapSkip has an answer, then returns a token, or the recognized text in the case of an image captcha.
+
+### Is this a free captcha solver?
+
+The SDK itself is MIT-licensed and free. Solving needs the CapSkip app, which is bought once rather than metered per captcha, so your cost stops scaling with volume.
+
+### Which captchas can it solve?
+
+reCAPTCHA v2 (checkbox and invisible), reCAPTCHA v3, reCAPTCHA Enterprise, Cloudflare Turnstile, GeeTest v3, and image/text captchas. Not hCaptcha, and not FunCaptcha/Arkose.
+
+### Does it work with Selenium and Playwright?
+
+Yes — see [above](#selenium-playwright-and-scrapy). The SDK never touches a browser itself, so it drops into whatever stack you already have, Scrapy and plain `requests` included.
+
+### Why is my reCAPTCHA v3 score low?
+
+Google derives v3 scores from IP reputation, cookies and browsing history. A solver returns a valid token, but it cannot change how Google grades that token — `score=` is forwarded as the target you want, not a guarantee. If a site enforces a high threshold, solve through a cleaner IP using the `proxy` argument.
+
+### Can I use it as a 2captcha alternative?
+
+Yes. CapSkip serves the same endpoints, so you can either move to this SDK or repoint an existing 2captcha client at `127.0.0.1:8080`.
+
+### Does the captcha have to be on a public page?
+
+For widget captchas, yes — CapSkip loads the URL you pass it. Image captchas only need the image, and that can be a local file.
+
+### Is asyncio supported?
+
+`AsyncCapSkip` is a full async client. Use it with `asyncio.gather` to run several solves at once.
+
+---
+
 ## Development
 
 ```bash
@@ -276,10 +382,12 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for the full development workflow.
 
 ## Links
 
-- [CapSkip website](https://capskip.com)
-- [CapSkip API docs](https://capskip.com/api-docs/)
-- [Report an issue](https://github.com/capskip/capskip-python/issues)
-- [PyPI package](https://pypi.org/project/capskip/)
+- [CapSkip — local captcha solver](https://capskip.com) · [download](https://capskip.com/download/)
+- [Captcha demo pages](https://capskip.com/captcha-demo/) — live reCAPTCHA, Turnstile, GeeTest and image widgets
+- [Python captcha solver guide](https://capskip.com/python-captcha-solver/)
+- [HTTP API docs](https://capskip.com/api-docs/)
+- Other clients: [Node.js](https://github.com/capskip/capskip-node) · [PHP](https://github.com/capskip/capskip-php) · [.NET](https://github.com/capskip/capskip-dotnet) · [MCP server for AI agents](https://github.com/capskip/capskip-mcp)
+- [PyPI package](https://pypi.org/project/capskip/) · [report an issue](https://github.com/capskip/capskip-python/issues)
 
 ---
 

pyproject.toml

@@ -5,17 +5,38 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "capskip"
 version = "1.1.0"
-description = "Python SDK for the CapSkip local captcha solver"
+description = "Captcha solver for Python: solve reCAPTCHA v2/v3, Cloudflare Turnstile, GeeTest and image captchas with CapSkip, a local unlimited captcha solver with no per-solve fees."
 readme = "README.md"
 license = { text = "MIT" }
 authors = [{ name = "CapSkip", email = "support@capskip.com" }]
 keywords = [
     "captcha",
     "captcha-solver",
+    "captcha-solving",
+    "captcha-bypass",
+    "unlimited-captcha-solver",
+    "local-captcha-solver",
+    "free-captcha-solver",
     "recaptcha",
+    "recaptcha-solver",
+    "recaptcha-v2",
+    "recaptcha-v3",
+    "recaptcha-enterprise",
     "cloudflare",
     "turnstile",
+    "turnstile-solver",
+    "cloudflare-turnstile",
     "geetest",
+    "geetest-solver",
+    "image-captcha",
+    "ocr",
+    "2captcha-alternative",
+    "anti-captcha-alternative",
+    "selenium",
+    "playwright",
+    "scrapy",
+    "browser-automation",
+    "web-scraping",
     "capskip",
     "automation",
 ]
@@ -27,8 +48,12 @@ classifiers = [
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Operating System :: OS Independent",
     "Topic :: Software Development :: Libraries :: Python Modules",
     "Topic :: Internet :: WWW/HTTP",
+    "Topic :: Internet :: WWW/HTTP :: Browsers",
+    "Topic :: Utilities",
 ]
 requires-python = ">=3.10"
 dependencies = [