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 分片用于备份。