如何为 goose 添加验证码解决器扩展

一个可运行、以夹具优先的 goose MCP 扩展，具备一次受控恢复、有界轮询、结果验证和人工交接。

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

简介

当经过授权的 goose 代理遇到 CAPTCHA 中断时，它需要一个具有明确限制和人工回退的小型恢复组件。本示例仅在明确授权和支持的验证码信号之后引入 CapSolver。它不会修改 goose，也不声称存在官方合作关系。

Related MCP server: sessemi-mcp

功能特性

• 框架原生的 goose MCP 扩展接口

• 授权与验证码门控

• 稳定的恢复 ID 和重复保护

• 一次创建调用，最多五次轮询

• 结构化停止码和人工交接

• 离线夹具，无真实密钥或目标

工作原理

适配器接收已批准的任务上下文，验证策略门控和重试预算，调用与官方任务生命周期匹配的传输层，验证结构化结果，然后要么恢复一次，要么停止以供人工审查。

架构

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

快速开始

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

使用方法

仅在查看官方 createTask 请求契约后，使用 examples/ 中的夹具并替换其 task。结果轮询遵循官方 getTaskResult 生命周期。

示例输出

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

支持场景

自有测试夹具、明确授权的 QA，以及针对已批准目标的适度自动化。

项目结构

• src/ — 恢复核心与框架适配器

• tests/ — 离线单元测试

• examples/ — 安全夹具

• scripts/ — 冒烟测试

测试

所有测试均注入夹具客户端，不进行任何实时 API 调用。

故障排查

授权失败、不支持的验证码、重复上下文、格式错误的响应、超时和预算耗尽都是停止条件——而非无限重试的理由。

负责任使用

仅使用公共数据、自有系统或明确书面授权涵盖的目标。遵守条款、访问策略、速率限制、最小化和保留规则。切勿将本示例用于私人数据、凭据、敏感个人数据、无限制收集或未经授权的访问。

贡献

保持变更有限、夹具优先，并默认失败关闭。

安全

切勿提交密钥、会话、浏览器配置文件、私有目标或生产响应。参见 SECURITY.md。

结论

此 goose MCP 扩展使恢复保持窄范围、可测试且由调用方控制。在授权使用前，请对照 CapSolver 文档验证每个生产任务字段。

维护者说明

分享 CapSolver 集成示例的开发者。

许可证

MIT