無料の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-checker60秒3単位
DID 検索

Bluesky のハンドルの裏にある DID を調べる。

GET /api/v1/tools/did-finder60秒1単位
ハンドル検索(DID からハンドル)

DID の裏にあるハンドルを調べる。

GET /api/v1/tools/handle-finder60秒1単位
Bluesky whois

ハンドルや DID について公開されているすべて。

GET /api/v1/tools/whois60秒3単位
アカウント年齢チェッカー

アカウントがいつ Bluesky に参加したかを調べる。

GET /api/v1/tools/account-age60秒1単位
AT URI コンバーター

bsky.app のリンクと at:// の URI を相互に変換。

GET /api/v1/tools/at-uri-converter60秒1単位
TID デコーダー

レコードキーに隠れた日付を読む。

GET /api/v1/tools/tid-decoder1年1単位
投稿の文字数カウンター

Bluesky と同じ方法で投稿の文字数を数えます。

GET /api/v1/tools/character-counter1年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-history5分2単位
スターターパック分析

スターターパックのメンバーを、数字やボットと一緒に。

GET /api/v1/tools/starter-pack-analyser5分リクエストによる
投稿とスレッドのビューア

公開されている Bluesky の投稿やスレッドを、アカウントなしで読めます。

GET /api/v1/tools/post-viewer60秒3単位
フィードインスペクター

カスタムフィードをプレビューし、何も表示されない理由を調べます。

GET /api/v1/tools/feed-inspectorキャッシュなし3単位
ラベルインスペクター

誰がラベルを付けたか、その意味を確認できます。

GET /api/v1/tools/label-inspector5分リクエストによる
フォロワー一覧のエクスポート

公開フォロワー・フォロー一覧をCSVでバックアップ。

GET /api/v1/tools/follower-export5分2単位
リポジトリエクスプローラー

アカウント自身のサーバーにある公開データを閲覧します。

GET /api/v1/tools/repo-explorer5分2単位

実際に実行した3つの例

公式アカウントを対象に実行した例です。結果には取得日時があり、固定の作り物ではありません。公開データは変わることがあります。Pythonには説明的なUser-Agentを指定しています。この確認では、標準のPython-urllibのエージェントが配信網からHTTP 403を受け取りました。

curl
curl --fail --silent --show-error 'https://bluesky.bot/api/v1/tools/did-finder?handle=bluesky.bot'
JavaScript (Node.js 24)
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()));
Python 3
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文書を参照してください。

出典