Bluesky/atproto入門の手引き

By 山貂 (@yamarten.bsky.social)
Published:

Blueskyとかatprotoとか呼ばれるものには様々な側面があるので、区分した上で適切な公式資料へ誘導しようという試み。

プロジェクトとして(bluesky)

Twittter社が2019年に立ち上げたプロジェクト。\ 当時の目標はTwitterが参加できる標準仕様を選定/策定すること。

Twitter社自体は目標設定と資金提供が主で、具体的な調査や検討は外部協力者を募って実施していた。\ この時集まった協力者の一部はdSocialCommnsという別団体に独立している。

立ち上げ時の発表 当時の成果や参加者

会社として(Bluesky PBC)

blueskyプロジェクトのリーダーとして抜擢されたJay Graberが目的達成のために2021年に立ち上げた会社。\ 当初はPBLLC(公益合同会社)だったが、2023年にPBC(公益株式会社)に転換した。

数十名(+100名程度のモデレータ)でプロトコル開発、インフラ実装運用、サービス開発運営、atproto開発者への援助などを行なっている。\ 2022年まではTwitter社の資金提供を受けており、Jack Dorseyが取締役に名を連ねていたが、現在は縁が切れており、主にベンチャーキャピタルの資金提供で運営されている。

企業サイト 公式Blueskyアカウント

企業に関する情報の多くはブログで発信される。といってもあまり多くはないが。\ 経緯や体制はWikipediaやインタビューの方がまとまっている。

SNSとして(Bluesky Social)

Bluesky社が開発運営するマイクロブログサービス。\ アカウントサーバー(bsky.social)、APIサーバー(api.bsky.app)、ウェブクライアント(bsky.app)等から構成される。多くの利用者は全部セットで使っているが、一部だけの利用も可能。

Bluesky社はプロトコル開発とサービス運営を両輪とする方針で、サービス運営時の課題をプロトコルにフィードバックする形で開発を続けている。

ウェブクライアント 利用規約 クライアント一覧(有志) ツール一覧(有志)

機能説明の類は各機能リリース時のブログ記事に頼っているため、実はサードパーティクライアントの方がドキュメントは充実している傾向にある。\ 利用者による情報も役立つが、古いと仕様が変わっていたりするので、半年くらいを目安に切り捨てることを推奨する。

クライアントAPI仕様として(bsky lexicon)

Bluesky Socialを利用するためのAPIの多くはBluesky Social固有のものだが、ここを指して「atproto」と呼ばれることもある。\ 利用に際してatproto概念の理解が必要な部分があり、またBluesky互換APIサーバーが作れるようにスキーマがatprotoの作法で定義されているため、誤りというわけでもない。

ちなみに、Bluesky互換のAPIサーバーを作る試みについては別記事も参照。

ドキュメント API/データスキーマ SDKまとめ(有志)

チュートリアル読めば通り一遍はできるようになるが、詳しいスキーマを知りたければjsonを読むしかないし、読む際はlexicon仕様の知識があった方がいい。\ HTTPリファレンスにはデータスキーマは無い点に注意。

細かい仕様(レート制限やモデレーション等)や仕様の意図(典型的には「createdAtはなぜ必要なのか」等)が知りたい場合はAdvanced Guideも参照。

マイクロブログプロトコルとして(Bluesky network)

語義は明確ではないが、大まかにBluesky Social APIサーバーから見える範囲[^socl]を指して「Bluesky」と呼ばれることがある。\ セルフホストのアカウントサーバー(PDS)からBluesky Social互換のデータ形式で投稿したアカウントとか。

[^socl]: Bluesky以外の互換APIサーバー(appview)の存在が考慮されることは無い印象がある。例えばsocl.isは独自のappviewを持つが、こっちでしか見えないアカウントはBluesky networkの外にあると判断されるだろう。実際にはsocl.isアカウントからの投稿も時々Bluesky appviewにインデックスされる場合があるので扱いが微妙だが。

このネットワーク構造はいかにもatprotoで定められていそうに思われがちだが、実はatproto仕様を見てもあまり書いていない。実際atprotoアプリケーションが全て同じ構造をしているとは限らない。ついでに、投稿やフォローといったマイクロブログ的な概念もatproto層には無く、Blueskyによる追加定義になっている。\ ということで、マイクロブログをターゲットにするならBluesky側のドキュメントの方が参考になる。

ネットワークアーキテクチャ 各コンポーネントのセルフホスト ネットワークのメンタルモデル

とはいえ、Bluesky Socialはatprotoのリファレンス実装としての役割もあるし、典型的な構造ではあるので、最近は少しずつatprotoドキュメントの方にもこのあたりの内容が盛り込まれつつある。\ おそらく2026年になったらこの辺に説明が現れるし、IETF I-Dでもまとめられている。

コミュニティとして

利用者視点ではSNS上のコミュニティこそが「Bluesky」になることもあるのだろうけど、語れることが無いので割愛。

人によって見える範囲も変わるので、身近な人に聞くのが一番。\ グローバルな動向が知りたい場合はConnected Places等が助けになりそう。

データ共有プロトコルとして(atproto)

atproto自体の説明は難しいが、大まかにデータの公開と同期のためのプロトコルという理解でいいだろう。\ bsky非互換のサービスを作りたいとか、インフラ(PDS, relay)を独自実装したい場合にここの知識が必要になる。

IETFで標準化を狙っているのもこのレイヤ。

公式ドキュメント Bluesky開発ブログ(内容はatproto寄り)

何かを作ることが目的なら、まずStatusphereとBlueskyで具体例を見てから気になるところだけ仕様を深掘りすることをお勧めする。

エコシステムとして(ATmosphere)

atproto周辺のエコシステムをATmosphere[^atmosphere]と呼ぶ。\ Bluesky非互換のatprotoサービスを含むものと思えばいい(Bluesky networkの意味で使われることもある)。

[^atmosphere]: 公式にはAtmosphereだが、一般名詞と区別がつきにくいので、ここでは発案時の表記であるATmosphereを採用する。

Blueskyで作ったアカウントが他にどんな用途に使えるか気になったらこの辺りを漁ればいい。\ サービス開発時のフレームワークやライブラリを探すにも役立つかもしれない。とはいえ、あまり綺麗にまとまっているものは無いが。

atprotoツール一覧(有志) 開発者コミュニティ

手前味噌だが、この記事も助けになるかもしれない。