Personal Archive Sqlite MCP

Birdclaw — Archivo personal de Twitter/X en SQLite (Local-first + MCP)

Resumen

Birdclaw importa archivos de Twitter/X en SQLite local, añade lecturas en vivo cacheadas, y expone el resultado vía web app, CLI y un servidor MCP solo lectura opcional. Para gente que quiere su propio historial buscable, DMs, posts guardados y grafo de seguidos sin backend cloud.

Uso (comandos reales del README)

# Instalación
brew install steipete/tap/birdclaw          # macOS/Linux
npm install -g birdclaw                       # alternativa npm

# Quick start demo
birdclaw init --demo
birdclaw search tweets "local-first" --limit 3 --json
birdclaw serve
# abrir http://localhost:3000

# Usar tu propio archivo
birdclaw import archive ~/Downloads/twitter-archive.zip --json

Patrones / Arquitectura

• Importa tweets, DMs, likes, bookmarks, perfiles, media y edges de follow a SQLite local.
• Imports idempotentes que mergean filas destino-only.
• Web app, CLI, y servidor MCP read-only opcional.
• Backend sin cloud: TODO local (searchable history, DMs, saved posts, follow graph).
• El demo (--demo) seedea tweets, DMs, perfiles y links sin credenciales ni requests de red.

Pitfalls

• Node público >=26.5.1 <27; toolchain de fuente usa Bun 1.4.0-canary.1 pinneado con checksum (Node como lane de compatibilidad testeada).
• birdclaw serve abre en http://localhost:3000.
• Para archivos reales usar birdclaw import; el demo no requiere credenciales.

Verificación

• birdclaw search tweets "local-first" --limit 3 --json devuelve los tweets del demo.
• birdclaw serve abre http://localhost:3000 con la Home timeline local.

Referencia

README de https://github.com/steipete/birdclaw. Docs: birdclaw.sh. npm: birdclaw. Homebrew tap: steipete/tap.