steipete/birdclaw

解決的問題

Birdclaw 提供您 Twitter/X 歷史記錄的本地優先、可搜尋的歸檔。它允許使用者在不依賴雲端後端的情況下，保留自己的推文、私訊和關注圖譜副本，確保長期存取自己的數位歷史。

運作方式

此工具將 Twitter/X 歸檔（ZIP 檔案）中的資料匯入本地 SQLite 資料庫。使用 FTS5 實現推文與私訊的快速本地搜尋。為保持資料最新，可選擇透過 xurl 或私人 bird 安裝同步即時資料。系統透過三種介面公開這些資料：Web 應用程式、命令列介面（CLI），以及可選的唯讀 Model Context Protocol（MCP）伺服器，供 AI 代理使用。

適用對象

希望完全掌控自己 Twitter/X 資料的使用者、需要可搜尋本地資料庫來管理社群媒體歷史的研究人員，以及希望為 AI 代理提供唯讀存取其快取推文歷史的開發者。

主要亮點

• 使用 SQLite 實現本地優先儲存，保障隱私與離線存取。
• 支援推文、私訊、讚、書籤與個人資料的冪等歸檔匯入。
• 集成 Web 應用程式與 CLI，用於瀏覽與搜尋歷史記錄。
• 提供唯讀 MCP 伺服器，向 LLM 暴露快取的推文搜尋與串連工具。
• 產生 Git 友好的決定性 JSONL 分片，用於備份。