En octubre de 2026, Johanna Larsson publicó el análisis del agregador de enlaces shelf.cafe, que apareció en Frontend Focus #767. Por fuera parece un clon clásico de Hacker News: más de 7,000 enlaces, SSR en Elixir (escrito a mano, sin agentes de IA), portada de ~170 KB sin caché y ~250 ms de carga. Pero tiene truco: si borras la base de shelf.cafe, el sitio vuelve a armarse desde la red sin perder ni un enlace.
Por qué entregar la base de datos a los usuarios
En un sitio CRUD tradicional todo está atado: los envíos y votos viven en tu PostgreSQL, y si cierra el proyecto los datos desaparecen. En AT Protocol (el protocolo de Bluesky) las responsabilidades se dividen en tres capas.
La fuente de verdad es el PDS (Personal Data Server), el servidor personal de datos del usuario. Cuando envías un enlace, se guarda en tu repositorio, no en una tabla cerrada del sitio. El propio shelf.cafe actúa como AppView, un escaparate e índice local. Escucha el flujo de la red, ordena las entradas con la fórmula Score = Votes ^ 0.8 / (Age + 2) ^ 1.8 y entrega HTML. Cualquiera puede construir su propio cliente sobre los mismos datos.
Johanna resolvió el arranque en vacío con dos jugadas. Los primeros enlaces llegan desde una lista de blogs RSS (idea tomada de bubbles.town, partiendo de su blogs.opml). Y en vez de comentarios vacíos, shelf.cafe mantiene un índice vivo de enlaces inversos: captura en tiempo real publicaciones de Bluesky que enlazan URLs del agregador y completa hilos antiguos con Constellation.
Para moderar tampoco reinventó la rueda. El protocolo incluye labelers, servicios independientes que etiquetan spam y estafas. shelf.cafe está suscrito a cuatro (Bluesky, Blacksky, Northsky Moderation y Skywatch Blue) y añade bloqueos locales contra bots que republicaban el feed de Hacker News.
Esquema Lexicon y envío de un enlace desde la terminal
Para que distintos clientes entiendan los mismos datos, AT Protocol usa Lexicon, un lenguaje de esquemas parecido a una mezcla de JSON Schema y OpenAPI. Los del agregador viven en cafe.shelf.* (visibles en pdsls.dev). Un registro cafe.shelf.item es así de simple:
{
"$type": "cafe.shelf.item",
"url": "https://example.com/post",
"title": "Some post",
"source": "example.com",
"createdAt": "2026-10-03T18:00:00Z"
}
El formato es abierto, así que ni siquiera hace falta navegador. Puedes enviar un enlace a tu PDS desde la terminal con la utilidad oficial en Go goat:
# Instalamos goat (o go install github.com/bluesky-social/goat@latest)
brew install goat
# Iniciamos sesión con un App Password aparte y enviamos el JSON desde archivo
goat account login -u handle.bsky.social -p xxxx-xxxx-xxxx-xxxx
cat item.json | goat record create -n -
La herramienta devuelve la dirección at:// y el cid del registro, y el AppView de shelf.cafe captura el evento y muestra el enlace en /new cerca de un segundo después. En lugar de cat sirve el portapapeles: pbpaste en macOS o xclip -o en Linux.
El README de goat advierte que la utilidad guarda la contraseña de aplicación y los tokens en tu carpeta personal en texto plano (cleartext). Crea un App Password dedicado, no inicies sesión en servidores compartidos y limpia las claves con goat account logout.
Suscripción al flujo Jetstream y widget público
Para que un AppView no tenga que digerir el pesado flujo binario de toda la red (firehose), existe Jetstream. Este servicio en Go entrega JSON compacto por WebSocket y filtra las colecciones que quieras sin autenticación:
// npm install @bsky/jetstream
import { Jetstream } from '@bsky/jetstream'
const stream = new Jetstream('https://jetstream.us-east.bsky.network')
// Escuchamos solo nuevos enlaces de la colección cafe.shelf.item
for await (const evt of stream.live({ collections: ['cafe.shelf.item'] })) {
console.log(evt)
}
Diez líneas con @bsky/jetstream y recibes en tiempo real los enlaces nuevos (o publicaciones app.bsky.feed.post para tu propio índice de enlaces inversos). Para mirar el flujo sin programar sirve websocat con el protocolo xrpc.v1.json, aunque bajo carga conviene levantar tu propio Jetstream.
Hacia fuera, los datos se sirven por XRPC, endpoints HTTP del estilo /xrpc/<nombre>. En shelf.cafe abrieron el endpoint público con CORS /xrpc/getItems?url=<url> (límite de 60 peticiones/min por IP; desde backend conviene cachear las respuestas) y el script widget.js con contador de votos para blogs.
También hay límites claros: los esquemas cafe.shelf.* no pasaron por consenso de la comunidad y pueden cambiar, y Johanna aún no publicó el código del backend en Elixir ni los detalles de OAuth, que dejó para próximos artículos sobre ingesta, backlinks y SSR rápido.



