La **Matriz de capacidades** es la respuesta canónica a «¿qué resuelve CaptchaSonic y cómo lo llamo?». Cada fila vincula un CAPTCHA con su método de Python, su método de Node.js, su `task.type` de REST y el campo exacto que contiene la respuesta. Es la fuente única de verdad que leen la documentación, los SDK y los **agentes de IA / clientes MCP** externos.

> [!TIP]
> **Descarga la matriz en JSON** para usarla en agentes, automatizaciones o tus propios paneles: <a href="/capabilities.json" download>capabilities.json</a>. El JSON refleja `src/data/capabilities.ts` campo por campo.

---

## Cómo leerla

- **Familia** — `token` devuelve una cadena de token (que insertas en un campo de formulario oculto); `image` devuelve coordenadas o texto a partir de una imagen que proporcionas; `interactive` devuelve una acción estructurada (índices de clic, desplazamientos de arrastre, etc.).
- **SDK de Python / SDK de Node.js** — el nombre del método y la ruta con puntos bajo el objeto de respuesta donde está la respuesta. `not in SDK` significa que el CAPTCHA solo es accesible hoy a través de la API REST.
- **taskType de REST** — la cadena exacta que pasas como `task.type` a `POST /createTask`. Se muestra una variante `proxyless` aparte cuando la API la expone (p. ej., `TurnstileTaskProxyless`).
- **Notas** — advertencias fijadas (argumentos obligatorios, requisitos de proxy, semántica de subtipos).

---

## Matriz

<CapabilityMatrix />

---

## Recuento

- **{CAPABILITY_COUNTS.total}** filas en total — una por cada CAPTCHA documentado.
- **{CAPABILITY_COUNTS.pythonCovered}** métodos del SDK de Python y **{CAPABILITY_COUNTS.nodeCovered}** métodos del SDK de Node.js (uno por cada CAPTCHA).
- **{CAPABILITY_COUNTS.byFamily.token}** de familia token, **{CAPABILITY_COUNTS.byFamily.image}** de familia image y **{CAPABILITY_COUNTS.byFamily.interactive}** de familia interactive.

Estos recuentos se leen en vivo del `capabilities.ts` generado, por lo que siguen al SDK y no pueden desfasarse de la matriz de arriba.

---

## Garantías de estabilidad

- **Añadir filas** no rompe nada. Los nuevos CAPTCHA se añaden al final de `CAPABILITIES` en `src/data/capabilities.ts`.
- **Eliminar o renombrar un `slug`** es un cambio incompatible para cualquier agente que lo haya fijado. No lo haremos en silencio.
- **Los nombres de métodos y los campos de respuesta** reflejan literalmente la documentación del SDK: si un método cambia de nombre, esta matriz se actualiza en la misma versión.

Para el contrato REST en bruto, consulta la [referencia de la API REST](/docs/api). Para la instalación y el inicio rápido de extremo a extremo, consulta las páginas del [SDK de Python](/docs/clients-sdks/python) y del [SDK de Node.js](/docs/clients-sdks/nodejs).

---

## Códigos de error

La matriz de arriba vincula cada CAPTCHA con su método y su campo de respuesta. La tabla siguiente es la referencia completa de los códigos numéricos `errorId` que todos los SDK y la API REST devuelven cuando una tarea falla.

<ErrorIdTable />
