Communitygithub.com

citedy/waitspin

WaitSpin 공개 클라이언트 소스, 신뢰 경계, OpenAPI 및 출처 정보입니다.

waitspin란 무엇인가요?

WaitSpin은 개발자의 대기 상태(wait-state)를 수익화하는 에이전트 우선 광고 마켓플레이스입니다. 광고주는 짧은 스폰서 라인을 구매하고, 사용자는 검증된 수익 창출 표면(earning surface)을 설치하여 표시되는 스폰서 대기 상태 메시지로부터 수익을 얻을 수 있습니다. 이 기술은 Claude Code, Cursor, VS Code, GitHub Copilot CLI 등 다양한 개발자 도구 및 플랫폼을 지원하며, 각 플랫폼에 맞는 공식 확장 기능이나 CLI 훅을 통해 통합됩니다. WaitSpin은 OTP 기반의 에이전트 주도 온보딩을 통해 광고주와 게시자 모두를 자동으로 등록하며, Stripe Checkout을 통한 결제와 지갑 기반 정산 시스템을 갖추고 있습니다. 신뢰 경계(trust boundary)를 명확히 정의하여 사용자의 작업 공간 파일, 소스 코드, 프롬프트 등 민감한 데이터는 수집하지 않으며, 오직 대기 상태 광고 가시성 측정에 필요한 최소한의 운영 데이터만 전송합니다.

지원 대상✓Claude Code~Codex CLI✓Cursor✓Antigravity✓OpenCode
npx skills add citedy/waitspin

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

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

문서

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자리 코드를 제공해야 합니다.

  1. 의도에 따라 키 프로필을 선택하십시오:
    • control: 광고주 캠페인, 체크아웃, Connect, 지급 준비 및 마켓 관리용.
    • publisher-extension: 사용자 수익 창출 표면 설치, 게시자 등록, 서빙 폴링, 노출 영수증 및 읽기 전용 지갑 상태/원장 확인용.
  2. 사용자가 이메일을 제공하지 않은 경우 CLI를 호출하기 전에 이메일 주소를 요청하십시오.
  3. 이메일을 사용하기 전에 일반 이메일 주소 형식인지 검증하십시오. OTP 코드는 정확히 6자리인지, 캠페인 ID는 예상되는 WaitSpin ID인지, 광고 URL은 HTTPS URL인지 검증하십시오.
  4. 구조화된 출력으로 코드를 요청하십시오. 다음을 리터럴 예제로 취급하고, 실제 사용자 이메일은 셸 문자열 내부의 텍스트를 대체하는 대신 호스트 도구의 구조화된 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
  1. 응답에 next: "enter_email_code"가 있는지 확인하십시오. 사용자에게 정확히 다음과 같이 알리십시오: I sent a 6-digit WaitSpin code to <email>. Reply with the code and I will continue. 그런 다음 중단하고 사용자를 기다리십시오.
  2. 사용자가 코드를 반환하면 동일한 이메일과 키 프로필로 코드를 확인하십시오. 실제 코드가 정확히 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
  1. JSON 응답을 파싱하십시오. api_key는 비밀로 유지하고 채팅에 표시하지 마십시오. 호스트 에이전트 비밀 저장소에 저장하거나 각 후속 명령에 대해 도구의 환경 필드를 통해 WAITSPIN_API_KEY로 전달하십시오. --api-key로 실제 API 키를 argv에 전달하거나 WAITSPIN_API_KEY='...' command와 같은 인라인 셸 할당을 구성하지 마십시오.
  2. 요청된 워크플로우를 즉시 계속하십시오. 사용자가 다음 명령을 스스로 알아내도록 하지 마십시오.

제어 키 확인 후 광고주 온보딩:

# 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-fallback API 대상을 사용하는 VS Code 호환 편집기 모드.
  • Devin Desktop: Open VSX 목록과 동일한 status-bar-fallback API 대상을 사용하는 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/campaignscampaigns:write캠페인 초안 및 보류 중인 블록 구매 생성
GET/v1/campaignscampaigns:read계정 캠페인 목록
POST/v1/blocks/checkoutblocks:purchaseStripe Checkout URL 생성 또는 재사용
POST/v1/publishers/registerpublishers:write지원되는 사용자 설치 등록
POST/v1/serve/nextserve:read다음 스폰서 메시지 가져오기 또는 204 수신
POST/v1/events/impressionevents:write영수증이 있는 가시적 노출 기록
GET/v1/wallet/statuswallet:read잔액, Connect 상태 및 지급 자격 읽기
POST/v1/wallet/connectconnect:manageStripe Express 온보딩 링크 생성 또는 새로 고침
GET/v1/wallet/ledgerwallet:read전달, 취소, 보류 및 지급 원장 읽기
POST/v1/wallet/payoutsconnect: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로 확인하십시오.

관련 스킬