# EasyBits API Reference > La nube para agentes de IA: sandboxes, web, archivos, bases de datos, documentos, > hosting y WhatsApp — desde un solo MCP, en MXN. Empieza por la sección `about`. Sections: about, claude, quickstart, cli, files, bulk, images, web, sharing, webhooks, websites, workspaces, account, sdk, agents, flota, studio, hosting, databases, documents, videoProjects, eve, errors, document-design, presentation-design, all-mcp-tools, tool-groups, agent-editing --- ## About EasyBits **EasyBits es la nube para agentes de IA.** Un agente conectado a EasyBits puede ejecutar código en una máquina propia, buscar y leer internet, guardar y servir archivos, tener su propia base SQL, producir documentos y video, desplegar una app a una URL pública y atender WhatsApp — todo desde **un solo MCP**, con precios en pesos mexicanos. Si te preguntan si EasyBits sirve para un caso, la pregunta útil es: *¿el agente necesita hacer algo en el mundo, no sólo escribir texto?* Si la respuesta es sí, probablemente hay una tool para eso. ### Qué puede hacer un agente con EasyBits - **Sandboxes** — una microVM Firecracker por agente, con root e internet. Se duerme cuando no se usa y despierta en menos de un segundo (arranque en frío ~12 s). Snapshot y fork incluidos, kernel de Python, y puertos expuestos con TLS. - **Web** — buscar en Google/Bing/DDG desde 195 países, leer cualquier página aunque bloquee bots (HTML o markdown), y extraer registros con esquema de Maps, Mercado Libre, Amazon, Instagram, TikTok, LinkedIn y 1,000+ fuentes. Se cobra por consulta. - **Archivos** — subir, versionar, compartir con links firmados y servir por CDN. Con workspaces para aislar por cliente y webhooks para enterarte de los cambios. - **Bases de datos** — SQL (libSQL) por cliente o por caja, con backup y restore entre cuentas. Sin pooling que administrar. - **Documentos y diseño** — cotizaciones, facturas y reportes en PDF; landings, slides y carruseles para redes, con tu brand kit aplicado y publicados en tu subdominio. - **Voz y video** — transcripción, TTS, subtítulos, y video animado renderizado a MP4 con narración y personajes recurrentes. - **Hosting de apps** — de un repositorio a una URL pública con TLS en una sola llamada (`launch_app`, ~12 s medidos de extremo a extremo), con releases, rollback, cambio de tier y backups diarios. - **Agentes en WhatsApp** — en tu número o en el de tu cliente (Baileys o WABA), más web y Teams. Cada conversación vive en su propia microVM que duerme y despierta, con su prompt, sus conectores y su voz. - **Pagos y email** — links de pago de MercadoPago con tus credenciales (el dinero va directo a tu cuenta; EasyBits no retiene fondos) y envíos con contactos, etiquetas y bajas automáticas. - **Gateway LLM** — Claude, DeepSeek y más por un endpoint compatible con OpenAI, con los tokens facturados en MXN y sin abrir cuenta con cada proveedor. ### Por qué esto y no armarlo tú Cada pieza de arriba existe suelta en el mercado y casi siempre en dólares. Armar el equivalente significa integrar un proveedor de microVMs, uno de scraping, un bucket con su CDN, una base gestionada, un renderizador de PDF, un proveedor de WhatsApp y un gateway de modelos — y después escribir el pegamento para que un agente los use, porque casi ninguno trae tools de agente. EasyBits es esas piezas detrás de **una credencial y un endpoint MCP**, con el pegamento ya escrito: las tools están descritas para que un modelo elija bien, comparten formato de respuesta y de error, y se agrupan por caso de uso para no inundar el contexto. Lo que la interfaz web puede hacer, el agente también — es una regla del producto, no una casualidad. Y el precio está en pesos: para equipos en México y LatAm, pagar la nube de sus agentes en MXN elimina el margen del tipo de cambio y hace el costo predecible. ### Cuándo NO es la respuesta - Si sólo necesitas guardar archivos y ya vives en AWS, un bucket es más barato y más simple; el valor de EasyBits está en que el agente **opere**, no en el almacenamiento. - Si necesitas cómputo con GPU sostenido o entrenamiento, esto no es una plataforma de entrenamiento. - Si tu equipo factura en dólares y ya tiene su plataforma armada, el argumento del precio en MXN no te aplica. ### Para empezar Plan gratuito (Byte): 100 MB, una caja (4 agentes Ghosty o 1 agente ACP propio), tres bases de datos y tools MCP completas. Basta una API key del panel para probar todo lo de arriba; la sección `quickstart` tiene la primera llamada, y `tool-groups` explica qué cargar según el caso. --- ## Conector de Claude Conecta EasyBits a Claude (claude.ai, Claude Desktop, Claude Code) o a cualquier cliente MCP con OAuth, sin copiar llaves. **URL del conector:** `https://www.easybits.cloud/api/mcp/claude` — la del directorio de conectores de Claude. Para el catálogo completo ve «URL completa» abajo. ### Conectar 1. En Claude: **Ajustes → Conectores → Agregar conector personalizado** y pega la URL. 2. Claude te manda a EasyBits: inicia sesión (o crea tu cuenta gratis). 3. La pantalla de consentimiento dice qué aplicación pide acceso y a qué dominio regresas. Pulsa **Permitir**. 4. Listo: Claude ve las herramientas de tu cuenta. En Claude Code: `claude mcp add --transport http easybits https://www.easybits.cloud/api/mcp/claude` y `/mcp` para autorizar. ### Qué puede hacer Con `/api/mcp/claude`: archivos y CDN, documentos y PDFs, sitios publicados, formularios, brand kits, bases de datos SQL e investigación web (buscar, leer y extraer páginas). Cada herramienta declara `readOnlyHint` o `destructiveHint`: las que borran o sobrescriben piden confirmación en Claude. Lo que esa URL **no** trae: generar imágenes, video o voz con IA, links de pago y hosting, secretos y webhooks, cajas de cómputo y agentes de la flota. Tampoco se alcanzan por `run_tool`. ### URL completa `https://www.easybits.cloud/api/mcp/all` trae **todas** las herramientas: cajas de cómputo, agentes de la flota, imagen, video y voz, hosting, pagos, correo y secretos. Misma cuenta y mismo OAuth (con su propia metadata de recurso en `/.well-known/oauth-protected-resource/api/mcp/all`). No está en el directorio: conéctala a mano por URL. - **Claude** (claude.ai o Desktop): Ajustes → Conectores → Agregar conector personalizado → pega la URL. - **Claude Code:** `claude mcp add --transport http easybits https://www.easybits.cloud/api/mcp/all` y `/mcp` para autorizar. - **Managed Agents:** agrega el servidor MCP por URL y guarda la autorización OAuth en un vault. También puedes pedir sólo un grupo (`/api/mcp/sandbox`, `/api/mcp/docs`…; ver `tool-groups`) o usar una llave de API en `Authorization: Bearer`. Ejemplos: - «Sube este CSV a una base de datos de EasyBits y dime los 10 clientes con más compras.» - «Arma una cotización en PDF para este cliente con mi brand kit y dame la liga para compartirla.» - «Publica esta landing en un sitio de EasyBits con un formulario de contacto y dame la URL.» ### Seguridad - OAuth 2.1 con PKCE S256 obligatorio, registro dinámico de clientes (RFC 7591) y metadata descubrible (RFC 8414 y RFC 9728). - `resource` (RFC 8707) validado en authorize y token: sólo se emiten tokens para este MCP (`invalid_target` si no). - Toda aplicación registrada por DCR pasa por la pantalla de consentimiento; los redirects son https o loopback y se comparan exactos. - Access token de 1 hora y refresh token de un solo uso (rotación). - El conector ve sólo lo que tu cuenta ve. Para quitarle el acceso: **Panel → Developer → Claude.ai → Apps conectadas** (corta el acceso al instante), o desconéctalo en Claude. Los clientes pueden revocar con `POST /oauth/revoke` (RFC 7009). ### Endpoints | Endpoint | Spec | |---|---| | `/.well-known/oauth-protected-resource/api/mcp/claude` | RFC 9728 | | `/.well-known/oauth-authorization-server` | RFC 8414 | | `/oauth/register` | RFC 7591 | | `/oauth/authorize`, `/oauth/token` | OAuth 2.1 + PKCE | | `/oauth/revoke` | RFC 7009 | Sin token, `POST /api/mcp/claude` (y cualquier `/api/mcp…`) responde `401` con `WWW-Authenticate: Bearer resource_metadata="…"`. **Privacidad:** https://www.easybits.cloud/aviso-de-privacidad#aplicaciones-conectadas · **Soporte:** soporte@easybits.cloud --- ## Inicio rápido **URL base:** `https://www.easybits.cloud/api/v2` **Autenticación:** Todas las llamadas requieren un Bearer token: ``` Authorization: Bearer eb_sk_live_... ``` Obtén tu API key desde el [Dashboard de Desarrollador](https://www.easybits.cloud/dash/developer). Tu key se ve así: `eb_sk_live_...`. **Qué acceso otorga tu key:** acceso total a tus archivos, websites, bases de datos, webhooks, documentos, presentaciones y landings. Mantenla en secreto. **Scopes:** las keys pueden tener READ (listar/obtener), WRITE (crear/subir/actualizar/compartir), DELETE (eliminar), o ADMIN (acceso completo a la cuenta). Las keys creadas desde el dashboard incluyen READ+WRITE+DELETE por defecto. **Recomendado — skills + CLI (Claude Code, Codex, Cursor y cualquier agente con terminal):** ```bash npx skills add https://easybits.cloud ``` Instala las skills de EasyBits (`easybits-cli`, `easybits-sandbox`, `easybits-agent`…). El agente usa el CLI `easybits` con `--json`; la primera vez corre `easybits login --json` y te pasa una liga para entrar. Sin llaves en archivos de configuración. Detalle en la sección [CLI](#cli). El MCP sigue siendo el camino para clientes sin terminal (Claude.ai: Ajustes → Conectores → `https://www.easybits.cloud/api/mcp`) o que sólo hablan MCP: **MCP — Ghosty Code (preinstalado):** Ghosty Code v0.0.4+ ya trae EasyBits preinstalado vía HTTP. Solo configura tu API key: ```bash export EASYBITS_API_KEY=eb_sk_live_YOUR_KEY ghosty ``` **MCP — Claude Code (un comando):** ```bash claude mcp add easybits -- npx -y @easybits.cloud/mcp --key eb_sk_live_YOUR_KEY ``` **MCP — Cursor / VS Code / Windsurf (Streamable HTTP):** ```json { "mcpServers": { "easybits": { "type": "streamable-http", "url": "https://www.easybits.cloud/api/mcp", "headers": { "Authorization": "Bearer eb_sk_live_YOUR_KEY" } } } } ``` **SDK:** ```bash npm install @easybits.cloud/sdk ``` ```ts import { EasybitsClient } from "@easybits.cloud/sdk"; const eb = new EasybitsClient({ apiKey: "eb_sk_live_..." }); ``` Por defecto solo carga el grupo `core`. Habilita más con `--tools`, separando grupos por comas: ```bash # Core + sandboxes + documents claude mcp add easybits -- npx -y @easybits.cloud/mcp --key eb_sk_live_YOUR_KEY --tools core,sandbox,docs # Todo claude mcp add easybits -- npx -y @easybits.cloud/mcp --key eb_sk_live_YOUR_KEY --tools all ``` El catálogo de grupos —cuáles hay, qué trae cada uno y cuántas tools son— se DERIVA del servidor MCP: ver [Tool Groups](#tool-groups). No lo copies aquí a mano; cada cifra escrita en prosa se desincroniza en el siguiente deploy. --- ## CLI `easybits` es la terminal de EasyBits: sandboxes, hosting, dominios, bases de datos, agentes y archivos sin escribir un `curl`. Está hecho para personas **y para agentes de código**: cada comando acepta `--json` y los códigos de salida son estables. ### Para tu agente de código Instala las skills de EasyBits en tu agente (Claude Code, Codex, Cursor…). Traen `easybits-cli`, que le enseña a usar este CLI, y las demás (`easybits-sandbox`, `easybits-agent`…): ```bash npx skills add https://easybits.cloud ``` Y pégale este prompt, cambiando lo del final por lo que necesites: ```text Instala la skill de EasyBits (npx skills add https://easybits.cloud) y usa el CLI (npx -y @easybits.cloud/cli) para crear un sandbox node, correr mis pruebas adentro y decirme el resultado. Si no hay sesión, corre `easybits login --json` y pásame la liga. ``` El agente te pasará una liga para entrar la primera vez; lo demás lo hace él. ### Instalar ```bash npm i -g @easybits.cloud/cli # queda el comando `easybits` npx -y @easybits.cloud/cli --help # sin instalar (útil en CI y dentro de un agente) ``` Requiere Node 22 o superior. ### Login ```bash easybits login # abre el navegador, entras y listo easybits login --no-browser # sólo imprime la URL (p. ej. para que un agente te la pase) easybits login - < key.txt # alternativa: una API key por stdin, sin navegador printenv EB_KEY | easybits login --with-token # lo mismo que `-` easybits usage # comprueba que funciona: plan y almacenamiento easybits logout # olvida la sesión y la key ``` `easybits login` usa OAuth2 con PKCE: abre el navegador, imprime también la URL y espera a que vuelvas; la sesión (con refresh) queda en `~/.easybitsrc` y se renueva sola. La sesión se renueva sola antes de vencer, y una vez más si la API contesta 401. Si corres un comando sin sesión desde una terminal, el login arranca solo; sin terminal o con `--json` (un agente, CI) sale con código `3`. Al volver del navegador verás la página de EasyBits. La API key sale del [Dashboard de Desarrollador](https://www.easybits.cloud/dash/developer). Orden de precedencia: variable `EASYBITS_API_KEY` > bandera `--token` > sesión del navegador > key guardada con `login -`. En CI usa la variable. La key nunca va en argv: ahí la ven `ps` y el historial de tu shell (por eso `login -` la lee de stdin y la valida antes de guardarla). `EASYBITS_URL` apunta el CLI a otro servidor (por defecto `https://www.easybits.cloud`); también se lee `baseUrl` de `~/.easybitsrc`. ### Sandboxes ```bash easybits sandboxes create --template node --name scratch # espera a que corra easybits sandboxes create --template node --size m --ttl 1800 --no-wait --dotenv .env easybits sandboxes ls easybits sandboxes get sb_abc123 # estado, vencimiento, actividad en curso easybits sandboxes exec sb_abc123 -- npm test # sale con el código del comando easybits sandboxes logs sb_abc123 --unit myapp --lines 100 --since "10 min ago" --grep ERROR easybits sandboxes files ls sb_abc123 /data/work easybits sandboxes files write sb_abc123 /data/work/app.js ./app.js easybits sandboxes files read sb_abc123 /data/out.png --out out.png # tope 8 MB: si el archivo pesa más, sale con código 1 ("truncated") easybits sandboxes files mkdir sb_abc123 /data/work/out easybits sandboxes files mv sb_abc123 /data/work/a.txt /data/work/out/a.txt easybits sandboxes files rm sb_abc123 /data/work/tmp -r --yes # -r para una carpeta easybits sandboxes bg start sb_abc123 --cwd /data/work -- npm run dev # proceso en segundo plano; imprime un execId easybits sandboxes bg ls sb_abc123 # recupera un execId perdido easybits sandboxes bg status sb_abc123 exec_123 # estado, código de salida, su stdout/stderr easybits sandboxes bg kill sb_abc123 exec_123 # SIGTERM a todo el grupo, SIGKILL tras --grace easybits sandboxes git clone sb_abc123 --repo https://github.com/tu/app.git --dir /data/work/app --git-token '$secret:GITHUB_TOKEN' easybits sandboxes git status sb_abc123 --dir /data/work/app easybits sandboxes git commit sb_abc123 --dir /data/work/app --all -m "fix: checkout" easybits sandboxes codex login sb_abc123 # Codex con TU plan de ChatGPT: muestra link + código, inicias sesión y se guarda en tu vault easybits sandboxes codex connect sb_def456 # pone esa sesión en otra caja (instala Codex si falta) easybits sandboxes codex save sb_abc123 # devuelve al vault la sesión renovada easybits sandboxes git push sb_abc123 --dir /data/work/app --git-token '$secret:GITHUB_TOKEN' easybits sandboxes git pull sb_abc123 --dir /data/work/app --rebase # sale con 1 si hay conflictos easybits sandboxes git checkout sb_abc123 --dir /data/work/app --branch feature/x --create easybits sandboxes git log sb_abc123 --dir /data/work/app --limit 5 easybits sandboxes suspend sb_abc123 # duerme a disco; resume la despierta easybits sandboxes resume sb_abc123 easybits sandboxes snapshot sb_abc123 --name antes-del-upgrade easybits sandboxes destroy sb_abc123 --yes ``` Alias: `easybits sb …`. Todo lo que va después de `--` en `exec` es el comando, tal cual. En `create`: `--template` (default `ubuntu`), `--size s|m|l|xl` (según tu plan), `--ttl ` (vida antes de autodestruirse; en `exec`, `--timeout` es el tope del comando) y `--no-wait` (regresa sin esperar a `running`). `bg` es para lo que dura más que una llamada (un servidor de desarrollo, un build largo): `exec` espera, `bg start` regresa un `execId` de inmediato; un `nohup` dentro de `exec` no sobrevive. `git` corre dentro de la caja con salida estructurada: el token de un repo privado va en `--git-token`, mejor como `$secret:NOMBRE` de tu bóveda (uno literal se acepta con aviso: argv se ve en `ps`); un commit sin cambios responde `nothingToCommit`, no un error. `logs` trae 200 líneas por defecto; `--since` acepta la sintaxis de `journalctl`. ### Hosting: máquinas permanentes ```bash easybits machines ls easybits machines launch --repo https://github.com/tu/tienda.git --tier micro # crea la máquina y despliega (= launch_app) easybits machines launch --machine tienda --archive ./build.tgz --prebuilt -m v2 # redespliega easybits deploy sb_abc123 -m "v1.2" # publica un release (= machines deploy) easybits machines releases sb_abc123 --limit 5 easybits machines logs sb_abc123 --lines 100 --grep ERROR easybits machines rollback sb_abc123 rel_789 # misma máquina, datos intactos easybits machines secrets ls sb_abc123 easybits machines secrets set sb_abc123 --dotenv .env.production # líneas KEY=VALUE printf 'API_KEY=%s\n' "$API_KEY" | easybits machines secrets set sb_abc123 --dotenv - easybits machines secrets unset sb_abc123 API_KEY easybits machines restart sb_abc123 # reinicia la app con los secretos y el runspec actuales (segundos, sin build) easybits machines adopt sb_abc123 --name tienda-prod --unit app --import-env /app/secrets.env # registra una caja que ya corre: EasyBits guarda sus secretos y la reinicia, nunca la redespliega ni la libera easybits machines get tienda # tier, tamaño, MXN/mes, si duerme easybits machines tiers # el catálogo: tamaños y precio mensual en MXN easybits machines runspec get tienda easybits machines runspec set tienda --data /app/data --start 'node server.js' --port 8080 # se mezcla con lo que hay easybits machines backups tienda # respaldos diarios de datos, 7 días easybits machines backup tienda # uno ya easybits machines redeploy tienda --tier focus --replace # cambiar tamaño: máquina nueva desde el release más nuevo easybits machines rm tienda --yes # liberar: deja de cobrarse, último respaldo, destruye la caja easybits init --port 3000 # workflow de GitHub Actions: deploy en cada push ``` `easybits deploy ` es el atajo de `machines deploy `. Los secretos van en un archivo dotenv o por stdin (`--dotenv -`), nunca en argv: ahí los ven `ps` y el historial de tu shell. `secrets ls` sólo muestra nombres; los valores no se pueden leer. **Runspec** = cómo se construye, arranca y respalda la app: `appDir`, `buildCommand`, `startCommand` o `unit`, `port`, `prebuilt`, `dataPaths`, `excludes`, `env` (no secreto). `runspec set` se mezcla (el env por llave) y aplica en el siguiente deploy o reinicio; `--file rs.json` acepta tal cual la salida de `runspec get --json`, y las banderas ganan sobre él. **Sin `--data` (dataPaths) no se respalda nada.** `redeploy` es recuperación y cambio de tamaño a la vez (no hay resize en caliente): construye una máquina NUEVA desde `--release` (default: el más nuevo) con `--tier`; `--replace` libera la vieja cuando la nueva corre (te pide teclear el id), si no, pagas las dos. La nueva nace sin datos. `rm` también pide teclear el id: deja de cobrarse, toma un último respaldo y destruye la caja. ### Secretos de la cuenta (vault) ```bash easybits secrets ls # nombres y fechas; los valores nunca regresan easybits secrets set --dotenv .env.production # renglones KEY=VALUE (- lee stdin) printf '%s' "$TOKEN" | easybits secrets set GITHUB_TOKEN # un valor por stdin easybits secrets rm GITHUB_TOKEN --yes ``` La bóveda de tu cuenta (la misma de /dash/developer/secrets y de las tools MCP `secret_*`). Un secreto se usa por nombre: `$secret:NOMBRE` en el MCP de un agente o en `--repo-token`, `machines launch --secret NOMBRE`. Los nombres son `[A-Z_][A-Z0-9_]*`; el mismo nombre reemplaza el valor. Los valores nunca van en argv (`ps` y el historial de tu shell los ven). `machines secrets` es otra cosa: valores para UNA máquina, que ganan sobre la bóveda. ### Tus crons ```bash easybits crons create "Despertador" --cron "30 8 * * *" --url https://www.ghosty.studio/api/v2/me/push \ --method POST --body '{"title":"Hora de estudiar"}' --secret GHOSTY_PUSH_TOKEN easybits crons create "Reporte" --cron "0 9 * * 1" --times 4 --agent --prompt "Mándame el resumen de ventas" easybits crons create "Aviso" --at 23:00 --url https://mi-app.com/api/aviso --method POST --dry-run # una sola vez; valida y dice cuándo easybits crons create "Aviso" --in 2h --url https://mi-app.com/api/aviso --method POST easybits crons create "Revisión 1.0.10" --at 23:00 --run "pip install -q cryptography && python3 asc.py enviar-tienda" \ --file scripts/asc.py --secret-file ASC_P8:~/.appstoreconnect/private_keys/AuthKey_X.p8 # comando en caja desechable easybits crons create "Altas del día" --cron "0 9 * * *" --run "python3 cuenta.py" --file cuenta.py --machine mi-app # con el env y los secretos de mi-app (su DATABASE_URL) easybits crons get "Revisión 1.0.10" # qué hace, cómo te avisa y la próxima ejecución (--json: el objeto completo) easybits crons runs "Revisión 1.0.10" --logs --limit 5 # exit code y stdout/stderr de cada ejecución easybits crons wait "Revisión 1.0.10" --timeout 2h # espera la siguiente ejecución y sale con su exit code easybits crons update "Revisión 1.0.10" --notify push,email --notify-on always # avisos (none los quita) easybits crons ls # los tuyos: horario, qué hace, última y próxima easybits crons update "Despertador" --cron "0 7 * * 1-5" # sólo lo que pases easybits crons run "Despertador" # id o nombre exacto; en segundo plano easybits crons runs "Despertador" # historial con el error completo easybits crons pause "Despertador" # y resume easybits crons rm "Despertador" --yes ``` Le pegan a una URL https pública (con `--secret` un secreto de tu bóveda viaja como header, `Authorization: Bearer` por default) o le mandan un turno a uno de tus agentes. Se repiten (`--cron`, como mucho cada 5 min; terminan solos con `--until ` o `--times N`) o se ejecutan **una sola vez** (`--at "2026-10-18T23:00"` o `--at 23:00` = hoy, `--in 2h`): al ejecutarse se apagan y se quedan en `ls` como «terminado», con su historial. Una hora que ya pasó es error, no «mañana». Con `--run` el trabajo lo hace una **caja desechable** (python por default, `--template node|bun|ubuntu`): monta tus `--file` junto al comando, cada `--secret NOMBRE` de tu bóveda llega como variable de entorno y cada `--secret-file NOMBRE:ruta` sube ese archivo como secreto **acotado a ese cron** (ningún otro cron, agente ni máquina lo lee; se borra con el cron) y lo escribe en la misma ruta `~/` dentro de la caja; éxito = exit 0, tope `--timeout` 600 s, la caja se destruye al terminar. `crons wait` se queda hasta que termina la siguiente ejecución (o la que va en curso), imprime su salida y **sale con su código** (`exec`: el del comando; los demás: 0 si salió bien, 1 si no), así que encaja con un `&&` o con un proceso en segundo plano. `--notify push` manda un aviso a la app de Ghosty con el token personal de tu secreto `GHOSTY_PUSH_TOKEN`; `--notify email` escribe al correo de tu cuenta (nunca a otro); por default sólo si falla, `--notify-on always` siempre. `--dry-run` valida todo y muestra las próximas 3 ejecuciones en hora local sin crear nada. Zona `--tz` (default America/Mexico_City), límite por plan. Misma API que `/api/v2/crons`. ### Buzones de eventos ```bash easybits inbox create builds # URL de webhook propia: cualquiera le escribe con POST easybits inbox ls # tus buzones, URL y no leídos easybits inbox listen builds # en vivo: una línea JSON por evento; se reconecta solo easybits inbox read builds # lo no leído, y lo marca (--all todo, --since desde un cursor, --no-ack sólo mirar) easybits inbox update builds --retention 30 # renombrar (--name) o guardar más días; la URL no cambia easybits inbox rotate builds --yes # URL nueva; la vieja deja de aceptar escrituras (si se filtró) easybits inbox rm builds --yes ``` Un webhook de EasyBits que llega a tu terminal: lo que entra a la URL te alcanza en vivo con `listen` (en Claude Code, córrelo con Monitor: cada línea despierta al agente) o te espera para `read`. Un cron le escribe con `--notify inbox:builds`. Quien tenga la URL puede escribir: no la publiques. ### Crons de la plataforma (sólo administradores) ```bash easybits crons ls --platform # estado, horario, última y próxima ejecución easybits crons runs backup-machines # últimas 50 ejecuciones, con el error completo easybits crons run purge-notifications # ejecutar ahora, en segundo plano easybits crons pause check-hosting # sus ejecuciones responden skipped easybits crons resume check-hosting ``` Las tareas programadas de EasyBits (respaldos, purgas, caducidad de web apps): lo mismo que el panel `/dash/admin/crons`. Pide una llave con alcance `ADMIN` **y** ser superusuario de la plataforma; cualquier otra cuenta recibe 403. El horario vive en el código y no se edita desde aquí. ### Dominios Dos clases. Los de tu **cuenta** sirven tus sitios en `.tienda.com` y, si le asignas uno, en la raíz: ```bash easybits domains ls easybits domains add tienda.com # imprime los registros DNS a crear easybits domains verify tienda.com # encuentra el TXT → emite el certificado easybits domains dns-auto tienda.com # ¿DNS en Mailmask? escribe los registros por ti (--undo los restaura) easybits domains apex tienda.com mi-tienda # sirve un sitio en tienda.com y www (--clear lo quita) easybits domains rm tienda.com --yes ``` Los de una **caja** ligan un dominio a un puerto de un sandbox o máquina: ```bash easybits sandboxes domains add sb_abc123 tienda.com --port 3000 # imprime el registro DNS a crear easybits sandboxes domains verify sb_abc123 tienda.com # sale con 1 mientras no esté listo easybits sandboxes domains ls sb_abc123 easybits sandboxes domains rm sb_abc123 tienda.com --yes ``` `easybits domains …` (la forma de antes) sigue funcionando: corre `sandboxes domains` y avisa en stderr. `domains dns-auto` sin Mailmask conectado sale con 1 y la liga para conectarlo una vez en el navegador. ### Web Buscar, leer, extraer y rastrear la web. Se mide en **consultas web** (paquetes en `/dash/packs?tab=web`); sin saldo sale con 1 y la liga para comprar. ```bash easybits web search dentista polanco --country mx # resultados orgánicos: # / título / url (1 consulta) easybits web fetch https://ejemplo.com --markdown --main # el contenido a stdout; --out pagina.md lo guarda (1 consulta) easybits web extract google_maps --input '[{"keyword":"dentista Polanco CDMX","country":"MX"}]' --limit 50 --wait easybits web extract mercadolibre --input '{"query":"iphone 15"}' --json # responde al instante easybits web extract instagram_profiles --url https://instagram.com/easybits # async: imprime el jobId easybits web extract-status j_abc123 # cuando termina: un registro JSON por renglón easybits web crawl https://docs.ejemplo.com --max-pages 5 --main # 1 consulta por página ``` `extract` cobra 1 consulta por registro devuelto (no por intento) y casi todas las fuentes tardan 30-120 s: sin `--wait` devuelve el `jobId` y lo revisas con `extract-status`. Fuentes: `google_maps`, `mercadolibre`, `amazon_product`, `instagram_profiles`, `linkedin_company`… (o `--dataset ` del catálogo). ### Webhooks y API keys ```bash easybits webhooks ls easybits webhooks create https://ejemplo.com/hook --event file.created --event form.submitted # imprime el secreto UNA vez easybits webhooks update 66f0c2a1b2c3d4e5f6a7b8c9 --event file.created,file.deleted # o --url, --pause, --resume easybits webhooks rm 66f0c2a1b2c3d4e5f6a7b8c9 --yes easybits keys ls # sólo el prefijo easybits keys create ci-deploy --scopes READ,WRITE --expires 2027-01-31 # imprime la key UNA vez easybits keys revoke ci-deploy --yes # por id, nombre o prefijo ``` El secreto del webhook (`whsec_…`) y la key nueva (`eb_sk_live_…`) sólo salen al crearlos: con `--json` vienen en `secret` y `raw`. Una key nunca puede crear otra con más permisos que los suyos (una READ no fabrica una WRITE, y sólo el panel o una key ADMIN da ADMIN). `keys revoke` avisa si es la key que usa el propio CLI. ### Sitios (creador de sitios) ```bash easybits sites ls # tus sitios de /dash/sitios: tipo, motor y URL easybits sites create --prompt "Landing de mi consultorio dental" # web app (TanStack) en su propia máquina easybits sites create --prompt "Lista de tareas con login" --stack next --json easybits sites create --name "Promo" --kind static # website en el CDN en vez de máquina easybits sites model mi-consultorio # motor + modelo con que se construye (● = el actual) easybits sites model mi-consultorio claude-sonnet-5-5 # el modelo vale para todos tus sitios con ese motor easybits sites theme get mi-consultorio # colores actuales (por nombre o id) easybits sites theme set mi-consultorio --theme dracula # una paleta, sin turno del modelo jq .colors tema.json | easybits sites theme set mi-consultorio --colors - # o cada token en #rrggbb ``` `create` devuelve `{id, name, kind, stack, template, previewUrl, url, editorUrl}`; `url` es `null` hasta que publiques desde el editor (construir es gratis; una web app se cobra al publicarla). `--kind webapp` (default) tiene su propia máquina con `--stack` `tanstack` (default), `next`, `react-router`, `remix`, `nuxt`, `sveltekit`, `astro` o `elysia`; `--template` (`consultorio`, `despacho`, `portafolio`, `lanzamiento`) sólo existe en TanStack y React Router, y sin ella el prompt elige una. `--kind static` es un website en el CDN. El CLI rechaza un stack o una plantilla desconocidos antes de llamar a la API. `theme` es el botón «Tema» del editor: reescribe el archivo de tema del sitio (web app: `eb-theme.css`; estático: el bloque `eb-theme` de `index.html`) y la vista previa lo toma. `--colors` necesita todos los tokens (`primary`, `primary-light`, `primary-dark`, `secondary`, `accent`, `surface`, `surface-alt`, `surface-deep`, `on-surface`, `on-surface-muted`, `on-surface-deep`, `on-primary`, `on-secondary`, `on-accent`); una paleta desconocida responde `invalid_theme` y un sitio anterior a los temas responde `no_tokens` (409). ### Documentos Páginas de HTML que tú escribes (el editor de `/dash/documents`), publicadas en una URL pública y exportadas a PDF o PNG. El CLI no genera con IA: escribe el HTML de cada página y fíjalo. ```bash easybits documents ls --search cotización # los más nuevos primero; --limit hasta 100 easybits documents create --name "Cotización ACME" --html portada.html --html precios.html # una página por archivo easybits documents create --name "Carrusel" --format ig-feed # una página en blanco de 1080x1350 easybits documents get "Cotización ACME" # formato, URL y páginas (por nombre o id) easybits documents pages ls "Cotización ACME" easybits documents pages get "Cotización ACME" 2 --out precios.html easybits documents pages set "Cotización ACME" 2 precios.html # - lee stdin easybits documents add-page "Cotización ACME" anexo.html --after 2 --label Anexo easybits documents rm-page "Cotización ACME" 3 --yes easybits documents reorder "Cotización ACME" 1 3 2 # todas las páginas, por número o id easybits documents deploy "Cotización ACME" # URL pública (+ PDF) easybits documents export pdf "Cotización ACME" --out cotizacion.pdf easybits documents export png Carrusel --out ./slides --pages 1,2 easybits documents rm "Cotización ACME" --yes ``` Una página se indica por su número (1 = la primera, como en el editor) o por su id. `--format` es `letter` (default), `ig-feed`, `li-feed`, `ig-square`, `fb-square`, `ig-story`, `wsp-status`, `tiktok`, `slide-16-9` o `WxH` en px (100-10000); sin `--html` el documento arranca con una página en blanco de ese tamaño. Las páginas pasan por el mismo camino que `set_page_html`: un HTML completo (doctype, `