Cómo añadir una extensión de resolución de CAPTCHA a goose

Una extensión MCP de goose ejecutable y basada en fixtures con una recuperación controlada, sondeo limitado, validación de resultados y traspaso a un humano.

English · 简体中文 · 日本語 · Español · Português · 한국어

Introducción

Cuando un agente goose autorizado se encuentra con una interrupción por CAPTCHA, necesita un pequeño componente de recuperación con límites claros y un respaldo humano. Este ejemplo introduce CapSolver solo después de una autorización explícita y una señal de desafío compatible. No modifica goose ni reivindica una asociación oficial.

Related MCP server: sessemi-mcp

Características

• Superficie de extensión MCP de goose nativa del framework

• Puertas de autorización y de desafío

• ID de recuperación estable y protección contra duplicados

• Una única llamada de creación y como máximo cinco sondeos

• Códigos de detención estructurados y traspaso a un humano

• Fixtures sin conexión sin clave ni objetivo reales

Cómo funciona

El adaptador recibe el contexto de tarea aprobado, valida las puertas de política y el presupuesto de reintentos, llama a un transporte que coincide con el ciclo de vida oficial de la tarea, valida el resultado estructurado y, o bien reanuda una vez, o bien se detiene para revisión humana.

Arquitectura

goose → adaptador → puertas de política → cliente de recuperación → resultado validado o traspaso a un humano

Inicio rápido

python -m unittest discover -s tests -q\npython scripts/smoke_test.py

Uso

Usa el fixture en examples/ y reemplaza su task solo después de consultar el contrato oficial de solicitud createTask. El sondeo de resultados sigue el ciclo de vida oficial de getTaskResult.

Ejemplo de salida

{"ok":true,"status":"ready","polls":1,"solution":{"fixtureResult":"ok"}}

Escenarios compatibles

Fixtures de prueba propios, control de calidad explícitamente autorizado y automatización proporcionada contra objetivos aprobados.

Estructura del proyecto

• src/ — núcleo de recuperación y adaptador del framework

• tests/ — pruebas unitarias sin conexión

• examples/ — fixture seguro

• scripts/ — prueba de humo

Pruebas

Todas las pruebas inyectan un cliente fixture y no realizan ninguna llamada real a la API.

Solución de problemas

Autorización, desafío no compatible, contexto duplicado, respuesta malformada, tiempo de espera agotado y presupuesto agotado son condiciones de detención, no motivos para reintentos ilimitados.

Uso responsable

Usa únicamente datos públicos, sistemas propios u objetivos cubiertos por una autorización escrita explícita. Respeta los términos, las políticas de acceso, los límites de velocidad, la minimización y las normas de retención. No uses nunca este ejemplo para datos privados, credenciales, datos personales sensibles, recopilación ilimitada o acceso no autorizado.

Contribuciones

Mantén los cambios acotados, basados en fixtures y con cierre ante fallos.

Seguridad

Nunca confirmes claves, sesiones, perfiles de navegador, objetivos privados o respuestas de producción. Consulta SECURITY.md.

Conclusión

Esta extensión MCP de goose mantiene la recuperación acotada, comprobable y controlada por quien la invoca. Verifica cada campo de tarea de producción con la documentación de CapSolver antes de un uso autorizado.

Nota del mantenedor

Desarrollador que comparte ejemplos de integración con CapSolver.

Licencia

MIT