Community라이팅 & 에디팅github.com

Mucaktr/challenge-aware-webbridge

브라우저 자동화 중 봇 감지 페이지(챌린지)를 감지하여 사용자에게 안전하게 작업을 넘기고, 챌린지가 해제되면 원래 워크플로를 재개하는 Codex/Kimi WebBridge 스킬입니다.

challenge-aware-webbridge란 무엇인가요?

이 스킬은 Kimi WebBridge 환경에서 브라우저 자동화 작업 중 verification 페이지(챌린지)가 나타날 때를 대비하여 설계되었습니다. 자동화 도구가 차단되거나 멈추는 대신, 챌린지 페이지를 감지하고 사용자에게 명확하게 제어권을 넘긴 후, 챌린지가 해제되면 동일한 세션에서 작업을 자동으로 재개합니다. 주요 기능으로는 `scripts/detect_verification_page.py`를 통한 챌린지 감지, 사용자에게 수동 확인이 필요함을 안내하는 핸드오프, `scripts/wait_for_clearance.py`를 통한 챌린지 해제 대기 및 확인, 그리고 해제 후 스냅샷을 통해 작업 재개가 포함됩니다. 이 스킬은 봇 우회 도구가 아니며, 사용자에게 투명하고 안전한 방식으로 자동화의 연속성을 유지하는 데 중점을 둡니다. Windows 환경에서는 UTF-8 임시 파일을 통해 요청 본문을 전송하는 `scripts/webbridge_request.py` 사용을 권장합니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add Mucaktr/challenge-aware-webbridge

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Challenge Aware WebBridge

개요

이 스킬은 verification 페이지가 일반적인 자동화를 방해할 때 브라우저 작업을 계속 진행할 수 있도록 합니다. 챌린지 페이지를 감지하고, 사용자에게 깔끔하게 제어권을 넘기며, 챌린지가 해제될 때까지 기다린 후, 동일한 Kimi WebBridge 세션에서 원래 작업을 재개합니다.

워크플로

  1. 전체 사용자 작업에 대해 하나의 안정적인 session 이름을 재사용합니다. 하나의 탐색 작업을 여러 세션 이름으로 분할하지 마십시오.
  2. 탐색 후, 페이지 제목, URL 또는 표시되는 텍스트가 의심스러우면 scripts/detect_verification_page.py를 실행합니다.
  3. 챌린지가 감지되지 않으면 일반 탐색을 계속합니다.
  4. 챌린지가 감지된 경우:
    • 사용자에게 사이트가 수동 확인을 기다리고 있다고 명확하게 알립니다.
    • 현재 탭과 세션을 활성 상태로 유지합니다.
    • 사용자가 상호 작용할 수 있도록 필요에 따라 페이지를 보기 영역으로 가져옵니다.
    • 사용자가 명시적으로 준비를 요청하는 경우에만 페이지 열기, 레이아웃 대기, 챌린지 외부의 중립적인 영역에 포커스하기와 같은 제출되지 않는 작업만 수행합니다.
    • 스킬이 챌린지를 자동으로 우회, 해결 또는 무력화할 수 있다고 주장하지 마십시오.
  5. scripts/wait_for_clearance.py를 실행하여 인터스티셜이 사라지거나 타임아웃이 만료될 때까지 폴링합니다.
  6. 페이지가 해제되면 새로운 snapshot을 찍고 원래 작업을 재개합니다.

안전한 기본값

  • 광범위한 페이지 덤프보다는 간결한 snapshot과 evaluate 프로브를 선호합니다.
  • checkLoading, turnstile, captcha, verify, checking your browser와 같은 제목 또는 URL 단서를 강력한 신호로 취급합니다.
  • 모든 사용자 대상 언어는 차분하고 구체적으로 유지합니다. 작업을 차단하는 것이 무엇인지와 사용자가 다음에 무엇을 해야 하는지 설명하십시오.
  • 도우미 스크립트나 저장소 파일에 비밀, 쿠키 또는 개인 데이터를 저장하지 마십시오.
  • 이 스킬을 안티봇 회피 도구로 제시하지 마십시오.

도구

  • 데몬 호출에는 scripts/webbridge_request.py를 사용하십시오. 특히 Windows에서는 요청 본문을 UTF-8 임시 파일에서 게시해야 합니다.
  • 현재 페이지를 챌린지 없음 또는 챌린지 있음으로 분류하려면 scripts/detect_verification_page.py를 사용하십시오.
  • 사용자 핸드오프 후 사이트가 다시 준비되었는지 감지하려면 scripts/wait_for_clearance.py를 사용하십시오.

참고 자료

  • 감지 신호 및 복구 패턴은 references/challenge-patterns.md를 읽으십시오.
  • 간결한 사용자 대상 핸드오프 언어는 references/user-messaging.md를 읽으십시오.

관련 스킬