Как добавить инструмент решения CAPTCHA в Ruflo

Запускаемый, основанный на фикстурах stdio MCP-инструмент с одной попыткой восстановления, ограниченным опросом, структурированной валидацией и передачей человеку.

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

Введение

Когда авторизованный рабочий процесс Ruflo сталкивается с прерыванием CAPTCHA, ему нужен ограниченный инструмент восстановления, который либо возвращает проверенный результат, либо останавливается для проверки человеком. Этот вспомогательный MCP-сервер показывает, как задача Ruflo может вызывать CapSolver только после явной авторизации и поддерживаемого сигнала вызова. Он не изменяет Ruflo и не претендует на официальное партнерство. Объект задачи API остается на проверке вызывающей стороны, поэтому пример не выдумывает поля продукта.

Возможности

• Один MCP-инструмент: captcha_solver_recover_once

• Явные проверки авторизации и вызова

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

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

• Тайм-ауты, структурированные ошибки и передача человеку

• Офлайн-фикстуры; не требуется реальный ключ или цель

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

Ruflo направляет одобренную задачу на локальный stdio-сервер. Инструмент проверяет авторизацию, состояние вызова, контекст и бюджет перед использованием официального контракта создания задачи. Он принимает только готовое решение, в противном случае опрашивает в пределах настроенного бюджета и безопасно останавливается.

Архитектура

Ruflo → MCP tools/call → policy gates → CapSolver client → result validator → resume or human handoff

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

npm test
npm run smoke
CAPSOLVER_API_KEY=replace_me npm start

В веб-интерфейсе Ruflo откройте MCP (n) → Add Server, выберите stdio-сервер и используйте node src/server.js в качестве локальной команды. Ruflo также документирует конечные точки HTTP и SSE; этот репозиторий намеренно реализует только stdio.

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

Используйте examples/tool-call.json в качестве формы фикстуры. Заменяйте task только на объект задачи, проверенный на соответствие официальному контракту запроса createTask. Опрос результатов следует официальному жизненному циклу getTaskResult.

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

{"ok":true,"status":"ready","recoveryId":"qa-run-0001","polls":1,"solution":{"fixtureResult":"ok"}}

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

Собственные тестовые фикстуры, явно авторизованное QA и соразмерная автоматизация против одобренных целей. Неподдерживаемые состояния останавливаются для проверки человеком.

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

• src/server.js — маршрутизатор stdio JSON-RPC

• src/tool.js — определение MCP-инструмента и безопасное сопоставление ошибок

• src/recovery.js — ограниченный контракт восстановления

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

• examples/ — вызов инструмента только с фикстурами

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

npm test
npm run smoke

Тесты используют внедрённые клиенты и никогда не вызывают живой API.

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

AUTHORIZATION_REQUIRED, NO_SUPPORTED_CHALLENGE, DUPLICATE_RECOVERY, TIMEOUT и BUDGET_EXHAUSTED являются сигналами остановки. Проверьте задачу и передайте её человеку, а не повторяйте попытки бесконечно.

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

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

Вклад

Сохраняйте изменения на основе фикстур, ограниченными и закрывающимися при сбое. Запустите обе проверки перед запросом на включение.

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

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

Заключение

Этот вспомогательный инструмент даёт Ruflo небольшую, проверяемую границу восстановления, сохраняя при этом явными маршрутизацию, бюджеты, валидацию и контроль человека. Для авторизованного производственного адаптера подтвердите каждое поле задачи по документации CapSolver перед использованием.

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

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

Лицензия

MIT