steipete/birdclaw

해결하는 문제

Birdclaw는 사용자의 Twitter/X 기록을 로컬 우선, 검색 가능한 아카이브로 제공합니다. 클라우드 백엔드에 의존하지 않고, 트윗, DM, 팔로우 그래프의 자체 복사본을 유지할 수 있어 디지털 기록에 장기적으로 접근할 수 있도록 보장합니다.

작동 방식

이 도구는 Twitter/X 아카이브(ZIP 파일)의 데이터를 로컬 SQLite 데이터베이스로 가져옵니다. 트윗과 DM의 빠른 로컬 검색을 위해 FTS5를 사용합니다. 데이터를 최신 상태로 유지하기 위해 xurl 또는 개인적인 bird 설치를 통해 실시간 데이터를 선택적으로 동기화할 수 있습니다. 시스템은 웹 애플리케이션, 명령줄 인터페이스(CLI), 그리고 AI 에이전트를 위한 선택적 읽기 전용 Model Context Protocol(MCP) 서버의 세 가지 인터페이스를 통해 데이터를 노출합니다.

대상 사용자

Twitter/X 데이터에 대한 완전한 소유권과 로컬 제어를 원하는 사용자, 소셜 미디어 기록을 검색 가능한 로컬 데이터베이스로 필요로 하는 연구자, AI 에이전트가 캐시된 트윗 기록에 읽기 전용으로 접근할 수 있도록 제공하고자 하는 개발자.

주요 기능

• 프라이버시와 오프라인 접근을 위해 SQLite를 사용한 로컬 우선 저장소.
• 트윗, DM, 좋아요, 북마크, 프로필의 인풋을 반복 실행 가능하게(이데모텐트) 처리.
• 기록 탐색 및 검색을 위한 통합 웹 앱과 CLI.
• LLM에 캐시된 트윗 검색 및 스레드 도구를 공개하는 읽기 전용 MCP 서버.
• Git 친화적인 백업을 위한 결정론적 JSONL 샤드.