RSS・Atom の記事を Bluesky に投稿する

新着記事を確認してから投稿します。再利用できる RSS/Atom インポーターとローカルキューを使い、送信と復旧を明示的な手順で進めます。

著者:Bluesky.botチーム

公開日:
更新日:
確認日:

このチュートリアルで作るもの

RSS 2.0 または Atom 1.0 の新着記事を、小さな Bluesky 投稿キューに取り込みます。最初に内容をプレビューし、既存の記事を投稿せずに記録してから、明示的に送信を有効にします。これは RSS から Bluesky への投稿です。Bluesky のカスタムフィード作成や、Bluesky アカウントを RSS リーダーで読む方法とは異なります。

Python 3.11 以降、永続的なローカルディスク、自分が管理するボットアカウント、リンクを配信する許可のあるフィードが必要です。サンプルはテキストと記事リンクを扱います。画像、返信、メンション、相対 URL、複雑な HTML タイトルは別の実装が必要です。Bluesky.bot はガイドとソースを提供し、プログラムは利用者のマシンで実行します。

1. 再利用できるキットを取得してテストする

MIT ライセンスの投稿レシピをダウンロードし、新しいフォルダーに展開します。キュー、RSS インポーター、RSS/Atom のテストデータ、オフラインテストが含まれます。認証情報や有効化されたワークフローは含まれません。

bash
tar -xzf bluesky-bot-recipes.tar.gz
cd bluesky-bot-recipes
python3 -m unittest -v test_recipes.py

テストは投稿と復旧を模擬します。実際のアカウントで認証付き投稿が成功した証明ではありません。プレビューだけなら Bluesky SDK のインストールも不要です。

2. 過去の記事を投稿せず初期状態を記録する

サンプル RSS を初期登録し、新しい項目を含む Atom をプレビューします。

bash
python3 rss_to_queue.py sample-rss.xml --feed-id my-blog --db .state/rss.sqlite3 --baseline
python3 rss_to_queue.py sample-atom.xml --feed-id my-blog --db .state/rss.sqlite3

最初のコマンドは RSS の識別子を二つ記録しますが、投稿を作成しません。次のコマンドは Atom の新着一件を準備し、音声の添付リンクではなく記事リンクを選びます。GUID や Atom ID は不透明な識別子であり、必ずしも URL ではありません。

実際のフィードでは XML を feed.xml に保存し、別のデータベースで 一度だけ初期登録します。--feed-id は変えずに使える名前にします。取得のたびに初期登録すると、新着まで既存項目として扱われます。

bash
curl --fail --location --max-time 20 --max-filesize 5242880 "https://example.org/feed.xml" --output feed.xml
python3 rss_to_queue.py feed.xml --feed-id my-blog --db .state/live.sqlite3 --baseline

例のアドレスを自分のフィードに置き換えてください。インポーターが読むのはローカル XML で、アカウントへのログインは行いません。取得サイズを制限し、信頼できるフィードを使います。

3. 新着を確認してからキューに追加する

フィードが更新されたら XML を再取得し、プレビューを確認します。

bash
python3 rss_to_queue.py feed.xml --feed-id my-blog --db .state/live.sqlite3
python3 rss_to_queue.py feed.xml --feed-id my-blog --db .state/live.sqlite3 --enqueue
python3 posting_queue.py --db .state/live.sqlite3 run

--enqueue は保留中のジョブと記事の識別子を同じトランザクションで保存します。この時点では投稿しません。同じ項目を再取り込みしてもジョブは一つです。オプションなしの run は、期限を迎えた本文を表示するだけで配信状態を変更しません。

最初は一回一件にします。--limit 5 は上限であり、推奨頻度ではありません。新しい順に並ぶ一般的なフィードでは、文書内に残っている未取得項目のうち古い側から処理しますが、あらゆるフィードの時系列順を保証しません。記事が消える前に取得できる間隔を選んでください。

タイトルや絶対 HTTP(S) リンクがない項目、保守的な上限の 300 コードポイントを超える本文は、診断を出してスキップします。URL を切るのではなくタイトルを意図的に短くしてください。入力は 5 MiB までで、DTD、エンティティ、NUL バイトを拒否します。記事全文の取得や画像生成はしません。

このキットではフィードの日時(pubDate、published、updated)を予約投稿の指示に使いません。有効な新着には観測時刻を設定します。公開前の制限や将来の投稿日時が必要なら、スケジュールの手順で期限を明示したジョブを準備してください。

4. 自分のボットに接続し一件の投稿を確認する

アプリパスワードのガイドに従い、ボット専用の認証情報を用意します。メインパスワードは使いません。他人のアカウントを接続するサービスでは OAuth を使います。

bash
python3 -m venv .venv
. .venv/bin/activate
python -m pip install -r requirements.txt

BLUESKY_HANDLE と BLUESKY_APP_PASSWORD をローカル環境または保護した設定ファイルに置きます。bsky.social 以外にあるアカウントは、現在の HTTPS PDS を BLUESKY_SERVICE に設定します。フィード、JSON、Git、画面写真、端末の履歴に秘密を残さないでください。

bash
python3 posting_queue.py --db .state/live.sqlite3 run --publish
python3 posting_queue.py --db .state/live.sqlite3 status

--publish を指定すると初めてセッションを開き、期限を迎えたジョブを投稿します。確認できた応答は sent となり、at:// URI を保存します。自動化する前に Bluesky で本文とリンクを確認してください。データベースはボットの DID に結び付きます。アカウントごとに別のものを使います。

5. 状態を保持し結果未確定の送信を確認する

投稿スケジュールのチュートリアルで、永続ディスク、cron、タイムゾーン、取消し、再起動を確認します。新しい CI 実行環境は前回の状態を自動では保持しません。

ネットワーク呼出しより前に publishing を保存するため、別のワーカーが同じジョブを取得しません。例外や応答喪失は review、異常終了は publishing を残す場合があります。タイムアウト前にサーバーが投稿を受理した可能性があるため、自動再送しません。明示的に再試行する場合も予約済みのレコードキーを保持します。

bash
python3 posting_queue.py --db .state/live.sqlite3 status
python3 posting_queue.py --db .state/live.sqlite3 cancel JOB_ID

取消せるのは pending のジョブだけです。review や publishing ならワーカーを止め、status のキーで公開レコードをリポジトリエクスプローラーから確認します。本文を照合してから状態を解決してください。結果が分からなければ確認待ちのままにします。明示的な解決コマンドは README にあります。データベース喪失後の厳密な一回配信は保証しません。

トラブル対処と開始前チェック

  • ジョブがない: 初期登録が一度だけか、同じフィード ID とデータベースか、XML が更新済みか、記事リンクが正しいかを確認します。
  • 記事が重複する: 編集のたびに配信元が GUID を変更していないか調べます。識別子の変更やデータベース削除は重複追跡を無効にします。
  • 記事がない: スキップの診断と、取得前に記事がフィードから消えていないかを確認します。フィードは完全な履歴ではありません。
  • 認証に失敗する: アカウント、専用パスワード、PDS を確認します。Python の最初のボットで SDK の基本を読めます。
  • 制限や結果未確定: 停止して状態を調べ、サーバーの待機指示を守ります。ログインの連打や新しい ID で再送を強制しません。

無人運転の前に、既存記事の記録、新着のプレビュー、意図した一件のテスト、リンク確認、バックアップ、再起動を試します。自動化を明示し、運用のベストプラクティスに従ってください。元の著者へのリンクを残します。RSS の公開だけで記事全文の転載許可が得られるわけではありません。

コード、テストデータ、テストは MIT で再利用でき、必須の被リンク条件はありません。自発的な引用は歓迎しますが、公開しただけで被リンク、順位、アクセス数が保証されることはありません。

出典