biubiubiu
ES
GitHub Desplegar

Código abierto · funciona en Cloudflare

Notificaciones push desde cualquier sitio, directas a tu móvil.

biubiubiu es un servidor Web Push ligero y autoalojado sobre Cloudflare Workers y D1. Una petición HTTP desde un script, una tarea cron, tu CI o un agente de IA, y tu móvil vibra. Sin servidores que mantener ni apps nativas que instalar.

Desplegar en Cloudflare Ver en GitHub

Se despliega en un minuto. Compatible con el plan gratuito.

Una línea para enviar

Si puede hacer una petición HTTP, puede avisarte.

Para un aviso rápido basta con una clave de dispositivo en la URL. La API JSON añade tokens, grupos de dispositivos, Markdown, envíos programados, cifrado de extremo a extremo y preguntas con botones, respuestas escritas y confirmación con passkey. Las plantillas de webhook aceptan GitHub, Grafana y Alertmanager tal cual, y las alertas críticas se repiten hasta que las abres.

GET rápido con una clave de dispositivo
curl https://push.example.com/<deviceKey>/Backup%20done
JSON a todos los dispositivos, con un token de API
curl -X POST https://push.example.com/api/send \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"title":"Deploy","body":"v2.3.1 is live"}'
Haz una pregunta y espera la respuesta
curl -X POST https://push.example.com/api/send \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"title":"Deploy?","choices":["Ship it","Hold"]}'
Crítica: se reenvía hasta que alguien la abra
curl -X POST https://push.example.com/api/send \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"title":"Prod down","level":"critical","retry":120}'

Funciones

Un servidor pequeño con todo lo necesario.

Todas las plataformas

iOS 16.4+ como app web en la pantalla de inicio, Android y navegadores de escritorio modernos. Sin tienda de apps.

Claves por dispositivo

Cada dispositivo tiene su propia clave revocable; tokens de API con permisos para scripts; una clave maestra para gestionarlo todo.

Destinos flexibles

Envía a todos, a un grupo de dispositivos o a dispositivos concretos.

Centro de mensajes

Cada push se archiva con Markdown, filtros por categoría, contador de no leídos y caducidad por TTL.

Actualización en el sitio

Reutiliza un id para actualizar una notificación en lugar de apilar otras nuevas. Ideal para el progreso de una build.

Envíos programados

Encola un mensaje con scheduledAt; un cron que corre cada minuto lo entrega a tiempo.

Cifrado de extremo a extremo

Cargas AES-CBC compatibles con Bark que se descifran en el dispositivo. El servidor solo ve texto cifrado.

Entrega fiable

Reintentos automáticos, limpieza de suscripciones caducadas, autorreparación de suscripciones y registros de entrega por dispositivo.

Plantillas de webhook

Apunta GitHub, Grafana o Alertmanager directamente a tu servidor con ?template=github. Todo lo que publica en Slack, Discord o ntfy también funciona.

Alertas repetidas hasta confirmar

Envía un mensaje critical con retry y se vuelve a enviar cada pocos minutos hasta que alguien lo abra.

Hecho para agentes de IA

Aléjate de la terminal. Tu agente te avisará.

Los agentes de programación terminan, fallan o se atascan mientras estás en otra parte. biubiubiu les da una forma de avisarte, y a ti una forma de responder.

Servidor MCP

HTTP en streaming en /mcp da a cualquier cliente MCP la herramienta send_notification. Un solo comando lo añade a Claude Code.

ask_human

El agente envía una pregunta con botones o un cuadro de respuesta y recibe tu respuesta al instante. Las opciones de riesgo pueden pedir Face ID o Touch ID.

Skill y hooks

Una Agent Skill enseña al agente cuándo avisarte; los hooks de Claude Code te avisan en cada parada o petición de permiso.

Claude Code
claude mcp add --transport http biubiubiu \
  https://push.example.com/mcp \
  --header "Authorization: Bearer $BIUBIUBIU_TOKEN"
Agent Skill
npx skills add chada/biubiubiu --skill biubiubiu-notify
Configura tu agente

Modo de cuentas

Comparte un servidor con tu familia o tu equipo.

Activa el modo de cuentas y cada persona tiene su propio acceso, con:

  • Invitaciones, para decidir quién entra
  • Sus propios dispositivos y bandeja de entrada
  • Tokens de envío personales para sus scripts
  • Restablecimiento de contraseña por push o correo

Es opcional y viene desactivado. Requiere Workers Paid; sin él, biubiubiu funciona en el plan gratuito con una sola clave maestra.

Cómo funcionan las cuentas

La app

Una bandeja de entrada en tu pantalla de inicio.

Bandeja de entrada con Te necesita, secciones por día y filtros por grupo
Una pregunta de un agente, respondida con un toque
Mensajes en Markdown, actualizados en el sitio por id

Empieza

Tu propio servidor push en tres pasos.

  1. Despliega

    El botón copia el repositorio a tu GitHub o GitLab, crea la base de datos D1, aplica las migraciones y despliega el Worker.

  2. Define una clave maestra

    Rellena MASTER_KEY, tu contraseña de administrador (por ejemplo openssl rand -base64 32). Las claves VAPID se generan solas.

  3. Ábrelo en tu móvil

    Añade la app a la pantalla de inicio, permite las notificaciones y copia la clave del dispositivo. Envía tu primer biu.

Deploy to Cloudflare

¿Prefieres la línea de comandos? Consulta el despliegue manual.

Preguntas frecuentes

Preguntas y respuestas.

¿Te queda alguna duda? Pregunta en GitHub.

¿Qué es biubiubiu?

biubiubiu es un servidor de notificaciones Web Push gratuito y de código abierto que alojas tú mismo en Cloudflare Workers y D1. Un script, una tarea cron, un pipeline de CI o un agente de IA le envía una petición HTTP, y él envía una notificación a tu móvil, tableta o escritorio mediante el protocolo estándar Web Push.

¿Cuánto cuesta?

biubiubiu es gratuito. Funciona en tu propia cuenta de Cloudflare, y el modo predeterminado con clave maestra cabe en el plan gratuito de Workers. Solo el modo de cuentas opcional necesita Workers Paid, porque el hash de contraseñas usa más tiempo de CPU del que permite el plan gratuito.

¿Funciona en iPhone sin instalar una app?

Sí. En iOS y iPadOS 16.4 o posterior, abre tu servidor en Safari, añádelo a la pantalla de inicio y activa las notificaciones. En Android y en escritorio, Chrome, Edge, Firefox y Safari reciben push directamente en el navegador.

¿Puedo usarlo como alternativa a Bark, también en Android?

Sí. biubiubiu sigue el estilo de URL y API JSON de Bark, así que tus scripts y Atajos de iOS para Bark siguen funcionando al cambiar la dirección del servidor y la clave del dispositivo, y los mensajes ahora llegan también a Android y al escritorio. Algunas opciones de Bark, como sonidos personalizados y alertas críticas con alarma, no son posibles con Web Push, pero un mensaje crítico puede repetirse hasta que lo abras.

¿Cómo me avisan agentes de IA como Claude Code?

Añade el servidor MCP en /mcp a cualquier cliente MCP (un solo comando en Claude Code) y el agente obtiene la herramienta send_notification y la herramienta ask_human, que envía una pregunta con botones o un cuadro de respuesta y devuelve tu respuesta en cuanto contestas; las respuestas de riesgo pueden exigir una passkey (Face ID o Touch ID). También incluye una Agent Skill (se instala con npx skills add chada/biubiubiu) y hooks para Claude Code.

¿En qué se diferencia de ntfy, Gotify o Pushover?

Pushover es un servicio alojado de pago, y ntfy o Gotify autoalojados necesitan un servidor que mantengas en marcha. biubiubiu funciona sin servidores en tu propia cuenta de Cloudflare, así que no hay nada que parchear ni mantener en línea; entrega mediante Web Push estándar sin app nativa e incluye un servidor MCP para agentes de IA. Las herramientas con soporte integrado para ntfy pueden publicar en él usando una clave de dispositivo como tema, y los mensajes críticos se repiten hasta que los confirmas, como la prioridad de emergencia de Pushover.

¿Quién puede leer mis notificaciones?

Solo tú. Los mensajes se guardan en la base de datos D1 de tu propia cuenta de Cloudflare. Con el cifrado de extremo a extremo activado, el contenido se cifra antes de enviarse y se descifra en el dispositivo, así que el servidor solo ve texto cifrado.

Documentación

Lee la documentación.

Referencia de la API

Autenticación, todos los endpoints y parámetros, MCP y cifrado.

Despliegue

Desarrollo local, secretos, D1, dominios propios y modo de cuentas.

Agentes de IA

Configuración de MCP, la skill de avisos y los hooks de Claude Code.

Notas por plataforma

Configuración en iOS y los límites de Web Push.

La documentación detallada está en inglés. Leer el README en español

Empieza

Tu móvil, a una petición de distancia.

Despliega tu propio servidor push en un minuto. Gratis, de código abierto y tuyo.

Desplegar en Cloudflare Ver en GitHub