steipete/birdclaw

解决的问题

Birdclaw 为用户提供了一种本地拥有 Twitter/X 历史记录的方式。它解决了依赖云后端来访问可搜索的推文、私信、收藏内容和关注图谱档案的问题，实现了社交数据管理的私密化、本地优先的方案。

工作原理

该工具将 Twitter/X 档案导入本地 SQLite 数据库，使用 FTS5 实现快速本地搜索。可选择通过同步（由 xurl 或私有 bird 安装处理）补充静态档案的实时数据。用户可通过网页应用、命令行界面（CLI）或只读 MCP 服务器与数据交互，用于外部工具集成。

适用人群

适用于希望拥有自托管、可搜索的 X 账号历史备份，以及更倾向于本地数据所有权而非云访问的用户。

主要亮点

• 本地优先存储：使用 SQLite 存储所有数据，确保历史记录保存在用户设备上。
• 多接口支持：提供网页应用、用于研究和定时任务的 CLI，以及用于外部工具集成的只读 MCP 服务器。
• 幂等导入：档案导入会合并数据，不会产生重复。
• 注重隐私：默认情况下本地读取不会触发网络流量，且网页服务器监听环回地址。
• 确定性备份：支持可通过 Git 跟踪的 JSONL 分片。