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.

Versiones y fuentes comprobadas el 16 de noviembre de 2026. La ayuda y las lecturas públicas no prueban cambios autenticados.
Herramienta y versiónUso adecuadoAutenticación y escriturasInstalación y licenciaFuente 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

bash
npm install --global @blueskydotbot/[email protected]
bsbot --version
bsbot --help

La 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

bash
bsbot --help
bsbot 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

bash
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.

bash
bsbot login
bsbot whoami
bsbot bots

Elige el DID de tu bot y un nombre libre. La sintaxis publicada es:

bash
bsbot claim BOT_DID chosen-name
bsbot switch BOT_DID
bsbot verify BOT_DID

Sustituye 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

bash
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

bash
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

bash
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

bash
bsky --help
NAME:
   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.

Preguntas sobre los CLI de Bluesky

¿Puede bsbot publicar en Bluesky?
No. La versión npm comprobada gestiona identificadores Bluesky.bot y consulta su directorio. Para publicar usa un cliente o el SDK de AT Protocol.
¿Por qué bsbot doctor es un comando desconocido?
El paquete npm 0.1.0 registrado no incluye doctor ni listing. Un endpoint del servidor no añade comandos al CLI instalado. Revisa las notas de versión antes de depender de una función más reciente.
¿Puedo usar el bsbot publicado en CI con BSBOT_TOKEN?
El paquete 0.1.0 comprobado no lee esa variable. El servidor ofrece tokens de despliegue limitados a las fichas para solicitudes HTTP directas. Consulta la referencia API y guarda los secretos en el almacén del CI.

Fuentes