La extensión de navegador de CaptchaSonic es la forma más sencilla de resolver CAPTCHAs durante la navegación manual o dentro de frameworks de automatización como Selenium. Esta guía cubre la instalación y la configuración en todos los navegadores compatibles.

---

## 🚀 Características principales

*   **Resolución sin clics**: detecta e inicia automáticamente la resolución de la mayoría de los tipos de CAPTCHA principales.
*   **Modo invisible**: funciona en segundo plano sin interrumpir tu vista.
*   **Amplia compatibilidad**: admite reCAPTCHA (v2/v3/Invisible), hCaptcha, GeeTest y más.
*   **Lista negra**: define los dominios específicos en los que quieres desactivar la resolución automática.

---

## 1. Requisitos previos

Antes de instalar, necesitas:
1.  Una [cuenta de CaptchaSonic](https://captchasonic.com).
2.  Una **clave API** de tu [panel](https://captchasonic.com/app).

> [!IMPORTANT]
> Tu clave API es privada. Nunca la compartas ni la subas a repositorios públicos.

---

## 2. Instalación

### Para Google Chrome

Como nuestra extensión se actualiza con frecuencia con nuevos modelos de IA, recomendamos instalar la versión «unpacked» para tener las funciones más recientes.

1.  **Instalar desde la tienda**: la forma más sencilla. Añádela directamente desde la [Chrome Web Store](https://chromewebstore.google.com/detail/captchasonic-automatic-ca/dkkdakdkffippajmebplgnpmijmnejlh).

O bien, para la última versión no publicada:

1.  **Descargar**: obtén el ZIP más reciente de la extensión desde nuestras [versiones en GitHub](https://github.com/Captcha-Sonic/CaptchaSonic-Extension/releases/latest).
2.  **Extraer**: descomprime la carpeta descargada en una ubicación permanente de tu disco.
3.  **Gestionar extensiones**: abre Chrome y ve a `chrome://extensions/`.
4.  **Modo de desarrollador**: activa el interruptor **Developer Mode** en la esquina superior derecha.
5.  **Cargar sin empaquetar**: haz clic en el botón **Load unpacked** y selecciona la carpeta extraída.

![Pasos de instalación de la extensión en Chrome](/guides/BE/guide.7.png)

### Para Mozilla Firefox

1.  **Instalar desde la tienda**: añádela directamente desde [Firefox Add-ons](https://addons.mozilla.org/en-US/firefox/addon/captchasonic/).

O instálala manualmente desde un `.xpi`:

1.  **Descargar**: obtén el `.xpi` desde nuestras [versiones en GitHub](https://github.com/Captcha-Sonic/CaptchaSonic-Extension/releases/latest).
2.  **Menú de complementos**: abre Firefox, haz clic en el botón de menú (tres líneas) y selecciona **Add-ons and Themes**.
3.  **Instalar desde archivo**: haz clic en el icono de engranaje sobre tus extensiones y elige **Install Add-on From File...**.
4.  **Confirmar**: selecciona el archivo `.xpi` y haz clic en **Add**.

---

## 3. Configuración

Una vez instalada, haz clic en el icono de CaptchaSonic de la barra de herramientas del navegador para abrir el popup de ajustes.

1.  **Autenticación**: pega tu **API Key** en el primer campo y haz clic en **Save**.
2.  **Activar módulos**: activa los tipos de CAPTCHA que quieres resolver automáticamente.
3.  **Opciones avanzadas**: 
    *   **Retardo de resolución**: define un retardo si quieres parecer más humano.
    *   **Envío automático**: hace clic automáticamente en «Verify» cuando se resuelve un desafío.

![Interfaz de ajustes de la extensión](/guides/BE/guide.17.png)

---

## 4. Uso

La extensión está pensada para configurarla una vez y olvidarse.

*   **Detección**: al visitar una página con CAPTCHA, el icono de la extensión cambia de estado para indicar que ha encontrado un desafío.
*   **Estado**: puede aparecer una pequeña insignia de estado cerca del widget de CAPTCHA que muestra el progreso de la resolución.
*   **Finalización**: una vez resuelto, la extensión introduce el token resultante y, si está configurado, envía el formulario.

---

## 5. Solución de problemas (FAQ)

**P: La extensión no resuelve el CAPTCHA.**
*   R: Revisa tu [panel](https://captchasonic.com/app) para confirmar que tienes créditos suficientes. Verifica que tu clave API está bien pegada en los ajustes.

**P: Me aparece el error «Low Score» en reCAPTCHA v3.**
*   R: reCAPTCHA v3 depende del historial de tu navegador y de la reputación de tu IP. Prueba con un proxy de buena calidad o borra la caché del navegador.

**P: Chrome dice que la extensión está «dañada».**
*   R: Suele pasar si moviste la carpeta de la extensión después de cargarla. Elimínala de `chrome://extensions/` y vuelve a hacer clic en «Load unpacked».

---

## 6. Soporte

Si tienes problemas persistentes, contacta con nuestro equipo técnico mediante el chat en vivo del [panel oficial](https://captchasonic.com/app).

---

> [!TIP]
> **Nota para desarrolladores**: ¿haces scraping de alto volumen? Considera usar nuestra [API REST](/docs/api) en lugar de la extensión de navegador para obtener un rendimiento considerablemente mayor.
