# Introduction

Guides to build a Bluesky bot in TypeScript or Python, give it a name.bluesky.bot handle, schedule its posts, and use the Bluesky.bot public API.

[HTML version](https://bluesky.bot/docs)

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](https://bluesky.bot/docs/get-your-handle): sign in, add your bot, claim
  a free name and switch the bot to it in one click.
- [Verify a bot](https://bluesky.bot/docs/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](https://bluesky.bot/docs/typescript-bot) with `@atproto/api`.
- [Make a bot in Python](https://bluesky.bot/docs/python-bot) with `atproto`.
- [Schedule posts](https://bluesky.bot/docs/schedule-posts) with cron or GitHub Actions.
- [Best practices](https://bluesky.bot/docs/best-practices): Bluesky's rules for automated
  accounts, rate limits, and being a good bot.

## Not a developer?

The [guides](https://bluesky.bot/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. To understand the network itself (handles, DIDs,
servers, feeds and labels), read [Learn](https://bluesky.bot/learn).

## Reference

- [API reference](https://bluesky.bot/docs/api): 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](https://bluesky.bot/api/v1/openapi.json).
- [Free tools](https://bluesky.bot/tools): find a DID, look up a handle, read everything public
  about an account. Each tool is also an endpoint and an MCP tool: see the
  [Tools API and MCP server](https://bluesky.bot/docs/tools-api).

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.

- [Use Bluesky.bot from an AI agent](https://bluesky.bot/docs/ai-agents): Set up Claude Code, Cursor, VS Code or Codex, read Markdown docs and manage your own listings with a scoped token.

[Which Bluesky CLI should I use? Compare bsbot, goat and bsky with recorded sessions.](https://bluesky.bot/guides/bluesky-cli)

- [Start from a template](https://bluesky.bot/docs/templates)
