X Bookmarks Fetcher

Download X/Twitter bookmarks via the official X API v2 (no scraping, no Chrome session). Saves tweet text, metadata, images, and videos to a local folder.

First-time setup

If scripts/.env does not yet exist, follow SETUP.md in this skill folder. It walks through:

1. Creating an X developer app with OAuth 2.0 enabled
2. Setting the callback URL to http://127.0.0.1:8765/callback
3. Copying client ID/secret into .env
4. Running npm run auth (one-time browser consent → saves refresh token)

Once scripts/.env and scripts/.tokens.json exist, fetching is pure API.

Quick Start

cd ~/.claude/skills/x-bookmarks-fetcher/scripts