Как добавить расширение для решения CAPTCHA к goose

Рабочий пример goose MCP-расширения, построенного на фикстурах, с одним контролируемым восстановлением, ограниченным опросом, проверкой результата и передачей человеку.

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

Введение

Когда авторизованный goose-агент сталкивается с CAPTCHA-прерыванием, ему нужен небольшой компонент восстановления с чёткими ограничениями и запасным вариантом с участием человека. Этот пример подключает CapSolver только после явной авторизации и получения поддерживаемого сигнала о challenge. Он не изменяет goose и не заявляет об официальном партнёрстве.

Related MCP server: sessemi-mcp

Возможности

• Встроенная в goose поверхность MCP-расширения

• Шлюзы авторизации и проверки challenge

• Стабильный идентификатор восстановления и защита от дубликатов

• Один вызов create и не более пяти опросов

• Структурированные коды остановки и передача человеку

• Автономные фикстуры без реального ключа или целевого ресурса

Как это работает

Адаптер получает одобренный контекст задачи, проверяет политические шлюзы и бюджет повторов, вызывает транспорт, соответствующий официальному жизненному циклу задачи, проверяет структурированный результат и либо возобновляет выполнение один раз, либо останавливается для проверки человеком.

Архитектура

goose → adapter → policy gates → recovery client → validated result or human handoff

Быстрый старт

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

Использование

Используйте фикстуру в каталоге examples/ и заменяйте её поле task только после проверки официальной спецификации запроса createTask. Опрос результатов соответствует официальному жизненному циклу getTaskResult.

Пример вывода

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

Поддерживаемые сценарии

Собственные тестовые фикстуры, явно авторизованное тестирование и соразмерная автоматизация в отношении одобренных целевых ресурсов.

Структура проекта

• src/ — ядро восстановления и адаптер фреймворка

• tests/ — автономные модульные тесты

• examples/ — безопасная фикстура

• scripts/ — смоук-тест

Тестирование

Все тесты внедряют фикстурный клиент и не выполняют реальных вызовов API.

Устранение неполадок

Отсутствие авторизации, неподдерживаемый challenge, дублирующийся контекст, некорректный ответ, таймаут и исчерпанный бюджет являются условиями остановки, а не поводом для бесконечных повторов.

Ответственное использование

Используйте только общедоступные данные, собственные системы или целевые ресурсы, на которые получено явное письменное разрешение. Соблюдайте условия использования, правила доступа, лимиты частоты запросов, принципы минимизации данных и правила хранения. Никогда не используйте этот пример для работы с приватными данными, учётными данными, чувствительными персональными данными, неограниченным сбором данных или несанкционированным доступом.

Участие в разработке

Вносите изменения ограниченно, опираясь на фикстуры и безопасный отказ (fail-closed).

Безопасность

Никогда не коммитьте ключи, сессии, профили браузеров, приватные целевые ресурсы или производственные ответы. См. SECURITY.md.

Заключение

Это goose MCP-расширение делает восстановление узконаправленным, тестируемым и контролируемым вызывающей стороной. Проверяйте каждое поле производственной задачи по документации CapSolver перед авторизованным использованием.

Примечание сопровождающего

Разработчик, публикующий примеры интеграции с CapSolver.

Лицензия

MIT