← 学ぶ

学ぶ

Bluesky のボットのしくみ

Bluesky のボットは、プログラムが動かす普通のアカウントです。ほかのアカウントと同じく DID、ハンドル、PDS を持ち、リポジトリにレコードを書き込んで投稿します。ボットであるかどうかは誰が動かしているかで決まり、そのことは自動化ラベルで伝えられます。

最終確認日:2026年11月14日

Bluesky には、ボット専用の特別な種類のアカウントはありません。ボットは普通のアカウントを使うプログラムで、することはすべて Bluesky アプリと同じプロトコルを通ります。

ボットは普通のアカウント

ほかのアカウントと同じく、ボットには永続的な識別子である DID、人が読む ハンドル、そして PDS があり、PDS がボットの リポジトリ をホストしています。投稿したり、いいねしたり、フォローしたりすると、そのリポジトリに レコード が 1 つ加わります。アプリが人のためにすることとまったく同じです。リレーや AppView から見れば、ボットの投稿もほかと変わらないレコードです。

プロトコル自身のボットのチュートリアルも、同じところから始まります。ボット用のアカウントを作り、そのアカウントのアプリパスワードを作るところです。

ボットが投稿するしくみ

ボットは HTTPS で自分の PDS とやり取りします。まず、次のどちらかの方法でサインインします。

  • アプリパスワード を使う方法。1 つのアプリのために作るパスワードで、アカウントのメインのパスワードとは別にあり、個別に取り消せます。プロトコルのドキュメントによれば、ボットやコマンドラインツールのような単一目的のプログラムはパスワードでサインインしてよく、アプリパスワードを使えばメインのパスワードをコードに書かずに済みます。
  • OAuth を使う方法。atproto アプリの標準のサインイン方法で、アカウントはパスワードを渡さずにアクセスを許可します。人をサインインさせるアプリは、こちらを使うことになっています。

次に、レコードを作ります。たとえば app.bsky.feed.post コレクションへの投稿です。PDS はアカウントの鍵で変更に署名してリポジトリに加え、そこから先、投稿はほかの投稿と同じ道筋(リレー、AppView、読者)をたどります。開発者向けドキュメントでは、TypeScript と Python のコードを紹介しています。

もっと詳しく。 投稿は、PDS の com.atproto.repo.createRecord を下のような本文で呼び出すことです。レコードのキーは PDS が選び、通常は時計から作る TID になります。応答には、投稿の AT URI と、そのバージョンそのもののハッシュである CID が含まれます。

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"
  }
}

ボットが聞き取るしくみ

決まった時間に投稿するだけのボットも多くあります。一方で、メンションや返信、新しいフォロワー、あるいはネットワークのどこかで起きた出来事に反応するボットもあります。聞き取る方法は、主に 2 つです。

  • 通知。 ボットはときどき自分の通知を取りに行き(人がアプリで見るのと同じ一覧です)、見つけたメンションや返信に答えます。プロトコルのボットのチュートリアルは、この方法です。
  • ファイアホースまたは Jetstream。 ネットワーク全体を見張るボット(たとえば特定のキーワードを含む投稿を探すボット)は、ストリームを読みます。リレーの ファイアホース はバイナリで、イベントは CBOR で符号化され、運ばれるレコードは DAG-CBOR です。Jetstream は同じ変更を、ボットが求めるものに絞ったうえで、WebSocket 経由のシンプルな JSON で送ります。Bluesky は、ほとんどの開発者に Jetstream を勧めています。

どちらのストリームも公開されており、読むのにアカウントもパスワードも要りません。ボットがサインインするのは、書き込むときだけです。

もっと詳しく。 通知は、ボットの PDS を通して AppView の app.bsky.notification.listNotifications から取得します。ファイアホースは、リレーの com.atproto.sync.subscribeRepos です。Jetstream は、app.bsky.feed.post のようなコレクションや、アカウントで絞り込めます。

ボットのループ

まとめると、ほとんどのボットは同じループで動いています。

  1. スケジュールや出来事タイマー、メンション、Jetstream で見つけた投稿など。
  2. ボットのコードサーバー、ノートパソコン、定期実行のジョブなど、どこでも動きます。
  3. ボットの PDS投稿をボットのリポジトリに保存します。
  4. ネットワークリレーと AppView が投稿を届けます。
  5. 読者タイムライン、フィード、通知で投稿を目にします。

返信やメンションは通知としてボットに戻り、ループがまた始まります。

ボットのループ:スケジュールや出来事がボットのコードを動かし、コードが PDS に書き込みます。ネットワークがその投稿を読者に届けます。

それぞれの段階は別々の要素です。ボットのコードはサーバー、ノートパソコン、定期実行のジョブなど、どこでも動かせます。一方、アカウントと投稿は PDS にあります。

ボットであることを伝える

プロトコルがボットに自動で印を付けることはありません。自動化されていることは、アカウント自身が伝えます。よく使われる方法は 3 つあり、組み合わせると効果的です。

  • 自動化ラベル。 Bluesky アプリでは、設定 → アカウント → 自動化ラベル でオンにできます。するとアプリは、プロフィールと投稿で、アカウント名の横にラベルを表示します。中身は、アカウントのプロフィールレコードにある bot の セルフラベル で、プロトコルのボットのチュートリアルもベストプラクティスとして勧めています。
  • プロフィール。 自動化されたアカウントであること、何を投稿するか、誰が運営しているかを自己紹介に書きます。
  • ハンドル。 プロフィールを開く前から「ボット」とわかる名前にします。

ボットの見つけ方

ボットは、ほかのアカウントと同じように見つけられます。検索、返信やリポスト、カスタムフィードやリスト、そして スターターパック です。スターターパックは、おすすめのアカウントとフィードをまとめたリストで、Bluesky アプリで作ってリンクとして共有できます。

ルール

ボットは誰もが従うルールに加えて、ボットにとって特に大事な制限にも従います。このページではそれらを言い換えません。出典で読んでください。

  • Bluesky の コミュニティガイドライン と 利用規約:Bluesky のサービス上で、自動化されているかどうかにかかわらず、すべてのアカウントに適用されます。
  • Bluesky の 開発者ガイドライン:Bluesky のサービスとやり取りするアプリやサービス向けで、自動化された、あるいは大量のインタラクションやスパムボットをスパムと定義しています。
  • Bluesky の PDS とサービスの レート制限:主に投稿の多いボットに関係します。
  • ボットのためのベストプラクティス:Bluesky のルールへのリンクを添えたチェックリストです。

Bluesky.bot での使われ方

Bluesky.bot はボットのためのサービスです。各ボットに Bluesky.bot のドメインから提供する name.bluesky.bot のハンドルを付けるので、ボットは DID も PDS もコードもそのままです。また、ボットを公開ディレクトリに載せ、チェックアップで作成者に自動化ラベルをオンにするよう促します。さらに、ラベラーが有効な *.bluesky.bot のハンドルを持つアカウントに bot ラベルを付けます。Bluesky のボットとは?

よくある質問

Bluesky では自動化されたアカウントを使えますか?
はい。Bluesky のコミュニティガイドラインと利用規約に従い、自動化された、あるいは大量のインタラクションやスパムボットをスパムとする開発者ガイドラインを守り、レート制限の範囲内であれば、自動化されたアカウントもほかと同じように投稿できます。いずれも、このページの「ルール」にリンクがあります。
ボットには特別なアカウントが必要ですか?
いいえ。ボットは普通のアカウントを使います。通常は作成者のアカウントではなく、ボット専用のアカウントです。アプリパスワードか OAuth でサインインするので、アカウントのメインのパスワードをコードに書かずに済みます。自動化ラベルをオンにすれば、自動化されていることも示せます。

出典

この解説の根拠となる公式ページです(英語)。

ボットに見分けやすいハンドルを

Bluesky.bot は、ボットアカウントに無料の name.bluesky.bot ハンドルを提供し、ネットワーク全体に証明したうえで、公開ボットディレクトリに掲載します。