Las AT URI y los enlaces de bsky.app, explicados
La gramática de las URI at:// para desarrolladores: autoridad, NSID de la colección y clave de registro, cómo se corresponden con bsky.app y cómo convertirlas en código.
Qué nombra una AT URI
Una AT URI apunta a una cuenta o a un registro de su repositorio. Es la dirección que usan las apps y las API, donde la gente usa enlaces de bsky.app. Su gramática, según la especificación de las AT URI:
at://AUTHORITY/COLLECTION/RKEY- Autoridad: la cuenta, como DID (
did:plc:…,did:web:…) o como handle. Los registros se guardan por DID, así que una URI guardada debería usar siempre el DID: un handle puede cambiar de dueño. - Colección: el tipo de registro, un NSID como
app.bsky.feed.post. - Clave de registro (
rkey): el nombre del registro en su colección. La mayoría son TID, identificadores de tiempo como3l6oveex3ii2l; un perfil siempre esself.
at://did:plc:z72i7hdynmk6r22z27h6tvur es una cuenta, at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post todas sus publicaciones, y una tercera parte nombra una publicación. Los registros que lee el conversor no llevan consulta ni fragmento.
De bsky.app a at://, y al revés
La app de Bluesky da una página a cinco tipos de registros. El conversor los hace corresponder en ambos sentidos:
| Enlace de bsky.app | AT URI |
|---|---|
/profile/{actor} | at://{did} |
/profile/{actor}/post/{rkey} | at://{did}/app.bsky.feed.post/{rkey} |
/profile/{actor}/feed/{rkey} | at://{did}/app.bsky.feed.generator/{rkey} |
/profile/{actor}/lists/{rkey} | at://{did}/app.bsky.graph.list/{rkey} |
/starter-pack/{actor}/{rkey} | at://{did}/app.bsky.graph.starterpack/{rkey} |
{actor} es un handle o un DID: bsky.app acepta los dos. Un enlace con el DID nunca se rompe cuando la cuenta cambia de handle. Los registros de otras colecciones (un me gusta, un seguimiento, un registro de otra app) no tienen página en bsky.app: el conversor da solo su AT URI y sus partes.
Para convertir un handle en DID, el conversor pregunta a la AppView de Bluesky (com.atproto.identity.resolveHandle). Para mostrar un enlace con el handle, lee el documento DID y solo conserva el handle si se resuelve al mismo DID.
Convertir en código
En TypeScript, AtUri de @atproto/syntax analiza y construye las URI. Un enlace de publicación se convierte en su URI así:
import { AtUri } from "@atproto/syntax";
const COLLECTIONS: Record<string, string> = {
post: "app.bsky.feed.post",
feed: "app.bsky.feed.generator",
lists: "app.bsky.graph.list",
};
export function postLinkToAtUri(link: string, did: string): string {
const [, , kind, rkey] = new URL(link).pathname.split("/").filter(Boolean);
const collection = COLLECTIONS[kind];
if (!collection || !rkey) throw new Error("Not a post, feed or list link");
return AtUri.make(did, collection, rkey).toString();
}
const uri = new AtUri("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3l6oveex3ii2l");
uri.host; // the DID
uri.collection; // "app.bsky.feed.post"
uri.rkey; // "3l6oveex3ii2l"En Python, la AT URI es lo bastante simple para dividirla a mano:
def parse_at_uri(uri: str) -> dict:
if not uri.startswith("at://"):
raise ValueError("not an AT URI")
parts = uri[len("at://"):].split("/")
return {
"authority": parts[0],
"collection": parts[1] if len(parts) > 1 else None,
"rkey": parts[2] if len(parts) > 2 else None,
}Resuelve primero el handle a un DID (resolveHandle, o el buscador de DID) para que la URI que guardas siga funcionando.
Desde la API o un agente de IA
El conversor también es GET /api/v1/tools/at-uri-converter?uri=… y la herramienta MCP convert_at_uri: consulta API de herramientas y servidor MCP. Cuando la clave de registro es un TID, el decodificador de TID lee la hora que contiene.