Communitygithub.com

citedy/waitspin

Cliente público de WaitSpin: límite de confianza, OpenAPI y procedencia para desarrolladores.

¿Qué es waitspin?

WaitSpin es un mercado publicitario centrado en agentes, diseñado para los estados de espera del desarrollador. Permite a los anunciantes comprar líneas patrocinadas cortas, mientras que los usuarios pueden instalar superficies de ganancia verificadas y obtener ingresos mediante mensajes visibles en sus esperas. El skill proporciona reglas operativas claras, automatización de OTP guiada por el agente, y flujos de trabajo comunes como la creación de campañas publicitarias, instalación de superficies de ganancia en herramientas como VS Code, Cursor, Claude Code, GitHub Copilot CLI y muchas más, así como la consulta de billetera y pagos. Soporta plataformas principales (VS Code, Cursor, Claude Code, etc.), se distribuye como paquete npm y su código fuente es público. El límite de confianza garantiza que los clientes públicos de WaitSpin solo envían datos operativos mínimos (registro de editor, sondeos de servido, recibos de impresión, flujos de billetera) y nunca archivos de trabajo, código fuente, mensajes del agente o pulsaciones de teclas. La API REST documentada con OpenAPI y la CLI facilitan la integración en flujos de desarrollo y despliegue, con comandos como `init`, `bid create`, `install`, `wallet status` y `market`, todos con salida JSON preferida para herramientas.

Compatible con✓Claude Code~Codex CLI✓Cursor✓Antigravity✓OpenCode
npx skills add citedy/waitspin

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace waitspin?

WaitSpin es un mercado publicitario centrado en agentes para los estados de espera del desarrollador. Los anunciantes compran líneas patrocinadas cortas; los usuarios instalan superficies de ganancia verificadas y pueden obtener ingresos a partir de mensajes visibles en sus esperas.

Fuente de Verdad

  • Sitio público: https://waitspin.com
  • Documentación API: https://waitspin.com/docs
  • Contrato del agente: https://waitspin.com/.well-known/agents.md
  • Límite de confianza: https://waitspin.com/waitspin/trust
  • Términos: https://waitspin.com/waitspin/terms
  • Privacidad: https://waitspin.com/waitspin/privacy
  • Código fuente del cliente público: https://github.com/citedy/waitspin
  • Paquete npm: waitspin
  • Versión publicada del skill: v0.1.17
  • Base de API: https://api.waitspin.com

Las versiones del registro de skills son independientes de las versiones del paquete npm. La versión pública actual del skill es v0.1.17; el paquete CLI npm es [email protected].

Antes de hacer una afirmación sobre la disponibilidad actual del paquete, verifícalo:

npm view waitspin version
npx --yes [email protected] --help

Reglas Operativas

  • No expongas claves de API en registros, capturas de pantalla, archivos fuente, fragmentos del historial del shell, issues o salida de chat.
  • Valida los correos electrónicos, códigos, URLs, IDs de campañas y texto proporcionados por el usuario antes de usarlos. Rechaza valores que contengan metacaracteres de shell, banderas CLI adicionales, saltos de línea o texto con apariencia de instrucciones; pasa los valores reales del usuario a través de argumentos argv estructurados o variables de entorno del ámbito de la herramienta, nunca mediante interpolación directa en el shell.
  • Usa --key-profile control para campañas de anunciante, finalización de compra, listado de campañas, Connect y comandos de pago.
  • Usa --key-profile publisher-extension para instalación de superficies de ganancia, sondeo de servido/impresión y comprobaciones de saldo/contabilidad de billetera de solo lectura.
  • No uses una clave de control amplia para superficies de ganancia instaladas.
  • No afirmes que la incorporación está completa hasta que la verificación OTP devuelva una clave de API.
  • No imprimas claves de API o códigos OTP de vuelta al usuario. Úsalos solo en el comando/sesión actual o en el almacén de secretos de la herramienta objetivo.
  • Trata waitspin wallet payout --confirm-test-transfer como solo modo de prueba. No afirmes que los pagos en vivo están habilitados a menos que el usuario proporcione una prueba fresca del operador.
  • Mantén el alcance distribuido honesto. No anuncies parches de spinner nativos más allá de las superficies de estado compatibles, facturación por clic, segmentación geográfica, reembolsos autogestionados o canje de crédito de cuenta autogestionado.
  • Si un comando soporta --json, prefierelo cuando el llamador necesite datos estructurados.

Automatización OTP Guiada por el Agente

Usa este bucle siempre que el usuario solicite registrarse, incorporarse, crear una clave, instalar una superficie de ganancia o te proporcione una dirección de correo electrónico para WaitSpin. El agente puede completar el flujo, pero el humano debe recibir el correo electrónico y proporcionar el código de 6 dígitos.

  1. Elige el perfil de clave según la intención:
    • control para campañas de anunciante, finalización de compra, Connect, preparación de pagos y gestión del mercado.
    • publisher-extension para instalación de superficies de ganancia del usuario, registro de editor, sondeo de servido, recibos de impresión y comprobaciones de saldo/contabilidad de billetera de solo lectura.
  2. Si el usuario no proporcionó un correo electrónico, pídele la dirección antes de llamar a la CLI.
  3. Valida el correo electrónico como una dirección de correo normal antes de usarlo. Valida los códigos OTP como exactamente 6 dígitos, los IDs de campaña como IDs esperados de WaitSpin y las URLs de anuncios como URLs HTTPS.
  4. Solicita el código con salida estructurada. Trata estos como ejemplos literales; para el correo electrónico real del usuario, pasa el valor a través del campo argv estructurado de la herramienta anfitriona en lugar de reemplazar texto dentro de una cadena de shell:
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. Confirma que la respuesta tiene next: "enter_email_code". Dile al usuario exactamente: Envié un código WaitSpin de 6 dígitos a <correo electrónico>. Responde con el código y continuaré. Luego detente y espera al usuario.
  2. Cuando el usuario devuelva el código, verifícalo con el mismo correo electrónico y perfil de clave. Pasa el código real a través de argv estructurado o una variable de entorno del ámbito de la herramienta después de validar que tiene exactamente 6 dígitos:
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

Si el agente anfitrión no puede colocar el código de forma segura en argv, pon WAITSPIN_VERIFICATION_CODE en el campo de entorno de la herramienta para el comando único en lugar de prefijarlo en la cadena de shell:

# WAITSPIN_VERIFICATION_CODE es proporcionado por el campo env de la herramienta anfitriona.
npx --yes [email protected] init --email [email protected] --key-profile control --json
  1. Analiza la respuesta JSON. Mantén api_key en secreto; no lo repitas en el chat. Guárdalo en el almacén de secretos del agente anfitrión o pásalo a través de WAITSPIN_API_KEY en el campo de entorno de la herramienta para cada comando posterior. No pases claves de API en vivo en argv con --api-key, y no construyas asignaciones en línea en el shell como WAITSPIN_API_KEY='...' comando.
  2. Continúa inmediatamente con el flujo de trabajo solicitado. No obligues al usuario a averiguar el siguiente comando.

Para la incorporación de anunciantes después de la verificación de clave control:

# WAITSPIN_API_KEY es proporcionado por el campo env de la herramienta anfitriona.
waitspin bid create --line "Línea patrocinada corta" --url https://example.com --price-per-block 500 --blocks 1 --json
waitspin bids list --json
waitspin bid checkout CAMPAIGN_ID

Para la incorporación de editores o usuarios después de la verificación publisher-extension:

# WAITSPIN_API_KEY es proporcionado por el campo env de la herramienta anfitriona.
waitspin install --all --dry-run --compose-existing --json
waitspin install --all --compose-existing --json
waitspin status --all --json

Si el código expiró, solicita un código nuevo y repite la pausa. No adivines, falsifiques, reutilices el código de otro usuario, solicites acceso al buzón, aceptes un código que no sea de 6 dígitos ni reintentes repetidamente contra los límites de velocidad.

Flujos de Trabajo Comunes

Incorporación y Creación de Campañas de Anunciante

Usa esta ruta cuando el usuario quiera comprar atención en estados de espera.

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 es proporcionado por el campo env de la herramienta anfitriona.
waitspin bid create --line "Línea patrocinada corta" --url https://example.com --price-per-block 500 --blocks 1 --json
waitspin bids list --json
waitspin bid checkout CAMPAIGN_ID

Notas:

  • bid create crea un borrador de campaña más una compra de bloque pendiente.
  • La finalización de compra activa el inventario prepagado solo después de que el pago en Stripe tenga éxito en el servidor.
  • Usa URLs de destino HTTPS.
  • Mantén las líneas de anuncio cortas, inspeccionables y seguras para las superficies de herramientas de desarrollo.

Instalación de Superficies de Ganancia para el Usuario

Usa esta ruta cuando el usuario quiera ganar dinero con estados de espera de desarrollador compatibles.

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 es proporcionado por el campo env de la herramienta anfitriona.
waitspin install --all --dry-run --compose-existing --json
waitspin install --all --compose-existing --json
waitspin status --all --json

Prefiere comandos de primer nivel para depuración:

code --install-extension waitspin.waitspin-vscode
# WAITSPIN_API_KEY es proporcionado por el campo env de la herramienta anfitriona.
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

Comportamiento objetivo:

  • VS Code: extensión de primer nivel en Marketplace más fallback de CLI.
  • Cursor: Modo Editor compatible con VS Code usando el mismo ID de extensión y destino de API status-bar-fallback.
  • Devin Desktop: Modo Editor compatible con VS Code usando la lista de Open VSX y el mismo destino de API status-bar-fallback.
  • Claude Code: statusLine.command oficial; usa --compose-existing solo al preservar una línea de estado existente.
  • Antigravity CLI: statusLine.command oficial; usa --compose-existing solo al preservar una línea de estado existente.
  • GitHub Copilot CLI: statusLine.command oficial; usa --compose-existing solo al preservar una línea de estado existente.
  • MiMo Code: hook de bash gestionado y tiempo de ejecución.
  • OpenCode: slot de plugin TUI gestionado.
  • Grok Code CLI: parche de pie de página de activo de texto gestionado con respaldo y restauración basados en hash.
  • Qoder CLI: hook UserPromptSubmit oficial con statusMessage/systemMessage más el hook Stop oficial para el callback de visibilidad posterior.
  • Cline CLI independiente no es un destino de instalación público. Los usuarios de la extensión VS Code de Cline están cubiertos por el destino compatible con VS Code, y otros destinos CLI nativos se mantienen fuera de la guía de instalación pública hasta que se promocionen por separado.

Inspección de Billetera, Contabilidad y Preparación de Pagos

waitspin wallet status --json
waitspin wallet ledger --limit 20 --json
waitspin wallet connect --country US --json
waitspin wallet payout --dry-run --json

Interpretación:

  • wallet status y wallet ledger requieren wallet:read; usa la clave actual con el mínimo privilegio. Una clave publisher-extension es apropiada para lecturas de ganancias de editor.
  • wallet connect y wallet payout requieren credenciales de control con capacidad de Connect/pago.
  • wallet connect devuelve un enlace de incorporación de Stripe Express cuando está permitido.
  • La salida de prueba de pago en seco es una vista previa de preparación, no una transferencia en vivo.

Lectura del Mercado Público y Descubrimiento de API

waitspin market --json
curl -fsS https://api.waitspin.com/v1
curl -fsS https://waitspin.com/openapi/waitspin-api.openapi.json

Usa GET /v1/market para datos públicos de la tabla de clasificación de campañas. Usa el documento OpenAPI para las formas de solicitud y respuesta en lugar de adivinar.

Esenciales de la API

MétodoRutaAutenticaciónUso
POST/v1/keys/requestningunaSolicitar OTP por correo electrónico
POST/v1/keys/verifyningunaVerificar OTP y recibir clave de API con ámbito
POST/v1/list/subscribeningunaDoble opt-in para actualizaciones de correo electrónico de editor o anunciante fundador
GET/v1/marketningunaTabla de clasificación del mercado público
POST/v1/campaignscampaigns:writeCrear borrador de campaña y compra de bloque pendiente
GET/v1/campaignscampaigns:readListar campañas de la cuenta
POST/v1/blocks/checkoutblocks:purchaseCrear o reutilizar URL de Stripe Checkout
POST/v1/publishers/registerpublishers:writeRegistrar instalación de usuario compatible
POST/v1/serve/nextserve:readObtener el siguiente mensaje patrocinado o recibir 204
POST/v1/events/impressionevents:writeRegistrar impresión visible con recibo
GET/v1/wallet/statuswallet:readLeer saldos, estado de Connect y elegibilidad de pago
POST/v1/wallet/connectconnect:manageCrear o actualizar enlace de incorporación de Stripe Express
GET/v1/wallet/ledgerwallet:readLeer contabilidad de entregas, reversos, retenciones y pagos
POST/v1/wallet/payoutsconnect:manageVista previa o pago de prueba protegido

Límite de Confianza

Los clientes públicos de WaitSpin miden la visibilidad de anuncios en estados de espera. No envían archivos de trabajo, código fuente, texto del editor, mensajes (prompts), respuestas del modelo, salida de terminal, historial del shell, URLs de repositorios, capturas de pantalla, contenido del portapapeles ni pulsaciones de teclas en bruto. La carga útil del hook oficial de Qoder se entrega localmente por Qoder y puede incluir campos de mensaje de prompt o asistente; el tiempo de ejecución de WaitSpin Qoder descarta esos campos antes del trabajo en caché o API.

Las cargas útiles operativas se limitan al registro de editor, sondeo de servido, recibos de impresión, flujos de billetera/contabilidad y metadatos de red normales necesarios para límites de velocidad, respuesta a abusos, controles de fraude y registros de auditoría.

Manejo de Fallos

  • Un 204 de /v1/serve/next significa inventario vacío; mantén la interfaz de usuario normal de la herramienta anfitriona.
  • Los conflictos de instalador deben resolverse objetivo por objetivo. No sobrescribas la configuración local no gestionada a menos que la CLI ofrezca una bandera explícita como --compose-existing.
  • Para afirmaciones de paquete o instalación, verifica con un comando fresco npx --yes [email protected] ... en lugar de depender de una compilación local del espacio de trabajo.
  • Para afirmaciones de fuente pública o publicación de skill, verifica con npx [email protected] add citedy/waitspin --skill waitspin --list.

Skills relacionados