goose에 CAPTCHA 솔버 확장 프로그램을 추가하는 방법

실행 가능하고 픽스처 우선(fixture-first) 방식의 goose MCP 확장 프로그램으로, 통제된 단일 복구, 제한된 폴링, 결과 검증, 사람 인계를 제공합니다.

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

소개

인가된 goose 에이전트가 CAPTCHA 중단 상황을 만나면, 명확한 한계와 사람이 개입할 수 있는 폴백을 갖춘 작은 복구 구성 요소가 필요합니다. 이 예제는 명시적 인가와 지원되는 챌린지 신호가 있을 때만 CapSolver를 도입합니다. goose를 수정하거나 공식 파트너십을 주장하지 않습니다.

Related MCP server: sessemi-mcp

기능

• 프레임워크 네이티브 goose MCP 확장 인터페이스

• 인가 및 챌린지 게이트

• 안정적인 복구 ID 및 중복 방지

• 생성 호출 1회와 최대 5회 폴링

• 구조화된 중지 코드 및 사람 인계

• 실제 키나 대상이 없는 오프라인 픽스처

작동 방식

어댑터는 승인된 작업 컨텍스트를 받아 정책 게이트와 재시도 예산을 검증하고, 공식 작업 수명 주기에 맞는 트랜스포트를 호출하며, 구조화된 결과를 검증한 다음 한 번 재개하거나 사람의 검토를 위해 중지합니다.

아키텍처

goose → 어댑터 → 정책 게이트 → 복구 클라이언트 → 검증된 결과 또는 사람 인계

빠른 시작

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

사용법

examples/의 픽스처를 사용하고, 공식 createTask 요청 규약을 확인한 후에만 해당 task를 교체하세요. 결과 폴링은 공식 getTaskResult 수명 주기를 따릅니다.

예제 출력

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

지원 시나리오

소유한 테스트 픽스처, 명시적으로 인가된 QA, 승인된 대상에 대한 비례적 자동화.

프로젝트 구조

• src/ — 복구 코어 및 프레임워크 어댑터

• tests/ — 오프라인 단위 테스트

• examples/ — 안전한 픽스처

• scripts/ — 스모크 테스트

테스트

모든 테스트는 픽스처 클라이언트를 주입하며 실제 API 호출을 수행하지 않습니다.

문제 해결

인가, 지원되지 않는 챌린지, 중복 컨텍스트, 잘못된 형식의 응답, 시간 초과, 예산 소진은 중지 조건이지 무제한 재시도의 이유가 아닙니다.

책임 있는 사용

공개 데이터, 소유한 시스템, 또는 명시적 서면 인가를 받은 대상만 사용하세요. 이용 약관, 접근 정책, 레이트 리밋, 최소화 및 보존 규칙을 준수하세요. 개인 데이터, 자격 증명, 민감한 개인 정보, 무제한 수집 또는 무단 접근에 이 예제를 절대 사용하지 마세요.

기여

변경 사항은 범위를 한정하고, 픽스처 우선(fixture-first)으로 유지하며, 실패 시 차단(fail-closed)되도록 하세요.

보안

키, 세션, 브라우저 프로필, 비공개 대상 또는 프로덕션 응답을 커밋하지 마세요. SECURITY.md를 참조하세요.

결론

이 goose MCP 확장 프로그램은 복구 범위를 좁게, 테스트 가능하게, 호출자가 통제할 수 있게 유지합니다. 인가된 사용 전에 모든 프로덕션 작업 필드를 CapSolver 문서와 대조하여 확인하세요.

유지관리자 노트

CapSolver 통합 예제를 공유하는 개발자입니다.

라이선스

MIT