無料のBluesky API:キー、制限、実行例
公開データの読み取りにBlueskyのパスワードは不要です。直接の取得にはAppView、複数の確認をまとめるには当サイトの無料ツールを使えます。
著者:Bluesky.botチーム
- 公開日:
- 更新日:
- 確認日:
APIキーは必要ですか
多くの公開プロフィール、フィード、投稿の読み取りには不要です。Blueskyは public.api.bsky.app に公開AppViewを提供しています。ただし、これはAT Protocolのサービスの一つであり、すべてのAPIではありません。投稿の書き込みにはアカウントの認可が必要で、通常はそのPDSへ送ります。当サイトのツールAPIは投稿、フォロー、削除を行いません。
一つのXRPCメソッドで足りる場合はBlueskyを直接利用できます。識別情報の確認ではDNS、HTTPS、DID文書、AppViewの回答が必要になることがあります。当サイトのツールは観測結果をまとめ、相違点を説明します。無料の作成者トークンで利用枠を増やせますが、匿名の公開ツールにトークンは不要です。
各エンドポイントの回答
表は実行するツールの登録情報から生成します。コストは利用枠の重みであり、料金や外部リクエスト数の保証ではありません。キャッシュにより外部アクセスが不要な場合も、識別情報の確認に複数のアクセスが必要な場合もあります。
| ツール | エンドポイント | HTTPキャッシュ | 利用枠のコスト |
|---|---|---|---|
| 自動化の公開宣言チェッカー アカウントが公開する自動化の印を確認します。 | GET /api/v1/tools/bot-checker | 60秒 | 3単位 |
| DID 検索 Bluesky のハンドルの裏にある DID を調べる。 | GET /api/v1/tools/did-finder | 60秒 | 1単位 |
| ハンドル検索(DID からハンドル) DID の裏にあるハンドルを調べる。 | GET /api/v1/tools/handle-finder | 60秒 | 1単位 |
| Bluesky whois ハンドルや DID について公開されているすべて。 | GET /api/v1/tools/whois | 60秒 | 3単位 |
| アカウント年齢チェッカー アカウントがいつ Bluesky に参加したかを調べる。 | GET /api/v1/tools/account-age | 60秒 | 1単位 |
| AT URI コンバーター bsky.app のリンクと at:// の URI を相互に変換。 | GET /api/v1/tools/at-uri-converter | 60秒 | 1単位 |
| TID デコーダー レコードキーに隠れた日付を読む。 | GET /api/v1/tools/tid-decoder | 1年 | 1単位 |
| 投稿の文字数カウンター Bluesky と同じ方法で投稿の文字数を数えます。 | GET /api/v1/tools/character-counter | 1年 | 1単位 |
| リッチテキストのファセットビルダー メンション、リンク、ハッシュタグをバイト位置つきで。 | GET /api/v1/tools/facet-builder | キャッシュなし | リクエストによる |
| 独自ドメインのハンドルチェッカー ハンドルが無効になる理由と、その直し方がわかります。 | GET /api/v1/tools/custom-handle-checker | キャッシュなし | 2単位 |
| ハンドルの空き状況チェッカー その名前は Bluesky で空いていますか? | GET /api/v1/tools/handle-availability | キャッシュなし | 1単位 |
| PLC 履歴ビューア アカウントのハンドル変更、サーバー移行、鍵の変更をすべて。 | GET /api/v1/tools/plc-history | 5分 | 2単位 |
| スターターパック分析 スターターパックのメンバーを、数字やボットと一緒に。 | GET /api/v1/tools/starter-pack-analyser | 5分 | リクエストによる |
| 投稿とスレッドのビューア 公開されている Bluesky の投稿やスレッドを、アカウントなしで読めます。 | GET /api/v1/tools/post-viewer | 60秒 | 3単位 |
| フィードインスペクター カスタムフィードをプレビューし、何も表示されない理由を調べます。 | GET /api/v1/tools/feed-inspector | キャッシュなし | 3単位 |
| ラベルインスペクター 誰がラベルを付けたか、その意味を確認できます。 | GET /api/v1/tools/label-inspector | 5分 | リクエストによる |
| フォロワー一覧のエクスポート 公開フォロワー・フォロー一覧をCSVでバックアップ。 | GET /api/v1/tools/follower-export | 5分 | 2単位 |
| リポジトリエクスプローラー アカウント自身のサーバーにある公開データを閲覧します。 | GET /api/v1/tools/repo-explorer | 5分 | 2単位 |
実際に実行した3つの例
公式アカウントを対象に実行した例です。結果には取得日時があり、固定の作り物ではありません。公開データは変わることがあります。Pythonには説明的なUser-Agentを指定しています。この確認では、標準のPython-urllibのエージェントが配信網からHTTP 403を受け取りました。
curl --fail --silent --show-error 'https://bluesky.bot/api/v1/tools/did-finder?handle=bluesky.bot'const response = await fetch(
"https://bluesky.bot/api/v1/tools/did-finder?handle=bluesky.bot",
);
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(JSON.stringify(await response.json()));import json
from urllib.request import Request, urlopen
request = Request('https://bluesky.bot/api/v1/tools/did-finder?handle=bluesky.bot', headers={'User-Agent': 'Bluesky.bot-docs/1.0 (+https://bluesky.bot/tools/api)'})
with urlopen(request, timeout=10) as response:
print(json.dumps(json.load(response)))入力
curl --fail --silent --show-error 'https://bluesky.bot/api/v1/tools/did-finder?handle=bluesky.bot'
取得した出力
{
"tool": "did-finder",
"url": "https://bluesky.bot/tools/did-finder",
"result": {
"status": "found",
"handle": "bluesky.bot",
"unicodeHandle": null,
"dns": {
"status": "found",
"did": "did:plc:ulmk4vmvoobkemd3w2tkwhu5"
},
"https": {
"status": "none"
},
"appview": {
"status": "found",
"did": "did:plc:ulmk4vmvoobkemd3w2tkwhu5"
},
"did": "did:plc:ulmk4vmvoobkemd3w2tkwhu5",
"method": "dns",
"verified": true,
"claimedHandle": null,
"warnings": []
}
}入力
const response = await fetch('https://bluesky.bot/api/v1/tools/did-finder?handle=bluesky.bot');
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(JSON.stringify(await response.json()));取得した出力
{
"tool": "did-finder",
"url": "https://bluesky.bot/tools/did-finder",
"result": {
"status": "found",
"handle": "bluesky.bot",
"unicodeHandle": null,
"dns": {
"status": "found",
"did": "did:plc:ulmk4vmvoobkemd3w2tkwhu5"
},
"https": {
"status": "none"
},
"appview": {
"status": "found",
"did": "did:plc:ulmk4vmvoobkemd3w2tkwhu5"
},
"did": "did:plc:ulmk4vmvoobkemd3w2tkwhu5",
"method": "dns",
"verified": true,
"claimedHandle": null,
"warnings": []
}
}入力
import json
from urllib.request import Request, urlopen
request = Request('https://bluesky.bot/api/v1/tools/did-finder?handle=bluesky.bot', headers={'User-Agent': 'Bluesky.bot-docs/1.0 (+https://bluesky.bot/tools/api)'})
with urlopen(request, timeout=10) as response:
print(json.dumps(json.load(response)))取得した出力
{
"tool": "did-finder",
"url": "https://bluesky.bot/tools/did-finder",
"result": {
"status": "found",
"handle": "bluesky.bot",
"unicodeHandle": null,
"dns": {
"status": "found",
"did": "did:plc:ulmk4vmvoobkemd3w2tkwhu5"
},
"https": {
"status": "none"
},
"appview": {
"status": "found",
"did": "did:plc:ulmk4vmvoobkemd3w2tkwhu5"
},
"did": "did:plc:ulmk4vmvoobkemd3w2tkwhu5",
"method": "dns",
"verified": true,
"claimedHandle": null,
"warnings": []
}
}制限と適切な利用
匿名利用:60秒あたり60単位、24時間あたり2000単位。有効な作成者トークンの所有者に稼働中のボットが1つ以上ある場合、両方の上限が10倍になります。
各呼び出しは両方の利用枠からツールの重みを消費します。サーバー検索には共通の外部アクセス枠もあるため、個別の枠が残っていても複雑な確認が拒否される場合があります。
HTTP 429にはRetry-Afterが含まれます。入力不正は400、結果なしは404、外部サービスの失敗は502で、API v1のエラー形式を使います。公開GETは別オリジンから読み取れます。拒否されたトークンを匿名アクセスへ黙って切り替えることはありません。
ツール名と経路を集計し、入力値は集計しません。ツールの入力を含むクエリはアクセスログから除外します。秘密、非公開投稿、他人の認証情報は送らないでください。
無料のベストエフォートサービスで、稼働率のSLAはありません。キャッシュ可能な結果を再利用し、再試行の待ち時間を守ってください。別の用途はお問い合わせください。
別の方法が適している場合
大量の投稿、ネットワーク全体のリアルタイムイベント、常時接続には、AT ProtocolのサービスやJetstreamを直接利用してください。取得範囲を制限したこのAPIは全体ストリームの代替ではありません。書き込みにはアカウントの認可を受けたクライアントを使います。AIクライアントにはMCPサーバーもあります。APIリファレンスとツールのリファレンスで引数とエラーを確認できます。
ターミナルを使う場合は、Blueskyのコマンドラインクライアント比較をご覧ください。公開済みのbsbotのバージョンと現在の制限も説明しています。
よくある質問
Bluesky APIは無料ですか
Blueskyの公開AppViewでは多くの読み取りが認証やキーなしで可能ですが、制限があります。当サイトの公開ツールAPIも無料です。
このAPIから投稿できますか
できません。ツールAPIは公開情報の読み取りと計算を行います。アカウントが認可した書き込みには別のクライアントを使います。
Bluesky.botトークンは必要ですか
公開ツールには不要です。対象となる作成者トークンで利用枠を増やせますが、外部サービスの制限は残ります。
引数とエラー形式はどこにありますか
開発者ドキュメントのAPIとツールのリファレンス、およびOpenAPI文書を参照してください。