steipete/birdclaw

何を解決するか

Birdclaw はユーザーが自らの Twitter/X ヒストリーをローカルに所有できる手段を提供します。ツイート、ダイレクトメッセージ、保存済み投稿、フォローグラフの検索可能なアーカイブにクラウドバックエンドに依存する問題を解決し、ソーシャルメディアデータ管理においてプライベートでローカルファーストのアプローチを可能にします。

動作方法

このツールは Twitter/X アーカイブをローカルの SQLite データベースにインポートし、FTS5 を使って高速なローカル検索を実現します。オプションで xurl またはプライベートな bird インストールに委任された同期により、静的アーカイブにライブデータを補完できます。ユーザーはウェブアプリ、コマンドラインインターフェース（CLI）、または外部ツール統合用の読み取り専用 MCP サーバーを通じてデータとやり取りできます。

対象ユーザー

自宅サーバーでホストする検索可能な X アカウントのバックアップを希望するユーザー、クラウドベースのアクセスよりもローカルデータ所有を好むユーザー向けです。

特徴

• ローカルファーストのストレージ: すべてのデータに SQLite を使用し、履歴がユーザーのマシン上に保存されることを保証します。
• 複数のインターフェース: ウェブアプリ、研究やスケジュールジョブ用の CLI、外部ツール統合用の読み取り専用 MCP サーバーを提供します。
• 同一性のあるインポート: アーカイブのインポートは重複を作成せずにデータをマージします。
• プライバシー重視: ローカル読み取りはデフォルトでネットワークトラフィックを発生させず、ウェブサーバーはローカルホストでリッスンします。
• 決定論的バックアップ: Git で追跡可能な JSONL シャードをサポートします。