← Comprendre

Comprendre

Comment fonctionnent les bots sur Bluesky

Sur Bluesky, un bot est un compte ordinaire géré par un programme. Il a un DID, un handle et un PDS comme n’importe quel compte, et il publie en écrivant des enregistrements dans son dépôt. Ce qui en fait un bot, c’est qui le gère, et il peut le dire avec l’étiquette d’automatisation.

Dernière relecture le 14 novembre 2026

Il n’existe pas de type de compte spécial pour les bots sur Bluesky. Un bot est un programme qui utilise un compte ordinaire, et tout ce qu’il fait passe par le même protocole que l’app Bluesky.

Un bot est un compte ordinaire

Comme tout compte, un bot a un DID, son identifiant permanent, un handle que les gens lisent, et un PDS qui héberge son dépôt. Quand il publie, aime un post ou suit un compte, il ajoute un enregistrement à ce dépôt, exactement comme l’app le fait pour une personne. Pour le relais et l’AppView, le post d’un bot est un enregistrement comme un autre.

Le tutoriel de bot du protocole commence de la même façon : créer un compte pour le bot, puis un mot de passe d’application pour lui.

Comment un bot publie

Un bot parle à son propre PDS, en HTTPS. Il commence par se connecter, de l’une de ces deux façons :

  • avec un mot de passe d’application, un mot de passe créé pour une seule app, distinct du mot de passe principal du compte et révocable à part. La documentation du protocole indique que les programmes à usage unique, comme les bots et les outils en ligne de commande, peuvent se connecter avec un mot de passe, et un mot de passe d’application garde le mot de passe principal hors de leur code ;
  • avec OAuth, la connexion standard des apps atproto, où le compte accorde un accès sans partager de mot de passe. Les apps qui connectent des personnes sont censées l’utiliser.

Ensuite, il crée un enregistrement, par exemple un post dans sa collection app.bsky.feed.post. Le PDS signe le changement avec la clé du compte et l’ajoute au dépôt, et à partir de là le post fait le même parcours que n’importe quel autre : relais, AppView, lecteurs. La documentation pour les développeurs montre le code en TypeScript et en Python.

Pour aller plus loin. Un post est un appel à com.atproto.repo.createRecord sur le PDS, avec un corps comme celui ci-dessous. Le PDS choisit la clé de l’enregistrement, en général un TID tiré de l’horloge, et répond avec l’AT URI du post et son CID, le hash de cette version précise.

json
{
  "repo": "did:plc:ewvi7nxzyoun6zhxrhs64oiz",
  "collection": "app.bsky.feed.post",
  "record": {
    "$type": "app.bsky.feed.post",
    "text": "Hello from a bot!",
    "createdAt": "2026-11-14T09:00:00.000Z"
  }
}

Comment un bot écoute

Beaucoup de bots se contentent de publier, à heures fixes. D’autres réagissent : à une mention, une réponse ou un nouvel abonné, ou à quelque chose qui se passe n’importe où sur le réseau. Il y a deux façons courantes d’écouter :

  • Les notifications. Le bot demande régulièrement ses propres notifications, la même liste qu’une personne voit dans l’app, et répond aux mentions et aux réponses qu’il y trouve. Le tutoriel de bot du protocole fonctionne ainsi.
  • Le firehose ou Jetstream. Un bot qui surveille tout le réseau, par exemple les posts qui contiennent un mot-clé, lit un flux. Le firehose d’un relais est binaire : ses événements sont encodés en CBOR, et les enregistrements qu’ils transportent sont en DAG-CBOR. Jetstream envoie les mêmes changements en JSON simple sur une WebSocket, filtrés selon ce que le bot demande : c’est ce que Bluesky recommande à la plupart des développeurs.

Les deux flux sont publics : les lire ne demande ni compte ni mot de passe. Un bot ne se connecte que pour écrire.

Pour aller plus loin. Les notifications viennent de app.bsky.notification.listNotifications sur l’AppView, en passant par le PDS du bot. Le firehose, c’est com.atproto.sync.subscribeRepos sur un relais. Jetstream peut filtrer par collection, comme app.bsky.feed.post, et par compte.

La boucle d’un bot

Mis bout à bout, la plupart des bots tournent selon la même boucle :

  1. Horaire ou événementUn minuteur, une mention, ou un post repéré dans Jetstream.
  2. Code du botTourne n’importe où : un serveur, un ordinateur portable, une tâche planifiée.
  3. Son PDSEnregistre le post dans le dépôt du bot.
  4. Le réseauLe relais et l’AppView le transmettent.
  5. Les lecteursLe voient dans leurs timelines, leurs feeds et leurs notifications.

Les réponses et les mentions reviennent au bot sous forme de notifications, et la boucle recommence.

La boucle d’un bot : un horaire ou un événement lance le code du bot, qui écrit dans son PDS ; le réseau porte le post jusqu’aux lecteurs.

Chaque étape est une brique distincte. Le code du bot peut tourner n’importe où, sur un serveur, un ordinateur portable ou une tâche planifiée, tandis que son compte et ses posts vivent sur son PDS.

Dire que c’est un bot

Le protocole ne signale pas les bots de lui-même : c’est le compte qui dit qu’il est automatisé. Il y a trois façons courantes de le faire, et elles marchent mieux ensemble :

  • L’étiquette d’automatisation. Dans l’app Bluesky, un compte peut l’activer dans Paramètres → Compte → Étiquette d’automatisation. L’app affiche alors l’étiquette à côté du nom du compte, sur son profil et sur ses posts. En coulisses, c’est l’auto-label bot de l’enregistrement de profil du compte, que le tutoriel de bot du protocole recommande comme bonne pratique.
  • Le profil. Une bio qui dit que le compte est automatisé, ce qu’il publie et qui le gère.
  • Le handle. Un nom qui dit « bot » avant même qu’on ouvre le profil.

Comment on trouve un bot

On trouve un bot comme n’importe quel compte : dans la recherche, grâce aux réponses et aux reposts, dans les feeds personnalisés et les listes, et dans les kits de démarrage, les listes de comptes et de feeds recommandés que les gens créent dans l’app Bluesky et partagent sous forme de lien.

Les règles

Les bots suivent les mêmes règles que tout le monde, plus des limites qui comptent davantage pour eux. Cette page ne les reformule pas ; lisez-les à la source :

Comment Bluesky.bot s’en sert

Bluesky.bot est fait pour les bots. Il donne à chacun un handle name.bluesky.bot, servi depuis le domaine de Bluesky.bot, si bien que le bot garde son DID, son PDS et son code ; il liste les bots dans un annuaire public ; et son bilan rappelle aux créateurs d’activer l’étiquette d’automatisation. Son labeler ajoute aussi un label bot aux comptes qui ont un handle *.bluesky.bot actif. Qu’est-ce qu’un bot Bluesky ?

Questions fréquentes

Bluesky autorise-t-il les comptes automatisés ?
Oui. Un compte automatisé peut publier comme n’importe quel autre, tant qu’il respecte les Règles de la communauté et les Conditions d’utilisation de Bluesky, suit ses Règles pour les développeurs, qui comptent les interactions automatisées ou en masse et les spambots comme du spam, et reste dans les limites de débit. Tous ces textes sont liés sous « Les règles » sur cette page.
Les bots ont-ils besoin d’un compte spécial ?
Non. Un bot utilise un compte ordinaire, en général le sien plutôt que celui de son créateur. Il se connecte avec un mot de passe d’application ou avec OAuth, si bien que le mot de passe principal du compte reste hors de son code, et il peut activer l’étiquette d’automatisation pour montrer qu’il est automatisé.

Sources

Les pages officielles sur lesquelles s’appuie cette explication. Elles sont en anglais.

Donnez à votre bot un handle reconnaissable

Bluesky.bot donne aux comptes de bots un handle name.bluesky.bot gratuit, prouvé à tout le réseau, et une place dans l’annuaire public des bots.