Documentación de la herramienta

Entender los repositorios AT Protocol

Repositorios, colecciones, claves, CID y archivos: qué lee el explorador, cómo protege las peticiones y cómo exportar los datos de tu cuenta.

Repositorios y colecciones

El servidor personal de datos (PDS) de una cuenta aloja su repositorio público. Las colecciones agrupan registros por NSID: app.bsky.feed.post contiene publicaciones y app.bsky.graph.follow seguimientos. Un NSID desconocido identifica otro esquema, que puede no ser de Bluesky.

El explorador de repositorios acepta un handle, DID o URI AT. Muestra colecciones y páginas de 50 registros en ambos órdenes. Las URL usan q, cursor y reverse=1, y funcionan sin JavaScript.

Claves, CID y referencias

Una URI AT identifica repositorio, colección y clave. Un CID identifica una versión del contenido. Muchas claves son TID con fecha; otras, como self, no tienen fecha TID. Consulta el convertidor de URI AT y el decodificador TID.

El árbol JSON escapa el texto y se limita a 256 KiB y 20 niveles. Las referencias AT enlazan registros y los DID enlazan Whois. Los archivos muestran CID, MIME y tamaño. La descarga es un enlace externo explícito al PDS; nunca se cargan imágenes de un PDS arbitrario automáticamente.

Lecturas públicas y seguridad

La herramienta resuelve el documento DID, consulta el relé y llama a com.atproto.repo.describeRepo, com.atproto.repo.listRecords o com.atproto.repo.getRecord en el PDS. Cada petición usa protección SSRF, HTTPS, cuatro segundos de espera, sin redirecciones y límites de 1 MiB, o 256 KiB para un registro. Se rechazan direcciones privadas. La caché dura cinco minutos, uno para colecciones. No permite escribir.

Exportar y abrir localmente

En Bluesky: Ajustes → Cuenta → Exportar mis datos. Los desarrolladores pueden descargar com.atproto.sync.getRepo?did=… del PDS. Abre el .car en el explorador CAR. Funciona en un worker local, sin subida, API, interfaz MCP ni estadísticas de acciones del archivo. Sigue una referencia solo cuando quieras navegar a otra página.

Los exports CAR v1 se limitan a 512 MiB, 250 000 registros, 500 000 secciones incluidos duplicados y 2000 colecciones. Las cabeceras tienen un máximo de 64 KiB y los bloques de 1 MiB antes de reunir su contenido. Un presupuesto independiente de 512 MiB contabiliza los bloques retenidos y los metadatos del índice reconstruido. El worker lee fragmentos de 64 KiB, calcula el hash de cada bloque distinto una vez y comprueba la igualdad de los duplicados. Cada operación local dispone de 60 segundos; cancelar una lectura reutiliza el worker ya cargado, sin solicitud de red. Colecciones y registros se paginan de 100 en 100. La memoria disponible puede reducir el límite práctico. Una firma presente se muestra como no verificada. Búsqueda y JSON Lines siguen siendo locales; no incluye ZIP ni exportación masiva de blobs.

Explorador de repositorios

Consulta los datos públicos de una cuenta en su servidor.