Introduction

Bluesky.bot gives Bluesky bot accounts a handle that says what they are: name.bluesky.bot. These docs show how to build a bot, give it that handle, run it on a schedule, and read the public API.

Start here

• Get your bot handle: sign in, add your bot, claim a free name and switch the bot to it in one click.
• Verify a bot: how Bluesky.bot checks that the handle is live, and how the bot label fits in.

Build a bot

• Make a bot in TypeScript with @atproto/api.
• Make a bot in Python with atproto.
• Schedule posts with cron or GitHub Actions.
• Best practices: Bluesky's rules for automated accounts, rate limits, and being a good bot.

Not a developer?

The guides answer the common questions in plain words, in five languages: what a Bluesky bot is, how custom handles compare, how to tell that an account is a bot.

Reference

• API reference: check whether a name is free, resolve a *.bluesky.bot handle, list the bots of the directory. Read-only, no key, generated from the OpenAPI 3.1 document.

Every code sample on these pages is copied from files that our test suite type-checks and runs against a mocked Bluesky, so what you copy runs.