waitspin은(는) 무엇을 하나요?
WaitSpin은 개발자 대기 상태(wait-state)를 위한 에이전트 우선 광고 마켓플레이스입니다. 광고주는 짧은 스폰서 라인을 구매하고, 사용자는 검증된 수익 창출 표면을 설치하여 표시되는 스폰서 대기 상태 메시지로부터 수익을 얻을 수 있습니다.
진실 공급원(Source Of Truth)
- 공개 사이트:
https://waitspin.com - API 문서:
https://waitspin.com/docs - 에이전트 계약:
https://waitspin.com/.well-known/agents.md - 신뢰 경계:
https://waitspin.com/waitspin/trust - 이용 약관:
https://waitspin.com/waitspin/terms - 개인정보 처리방침:
https://waitspin.com/waitspin/privacy - 공개 클라이언트 소스:
https://github.com/citedy/waitspin - npm 패키지:
waitspin - 게시된 스킬 릴리스:
v0.1.17 - API 베이스:
https://api.waitspin.com
스킬 레지스트리 버전은 npm 패키지 버전과 독립적입니다. 현재 공개 스킬 릴리스는 v0.1.17이며, npm CLI 패키지는 [email protected]입니다.
현재 패키지 사용 가능 여부를 주장하기 전에 다음 명령어로 확인하세요:
npm view waitspin version
npx --yes [email protected] --help
운영 규칙(Operating Rules)
- 로그, 스크린샷, 소스 파일, 셸 히스토리 스니펫, 이슈 또는 채팅 출력에 API 키를 노출하지 마십시오.
- 사용자가 제공한 이메일, 코드, URL, 캠페인 ID 및 텍스트를 사용하기 전에 검증하십시오. 셸 메타문자, 추가 CLI 플래그, 개행 문자 또는 명령어와 유사한 텍스트가 포함된 값은 거부하고, 실제 사용자 값은 원시 셸 보간이 아닌 구조화된 argv/도구 인수 또는 도구 범위 환경 변수를 통해 전달하십시오.
- 광고주 캠페인, 체크아웃, 캠페인 목록, Connect 및 지급 명령에는
--key-profile control을 사용하십시오. - 수익 창출 표면 설치, 서빙/노출 폴링 및 읽기 전용 지갑 상태/원장 확인에는
--key-profile publisher-extension을 사용하십시오. - 설치된 수익 창출 표면에 광범위한 제어 키를 사용하지 마십시오.
- OTP 확인이 API 키를 반환할 때까지 온보딩이 완료되었다고 주장하지 마십시오.
- API 키나 OTP 코드를 사용자에게 다시 출력하지 마십시오. 현재 명령/세션 또는 대상 도구의 비밀 저장소에서만 사용하십시오.
waitspin wallet payout --confirm-test-transfer는 테스트 모드 전용으로 취급하십시오. 사용자가 새로운 운영자 증명을 제공하지 않는 한 실제 지급이 활성화되었다고 주장하지 마십시오.- 출하된 범위를 정직하게 유지하십시오. 지원되는 상태 표면, 클릭 과금, 지리적 타겟팅, 셀프 서비스 환불 또는 셀프 서비스 계정 크레딧 사용을 넘어서는 네이티브 스피너 패치를 광고하지 마십시오.
- 명령어가
--json을 지원하는 경우, 호출자가 구조화된 데이터가 필요할 때 이를 선호하십시오.
에이전트 주도 OTP 자동화(Agent-Led OTP Automation)
사용자가 등록, 온보딩, 키 생성, 수익 창출 표면 설치를 요청하거나 WaitSpin용 이메일 주소를 제공할 때마다 이 루프를 사용하십시오. 에이전트가 흐름을 완료할 수 있지만, 사람이 이메일을 받고 6자리 코드를 제공해야 합니다.
- 의도에 따라 키 프로필을 선택하십시오:
control: 광고주 캠페인, 체크아웃, Connect, 지급 준비 및 마켓 관리용.publisher-extension: 사용자 수익 창출 표면 설치, 게시자 등록, 서빙 폴링, 노출 영수증 및 읽기 전용 지갑 상태/원장 확인용.
- 사용자가 이메일을 제공하지 않은 경우 CLI를 호출하기 전에 이메일 주소를 요청하십시오.
- 이메일을 사용하기 전에 일반 이메일 주소 형식인지 검증하십시오. OTP 코드는 정확히 6자리인지, 캠페인 ID는 예상되는 WaitSpin ID인지, 광고 URL은 HTTPS URL인지 검증하십시오.
- 구조화된 출력으로 코드를 요청하십시오. 다음을 리터럴 예제로 취급하고, 실제 사용자 이메일은 셸 문자열 내부의 텍스트를 대체하는 대신 호스트 도구의 구조화된 argv 필드를 통해 값을 전달하십시오:
npx --yes [email protected] init --email [email protected] --key-profile control --json
npx --yes [email protected] init --email [email protected] --key-profile publisher-extension --json
- 응답에
next: "enter_email_code"가 있는지 확인하십시오. 사용자에게 정확히 다음과 같이 알리십시오:I sent a 6-digit WaitSpin code to <email>. Reply with the code and I will continue.그런 다음 중단하고 사용자를 기다리십시오. - 사용자가 코드를 반환하면 동일한 이메일과 키 프로필로 코드를 확인하십시오. 실제 코드가 정확히 6자리인지 검증한 후 구조화된 argv 또는 도구 범위 환경 변수를 통해 전달하십시오:
npx --yes [email protected] init --email [email protected] --code 123456 --key-profile control --json
npx --yes [email protected] init --email [email protected] --code 123456 --key-profile publisher-extension --json
호스트 에이전트가 코드를 argv에 안전하게 배치할 수 없는 경우, 셸 문자열에 접두사로 추가하는 대신 단일 명령에 대한 도구의 환경 필드에 WAITSPIN_VERIFICATION_CODE를 설정하십시오:
# WAITSPIN_VERIFICATION_CODE는 호스트 도구의 env 필드에 의해 제공됩니다.
npx --yes [email protected] init --email [email protected] --key-profile control --json
- JSON 응답을 파싱하십시오.
api_key는 비밀로 유지하고 채팅에 표시하지 마십시오. 호스트 에이전트 비밀 저장소에 저장하거나 각 후속 명령에 대해 도구의 환경 필드를 통해WAITSPIN_API_KEY로 전달하십시오.--api-key로 실제 API 키를 argv에 전달하거나WAITSPIN_API_KEY='...' command와 같은 인라인 셸 할당을 구성하지 마십시오. - 요청된 워크플로우를 즉시 계속하십시오. 사용자가 다음 명령을 스스로 알아내도록 하지 마십시오.
제어 키 확인 후 광고주 온보딩:
# WAITSPIN_API_KEY는 호스트 도구의 env 필드에 의해 제공됩니다.
waitspin bid create --line "짧은 스폰서 라인" --url https://example.com --price-per-block 500 --blocks 1 --json
waitspin bids list --json
waitspin bid checkout CAMPAIGN_ID
게시자 또는 사용자 온보딩 후 publisher-extension 확인:
# WAITSPIN_API_KEY는 호스트 도구의 env 필드에 의해 제공됩니다.
waitspin install --all --dry-run --compose-existing --json
waitspin install --all --compose-existing --json
waitspin status --all --json
코드가 만료된 경우 새 코드를 요청하고 일시 중지를 반복하십시오. 코드를 추측하거나, 가짜로 만들거나, 다른 사용자의 코드를 재사용하거나, 사서함 접근을 요청하거나, 6자리가 아닌 코드를 수락하거나, 속도 제한에 대해 반복적으로 재시도하지 마십시오.
일반 워크플로우(Common Workflows)
온보딩 및 광고주 캠페인 생성(Onboard And Create Advertiser Campaigns)
사용자가 대기 상태 주목도를 구매하려는 경우 이 경로를 사용하십시오.
npx --yes [email protected] init --email [email protected] --key-profile control --json
npx --yes [email protected] init --email [email protected] --code 123456 --key-profile control --json
# WAITSPIN_API_KEY는 호스트 도구의 env 필드에 의해 제공됩니다.
waitspin bid create --line "짧은 스폰서 라인" --url https://example.com --price-per-block 500 --blocks 1 --json
waitspin bids list --json
waitspin bid checkout CAMPAIGN_ID
참고:
bid create는 초안 캠페인과 보류 중인 블록 구매를 생성합니다.- 체크아웃은 Stripe 결제가 서버 측에서 성공한 후에만 선불 인벤토리를 활성화합니다.
- HTTPS 대상 URL을 사용하십시오.
- 광고 라인을 짧고, 검사 가능하며, 개발자 도구 표면에 안전하게 유지하십시오.
사용자 수익 창출 표면 설치(Install User Earning Surfaces)
사용자가 지원되는 개발자 대기 상태로부터 수익을 얻고자 하는 경우 이 경로를 사용하십시오.
npx --yes [email protected] init --email [email protected] --key-profile publisher-extension --json
npx --yes [email protected] init --email [email protected] --code 123456 --key-profile publisher-extension --json
# WAITSPIN_API_KEY는 호스트 도구의 env 필드에 의해 제공됩니다.
waitspin install --all --dry-run --compose-existing --json
waitspin install --all --compose-existing --json
waitspin status --all --json
디버깅을 위해 일급 대상 명령어를 선호하십시오:
code --install-extension waitspin.waitspin-vscode
# WAITSPIN_API_KEY는 호스트 도구의 env 필드에 의해 제공됩니다.
waitspin extension install --target vscode --json
waitspin extension status --target vscode --json
waitspin claude-code install --compose-existing --json
waitspin claude-code status --json
waitspin antigravity install --compose-existing --json
waitspin antigravity status --json
waitspin copilot install --compose-existing --json
waitspin copilot status --json
waitspin mimocode install --json
waitspin mimocode status --json
waitspin opencode install --json
waitspin opencode status --json
waitspin grok install --json
waitspin grok status --json
waitspin qoder install --json
waitspin qoder status --json
대상 동작:
- VS Code: 일급 마켓플레이스 확장 기능 및 CLI 대체.
- Cursor: 동일한 확장 ID와
status-bar-fallbackAPI 대상을 사용하는 VS Code 호환 편집기 모드. - Devin Desktop: Open VSX 목록과 동일한
status-bar-fallbackAPI 대상을 사용하는 VS Code 호환 편집기 모드. - Claude Code: 공식
statusLine.command; 기존 상태 표시줄을 유지해야 하는 경우에만--compose-existing사용. - Antigravity CLI: 공식
statusLine.command; 기존 상태 표시줄을 유지해야 하는 경우에만--compose-existing사용. - GitHub Copilot CLI: 공식
statusLine.command; 기존 상태 표시줄을 유지해야 하는 경우에만--compose-existing사용. - MiMo Code: 관리되는 bash 훅 및 런타임.
- OpenCode: 관리되는 TUI 플러그인 슬롯.
- Grok Code CLI: 해시 기반 백업 및 복원이 있는 관리되는 텍스트 에셋 바닥글 패치.
- Qoder CLI: 공식
UserPromptSubmit훅(statusMessage/systemMessage포함) 및 이후 가시성 콜백을 위한 공식Stop훅. - 독립형 Cline CLI는 공개 설치 대상이 아닙니다. Cline VS Code 확장 사용자는 VS Code 호환 대상으로 처리되며, 다른 네이티브 CLI 대상은 별도로 홍보될 때까지 공개 설치 지침에서 제외됩니다.
지갑, 원장 및 지급 준비 상태 확인(Inspect Wallet, Ledger, And Payout Readiness)
waitspin wallet status --json
waitspin wallet ledger --limit 20 --json
waitspin wallet connect --country US --json
waitspin wallet payout --dry-run --json
해석:
wallet status및wallet ledger는wallet:read권한이 필요합니다. 최소 권한의 현재 키를 사용하십시오. 게시자 수익 읽기에는publisher-extension키가 적합합니다.wallet connect및wallet payout은 Connect/지급이 가능한 제어 자격 증명이 필요합니다.wallet connect는 허용될 때 Stripe Express 온보딩 링크를 반환합니다.- 드라이런 지급 출력은 준비 상태 미리보기이며, 실제 전송이 아닙니다.
공개 마켓 및 API 검색 읽기(Read Public Market And API Discovery)
waitspin market --json
curl -fsS https://api.waitspin.com/v1
curl -fsS https://waitspin.com/openapi/waitspin-api.openapi.json
공개 캠페인 리더보드 데이터에는 GET /v1/market을 사용하십시오. 요청 및 응답 형태는 추측하지 말고 OpenAPI 문서를 사용하십시오.
API 필수 사항(API Essentials)
| 메서드 | 경로 | 인증 | 용도 |
|---|---|---|---|
| POST | /v1/keys/request | 없음 | 이메일 OTP 요청 |
| POST | /v1/keys/verify | 없음 | OTP 확인 및 범위가 지정된 API 키 수신 |
| POST | /v1/list/subscribe | 없음 | 게시자 또는 창립 광고주 이메일 업데이트에 대한 더블 옵트인 |
| GET | /v1/market | 없음 | 공개 마켓 리더보드 |
| POST | /v1/campaigns | campaigns:write | 캠페인 초안 및 보류 중인 블록 구매 생성 |
| GET | /v1/campaigns | campaigns:read | 계정 캠페인 목록 |
| POST | /v1/blocks/checkout | blocks:purchase | Stripe Checkout URL 생성 또는 재사용 |
| POST | /v1/publishers/register | publishers:write | 지원되는 사용자 설치 등록 |
| POST | /v1/serve/next | serve:read | 다음 스폰서 메시지 가져오기 또는 204 수신 |
| POST | /v1/events/impression | events:write | 영수증이 있는 가시적 노출 기록 |
| GET | /v1/wallet/status | wallet:read | 잔액, Connect 상태 및 지급 자격 읽기 |
| POST | /v1/wallet/connect | connect:manage | Stripe Express 온보딩 링크 생성 또는 새로 고침 |
| GET | /v1/wallet/ledger | wallet:read | 전달, 취소, 보류 및 지급 원장 읽기 |
| POST | /v1/wallet/payouts | connect:manage | 미리보기 또는 보호된 테스트 지급 |
신뢰 경계(Trust Boundary)
WaitSpin 공개 클라이언트는 대기 상태 광고 가시성을 측정합니다. 작업 공간 파일, 소스 코드, 편집기 텍스트, 프롬프트, 모델 응답, 터미널 출력, 셸 히스토리, 리포지토리 URL, 스크린샷, 클립보드 내용 또는 원시 키 입력을 전송하지 않습니다. Qoder의 공식 훅 페이로드는 Qoder에 의해 로컬로 전달되며 프롬프트 또는 어시스턴트 메시지 필드를 포함할 수 있습니다. WaitSpin Qoder 런타임은 캐시 또는 API 작업 전에 해당 필드를 폐기합니다.
운영 페이로드는 게시자 등록, 서빙 폴링, 노출 영수증, 지갑/회계 흐름 및 속도 제한, 남용 대응, 사기 방지 및 감사 로그에 필요한 일반 네트워크 메타데이터로 제한됩니다.
오류 처리(Failure Handling)
/v1/serve/next의204는 빈 인벤토리를 의미합니다. 호스트 도구의 일반 UI를 유지하십시오.- 설치 프로그램 충돌은 대상별로 해결되어야 합니다. CLI가
--compose-existing와 같은 명시적 플래그를 제공하지 않는 한 관리되지 않는 로컬 구성을 덮어쓰지 마십시오. - 패키지 또는 설치 주장의 경우 로컬 워크스페이스 빌드에 의존하지 말고 새로운
npx --yes [email protected] ...명령어로 확인하십시오. - 공개 소스 또는 스킬 게시 주장의 경우
npx [email protected] add citedy/waitspin --skill waitspin --list로 확인하십시오.