solvethree 에이전트 스킬 설치
공식 스킬 ZIP을 다운로드하고 solvethree/SKILL.md를 검토한 다음, solvethree 디렉터리 전체를 에이전트 호스트의 스킬 디렉터리에 복사하세요. 스킬은 통합 지침을 제공하며, 실행 가능한 해결 프로그램이나 MCP 연결을 제공하지는 않습니다.
이 페이지의 내용
다운로드, 검토 및 설치
curl --fail --location --output solvethree-skill-0.1.0.zip \
https://solvethree.com/downloads/solvethree-skill-0.1.0.zip
unzip -l solvethree-skill-0.1.0.zip
unzip solvethree-skill-0.1.0.zip -d ./skill-review
# Inspect skill-review/solvethree/SKILL.md before installing it in your host.
# The archive contains instructions; it does not start an MCP server.- 1.
압축 해제한 지침 읽기
설치 전에
skill-review/solvethree/SKILL.md를 열어 읽어 보세요. 에이전트가 받게 될 지침 텍스트입니다. 압축 파일을 다운로드하고 압축을 해제해도 서버가 시작되지는 않습니다. - 2.
호스트의 스킬 경로에 디렉터리 복사
Codex에서는 사용자 수준 설치에
~/.agents/skills/solvethree/SKILL.md를 사용하거나, 프로젝트 내부의.agents/skills/solvethree/SKILL.md를 사용하세요. Markdown 파일만이 아니라 압축 해제한solvethree디렉터리를 복사하세요. 다른 호스트에는 고유한 설치 경로가 있으므로 Codex와 같은 경로를 사용한다고 가정하지 마세요. - 3.
호스트에 문서화된 절차로 로드
호스트의 스킬 로드 지침을 따르세요. 자격 증명은 호스트 환경에 보관하고
SKILL.md에는 절대 넣지 마세요. 워크스페이스 API 키는 반드시 서버 측에만 보관해야 합니다.
스킬, MCP 서버, SDK의 역할은 서로 다릅니다
| 구성 요소 | 제공 기능 |
|---|---|
| 에이전트 스킬 | 작업 API와 통합하는 방법에 대한 지침입니다. 설치해도 호출 가능한 도구가 구성되지는 않습니다. |
| MCP 서버 | 호환되는 호스트에 지원 기능 확인, 작업 생성, 작업 조회 도구를 제공하는 로컬 stdio 서버입니다. |
| SDK | 애플리케이션 코드에서 solvethree와 통합할 때 사용하는 라이브러리입니다. |
호스트에 호출 가능한 도구가 필요하면 MCP 통합을 별도로 구성하세요. 공식 SDK 다운로드에는 solvethree-mcp가 포함되어 있으며, 호스트 환경에서 SOLVETHREE_API_KEY와 SOLVETHREE_PROXY를 제공합니다. 이는 호스팅된 엔드포인트가 아닙니다.
스킬을 로드하면 에이전트가 자율적으로 API를 호출한다고 가정하지 마세요. 요청을 보낼 수단을 구성하고 이를 사용할 권한을 부여해야 합니다. MCP 서버는 브라우저를 제어하거나 양식을 채우지 않으므로 애플리케이션이 반환된 솔루션을 적용해야 합니다.
해결 요청 전에 대상 준비
소유하고 있거나 테스트 권한이 있는 대상을 위한 reCAPTCHA 작업에는 호스트명, 액션, 프록시 입력값을 제공하세요. 워크스페이스에 먼저 활성 사이트 프로필이 있어야 합니다. 스킬을 설치하거나 작업을 전송해도 프로필이 생성되지는 않습니다. 사이트 프로필을 사용하거나 프로필 설정 지침을 따르고, 프로필이 의도한 호스트명, 캡처 액션, reCAPTCHA 유형과 일치하는지 확인하세요.
생성 후 작업 ID를 보관하세요. pending과 solving은 계속 기다려야 한다는 뜻이며, 사용 가능한 솔루션은 ready에만 포함됩니다. 작업이 failed이면 변경하지 않은 입력값으로 반복 요청하지 말고 폴링을 중단한 후 errorCode와 error를 확인하세요.
반환된 브라우저 식별 정보와 해결에 성공한 프록시를 사용해 의도한 대상으로 보내는 요청에 결과를 적용하세요. reCAPTCHA의 경우 solution.token을 제출하세요. 다른 제품은 서로 다른 결과 형식을 반환합니다. 작업이 준비되었다는 것은 solvethree가 솔루션을 생성했다는 뜻이지, 애플리케이션 요청이 성공했다는 뜻은 아닙니다.
출처 및 API 레퍼런스
첫 작업을 실행하세요.
워크스페이스 크레딧 $5로 시작하세요.