bluesky-research

Bluesky の調査

Bluesky の公開プロフィール、投稿者フィード、投稿スレッド、フォロワー／フォロー中の グラフ、アカウント検索、トレンドトピックを確認できます。Crawlora API から 正規化された JSON として取得するため、アプリのスクレイピングや AT Protocol クライアントは不要です。

このスキルを使う場面

• 「Bluesky で のプロフィール／フォロワー数は？」
• 「Bluesky で の最近の投稿を取得して。」
• 「この Bluesky の投稿への返信／スレッドを表示して。」
• 「Bluesky で をフォローしているのは誰？」／「 は誰をフォローしている？」
• 「Bluesky で に関するアカウントを検索して。」
• 「今、Bluesky でトレンドになっているのは？」

セットアップ（初回のみ）

• https://crawlora.net で無料の Crawlora API キーを取得します（月 2,000 クレジット、カード不要）。
• ヘルパーを実行する前に、環境変数に CRAWLORA_API_KEY を設定します。
• ヘルパーは環境変数から CRAWLORA_API_KEY を読み込み、https://api.crawlora.net/api/v1 にリクエストを送信します。キーがない、または無効な場合は 401 が返されます。

仕組み

目的に応じて選択します。

1. プロフィール — /bluesky/profile（actor = ハンドルまたは DID）。表示名、 説明、アバター／バナー、フォロワー数／フォロー数／投稿数。
2. 投稿者フィード — /bluesky/author-feed（actor、任意の cursor、 limit）。アカウントの投稿を新しい順に表示するページです。エンゲージメント数と、 添付されている画像／リンクカード／引用投稿も含まれます。
3. 投稿スレッド — /bluesky/post-thread（uri = 投稿の at:// URI、 任意の depth）。投稿と、その入れ子になった返信、返信投稿の場合は親投稿の連鎖も取得します。
4. フォロワー／フォロー中のグラフ — /bluesky/followers と /bluesky/follows （actor、任意の cursor、limit）。アカウントのフォロワー、またはそのアカウントがフォローしているアカウントをページ単位で取得します。
5. アカウントの検索 — /bluesky/search-actors（q、任意の cursor、 limit）。表示名、ハンドル、プロフィールの説明を対象に、クエリに一致するアカウントを検索します。
6. トレンド — /bluesky/trending-topics（パラメーターなし）。Bluesky の現在の トレンドトピックとおすすめフィードを取得します。

エンドポイント、メソッド、パラメーターの一覧は、reference/endpoints.md を参照してください。

API の呼び出し

# Profile + author feed:
scripts/crawlora.sh /bluesky/profile actor=bsky.app | jq '.'
scripts/crawlora.sh /bluesky/author-feed actor=bsky.app limit=20 | jq '.'

# Search + trending:
scripts/crawlora.sh /bluesky/search-actors q="web scraping" | jq '.'
scripts/crawlora.sh /bluesky/trending-topics | jq '.'

すべてのリクエストには scripts/crawlora.sh を使用してください。API キーがコマンドライン引数に含まれないようにできます。

エンドポイントリファレンス

このスキルで使用する Bluesky のすべてのエンドポイントについては、reference/endpoints.md を参照してください。

使用例

• アカウントの確認： ハンドルに対して /bluesky/profile と /bluesky/author-feed を使い、 フォロワー数、投稿頻度、最近のエンゲージメントを確認します。
• スレッドの取得： 投稿者フィードまたは search-actors の結果から投稿の at:// URI を取得し、 /bluesky/post-thread で返信ツリー全体を読み込みます（投稿自体が返信の場合は親投稿の連鎖も取得します）。
• ネットワークのマッピング： アカウントの /bluesky/followers と /bluesky/follows をページ単位で取得し、 フォロワー／フォロー関係のグラフを作成します。

注意事項と制限

• クレジット／成功時のみ課金： 2xx の場合のみ課金されます。無料プランは月 2,000 クレジットです。 キーは https://crawlora.net で取得してください。
• 公開データのみ — AT Protocol の公開かつ認証不要の AppView API から取得する公開プロフィール／投稿が対象です。ログインは不要で、非公開コンテンツは取得できません。
• セキュリティ： キーは CRAWLORA_API_KEY にのみ保存してください。コードへの直接記述、クエリパラメーターへの指定、コミットはしないでください。
• リスト形式のエンドポイント（author-feed、followers、follows、search-actors）は カーソル方式でページ分割されています。最初のページ以降を取得するには、返された cursor を使用してください。
• post-thread には bsky.app の URL ではなく、完全な at:// 投稿 URI が必要です。 投稿者フィードまたは search-actors の結果にある投稿の uri フィールドから取得してください。
• trending-topics にパラメーターはありません。この一連のエンドポイントの中で最も安定性が低いことが明示されており、 Bluesky は予告なく仕様を変更する場合があります。