AT Protocolのリポジトリを理解する
リポジトリ、コレクション、キー、CID、ファイル参照の意味、取得するデータとリクエストの保護、アカウントデータのエクスポートを説明します。
リポジトリとコレクション
アカウントの個人データサーバー(PDS)が公開リポジトリを保持します。コレクションはスキーマのNSIDでレコードを分類します。app.bsky.feed.postは投稿、app.bsky.graph.followはフォローです。未知のNSIDはBluesky以外のスキーマかもしれません。
リポジトリエクスプローラーはハンドル、DID、AT URIに対応します。コレクションと50件単位のレコードを新旧両順で閲覧できます。URLはq、cursor、reverse=1を使い、JavaScriptなしでも移動できます。
キー、CID、参照
AT URIはリポジトリ、コレクション、キーを指定します。CIDは内容の特定バージョンを識別します。多くのキーは時刻を含むTIDですが、selfなどのキーにはTID時刻がありません。AT URI変換とTIDデコーダーも参照してください。
JSONツリーはテキストをエスケープし、256 KiB、深さ20までに制限します。AT参照はレコード、DIDはWhoisへリンクします。ファイル参照にはCID、MIME、サイズを表示します。取得はPDSへの明示的な外部リンクです。任意のPDSの画像を自動では読み込みません。
公開データの取得と保護
DIDドキュメントを解決してリレーを確認し、PDSのcom.atproto.repo.describeRepo、com.atproto.repo.listRecords、com.atproto.repo.getRecordを呼びます。全リクエストにSSRF保護、HTTPS、4秒の上限、リダイレクト禁止を適用します。本文は1 MiB、単一レコードは256 KiBまでです。プライベートアドレスは拒否します。キャッシュは5分、コレクションは1分です。書き込みは行いません。
エクスポートをローカルで開く
Blueskyの設定 → アカウント → データをエクスポートを選びます。開発者はPDSからcom.atproto.sync.getRepo?did=…で取得できます。生成された.carをCARエクスプローラーで開きます。ローカルワーカーのみで動作し、アップロード、API、MCP、ファイル操作のアクセス解析はありません。別ページに移動するときだけ参照を開いてください。
CAR v1は最大512 MiB、250,000レコード、重複を含む500,000セクション、2,000コレクションです。内容を蓄積する前に、ヘッダーは64 KiB、ブロックは1 MiBに制限します。保持するブロックと復元したインデックスのメタデータは、別途512 MiBの計上上限で管理します。Workerは64 KiBずつ読み取り、異なるブロックのハッシュを1回計算し、重複の内容が一致するか確認します。各処理は60秒までです。中止後も読み込み済みWorkerを再利用し、通信は発生しません。コレクションとレコードは100件ずつ表示します。端末メモリによって実用上の上限は小さくなります。署名は未検証と表示します。検索とJSON Linesはローカル処理で、ZIPとblobの一括エクスポートは含みません。