Bluesky desde la terminal: ¿qué CLI elegir?
Usa bsbot para los identificadores Bluesky.bot, goat para operaciones generales de AT Protocol y un cliente de publicaciones para el feed. Cada sesión indica su versión y distingue la ayuda local de las lecturas públicas.
Por El equipo de Bluesky.bot
- Publicado:
- Actualizado:
- Revisado:
Elegir según la tarea
Para los identificadores name.bluesky.bot de tus bots, empieza con bsbot y la referencia CLI. Para resolver identidades públicas, exportar repositorios, examinar archivos CAR, leer el historial PLC o migrar cuentas, considera goat. Para leer el feed o publicar, considera mattn/bsky o un SDK de AT Protocol. Sus propósitos y permisos son distintos.
| Herramienta y versión | Uso adecuado | Autenticación y escrituras | Instalación y licencia | Fuente y revisión |
|---|---|---|---|---|
bsbot 0.1.0 TypeScript / Node.js ≥ 22 Publicado el 12 nov 2026 | Gestionar identificadores Bluesky.bot; consultar nombres y el directorio público. No publica ni lee el feed. | OAuth en el navegador para acciones de cuenta. Su token gestiona identificadores y es distinto de una contraseña de aplicación de Bluesky. | npm install --global @blueskydotbot/[email protected]MIT | Fuente versionada Comprobado el 16 nov 2026 |
goat 0.2.9 Go Publicado el 6 nov 2026 | Resolver identidades, examinar repositorios y archivos CAR, leer el historial PLC, exportar, administrar o migrar cuentas. | Muchas lecturas son públicas. Las escrituras usan inicio con contraseña de aplicación; el cliente documenta el almacenamiento de credenciales en disco. | go install github.com/bluesky-social/[email protected]MIT / Apache-2.0 | Fuente versionada Comprobado el 16 nov 2026 |
mattn/bsky 0.0.82 Go Publicado el 19 ago 2026 | Cliente de Bluesky para publicar y leer el feed, con comandos de perfil, seguimiento, moderación y otras acciones. | El inicio documentado acepta identificador y contraseña. Usa una contraseña de aplicación; los comandos autenticados pueden modificar la cuenta. | go install github.com/mattn/[email protected]MIT | Fuente versionada Comprobado el 16 nov 2026 |
La comparación describe versiones comprobadas, no código sin publicar. Ejecutamos la ayuda local de bsbot y bsky, una consulta pública de nombre con bsbot y una resolución pública de DID con goat. No ejecutamos publicaciones, migraciones ni cambios de identificador autenticados.
Instalar y comprobar la versión
npm install --global @blueskydotbot/[email protected]
bsbot --version
bsbot --helpLa versión fijada coincide con la captura. Para una ejecución puntual usa npx @blueskydotbot/[email protected] --help. Lee las notas antes de elegir una versión más reciente. Los requisitos documentados son Node.js 22 o posterior en macOS o Linux; la sesión usó Linux y Node.js 24.
bsbot 0.1.0 ·
Comando local; sin conexión a una cuenta · Código de salida 0
bsbot --helpbsbot 0.1.0: manage your Bluesky bots and their name.bluesky.bot handles.
Usage: bsbot <command> [options]
Account
login [--no-browser] [--name <label>]
Sign in through the browser (OAuth, no password);
<label> names this machine in your settings
logout Revoke this machine's token and forget it
whoami Show the signed-in account
Handles
check <name> Is <name>.bluesky.bot free to claim?
claim <bot> <name> Claim <name>.bluesky.bot for a bot and switch to it
switch <bot> Ask the bot's server again to use its handle
verify <bot> Check that the bot's handle is live on Bluesky
release <bot> [--yes] Give the handle up (the bot goes back to its old one)
Bots
bots List your bots
directory [--q <text>] [--category <c>] [--verified] [--limit <n>] [--cursor <c>]
Browse the public directory
<bot> is a bot's DID, its handle, its previous handle, or the name of its
.bluesky.bot handle. Add bots from the dashboard: https://bluesky.bot/manage
Options
--json Machine-readable output (never contains the token)
--api-url <url> Another server (or BSBOT_API_URL)
-h, --help This help
-v, --version The version
Empezar con una lectura pública
check consulta si un nombre está libre, sin reservarlo. El nombre capturado pertenece a la cuenta CLI del proyecto; la disponibilidad y las sugerencias pueden cambiar.
bsbot 0.1.0 ·
Lectura de la API pública de Bluesky.bot · Código de salida 0
bsbot check cli --json{
"name": "cli",
"handle": "cli.bluesky.bot",
"available": false,
"reason": "taken",
"suggestions": [
"cli2",
"cli-24",
"cli3"
]
}
Iniciar sesión y gestionar tu bot
Estos comandos son instrucciones, no sesiones autenticadas registradas. Añade primero el bot en el panel. Ejecuta bsbot login, comprueba la cuenta y el nombre del equipo en el navegador y autoriza. La contraseña de Bluesky nunca pasa por bsbot. Su token es de Bluesky.bot y no permite publicar en Bluesky.
bsbot login
bsbot whoami
bsbot botsElige el DID de tu bot y un nombre libre. La sintaxis publicada es:
bsbot claim BOT_DID chosen-name
bsbot switch BOT_DID
bsbot verify BOT_DIDSustituye los parámetros. claim solicita el nombre y pide al servidor del bot que cambie el identificador; switch repite esa petición. verify comprueba si está activo. Lee el estado antes de reintentar: pending puede requerir esperar, mientras que manual necesita tu intervención. Consulta la verificación.
Doctor y CI: separar servidor y CLI publicado
El paquete npm comprobado es 0.1.0, aunque el repositorio describa trabajo posterior. No incluye doctor, listing ni compatibilidad con BSBOT_TOKEN. Las capturas de comando desconocido son reales; no muestran diagnósticos ni cambios de ficha exitosos.
bsbot 0.1.0 ·
Comando local; sin conexión a una cuenta · Código de salida 2
bsbot doctor --json{"error":{"code":"usage","message":"Unknown command \"doctor\". See bsbot --help."}}
bsbot 0.1.0 ·
Comando local; sin conexión a una cuenta · Código de salida 2
bsbot listing get cli --json{"error":{"code":"usage","message":"Unknown command \"listing\". See bsbot --help."}}
Usa el diagnóstico del panel. La referencia API describe los endpoints autenticados de diagnóstico y fichas, y los tokens de despliegue limitados a las fichas. En CI, sigue ese contrato HTTP, guarda el secreto en su almacén y limita el token al bot previsto. Un ejemplo HTTP no demuestra que un comando bsbot listing set sin publicar esté disponible. La referencia CLI conserva los detalles de compatibilidad.
Lecturas de AT Protocol con goat
Esta sesión resuelve el DID público de bsky.app, sin iniciar sesión ni cambiar la cuenta. El documento identifica el handle, la clave pública y el servidor en la fecha de captura. Las exportaciones y migraciones usan otros comandos; consulta la fuente versionada de goat antes de realizarlas.
goat goat version 0.2.9 ·
Lectura de datos públicos de AT Protocol · Código de salida 0
goat resolve did:plc:z72i7hdynmk6r22z27h6tvur{
"@context": [
"https://www.w3.org/ns/did/v1",
"https://w3id.org/security/multikey/v1",
"https://w3id.org/security/suites/secp256k1-2019/v1"
],
"id": "did:plc:z72i7hdynmk6r22z27h6tvur",
"alsoKnownAs": [
"at://bsky.app"
],
"verificationMethod": [
{
"id": "did:plc:z72i7hdynmk6r22z27h6tvur#atproto",
"type": "Multikey",
"controller": "did:plc:z72i7hdynmk6r22z27h6tvur",
"publicKeyMultibase": "zQ3shQo6TF2moaqMTrUZEM1jeuYRQXeHEx4evX9751y2qPqRA"
}
],
"service": [
{
"id": "#atproto_pds",
"type": "AtprotoPersonalDataServer",
"serviceEndpoint": "https://puffball.us-east.host.bsky.network"
}
]
}
Publicaciones y feed con bsky
La ayuda registrada proviene del binario mattn/bsky 0.0.82 descargado. Enumera operaciones de feed, publicación y cuenta. No iniciamos sesión ni ejecutamos escrituras. La documentación original describe capacidades, pero no demuestra que nuestra sesión probara cada comando.
bsky bsky version 0.0.82 ·
Comando local; sin conexión a una cuenta · Código de salida 0
bsky --helpNAME: bsky - bsky USAGE: bsky [global options] command [command options] VERSION: 0.0.82 DESCRIPTION: A cli application for bluesky COMMANDS: show-profile Show profile update-profile Update profile show-session Show session timeline, tl Show timeline stream Show timeline as stream thread Show thread post Post new text vote Vote the post votes Show votes of the post repost Repost the post reposts Show reposts of the post follow Follow the handle unfollow Unfollow the handle follows Show follows followers Show followers block Block the handle unblock Unblock the handle blocks Show blocks mute Mute the handle unmute Unmute the handle mutes Show muted users report Report the handle moderation-list Add the handle to a new moderation list lists Show lists list Show list items chat Direct messages delete Delete the note search Search Bluesky search-actors Search Actors login Login the social notification, notif Show notifications invite-codes Show invite codes list-app-passwords Show App-passwords add-app-password Add App-password revoke-app-password Revoke App-password mcp Start MCP server help, h Shows a list of commands or help for one command GLOBAL OPTIONS: -a value profile name -V verbose (default: false) --help, -h show help --version, -v print the version
Proteger las credenciales según su propósito
bsbot guarda su token en ~/.config/bsbot/credentials.json, con permisos exclusivos del usuario; su duración predeterminada es de 30 días. bsbot logout lo revoca. El panel también puede revocar el acceso CLI. No pongas credenciales en registros ni código fuente.
Para un cliente que acepte una contraseña de Bluesky, crea una contraseña de aplicación. goat documenta el almacenamiento de la contraseña de aplicación y tokens en disco; cerrar sesión borra ese archivo local. Las credenciales de un cliente de publicación pueden permitir posts y otros cambios, a diferencia del token de identificadores Bluesky.bot. Revisa permisos, almacenamiento y revocación antes de automatizar.