version: "1.0.1" name: bookmarks-management description: Manages X/Twitter bookmarks — organize by category with auto-tagging, clear all bookmarks in bulk, and export/scrape bookmarks with full metadata. Supports keyword-based categorization, CSV and JSON export, keep-filters, and folder creation (Premium). Use when users want to export, organize, or clear their X bookmarks. license: Apache-2.0 metadata: author: nichxbt version: "3.0"

Bookmarks Management

Browser console scripts for managing, organizing, exporting, and clearing X/Twitter bookmarks.

Script Selection

Scrape Bookmarks

File: scripts/scrapeBookmarks.js

Scrolls through your bookmarks and exports all posts with full metadata: text, author, engagement metrics, media URLs, external links, hashtags, and mentions. Exports as JSON, CSV, or both.

How to Use

1. Navigate to x.com/i/bookmarks
2. Open DevTools (F12) → Console
3. Paste the script → Enter
4. Auto-downloads when complete

Configuration

• MAX_BOOKMARKS: 2000 — maximum to collect
• FORMAT: 'both' — 'json', 'csv', or 'both'
• INCLUDE_MEDIA_URLS: true — include image/video URLs
• INCLUDE_LINKS: true — include external links

Output

Each bookmark includes: tweetId, handle, displayName, verified, text, url, time, likes, retweets, replies, views, images, videos, links, hashtags, mentions.

Bookmark Organizer

File: src/bookmarkOrganizer.js

Auto-categorizes bookmarks by keyword matching and exports organized data. Configure categories in CONFIG.categories (default: Tech, News, Crypto, Funny, Business). Unmatched bookmarks go to "Uncategorized." Supports JSON and CSV export.

1. Navigate to x.com/i/bookmarks → paste in DevTools → Enter
2. Prints category breakdown in console → auto-downloads organized export

Clear All Bookmarks

File: src/clearAllBookmarks.js

Removes all bookmarks. Tries the built-in "Clear All" button first, then falls back to removing bookmarks individually by scrolling and clicking.

How to Use

1. Navigate to x.com/i/bookmarks → paste in DevTools → Enter

Features

• keepKeywords: [] — protect bookmarks containing specific words
• dryRun: false — preview removals without deleting
• exportOnComplete: true — auto-download log of removed bookmarks
• Pause/resume/abort via window.XActions.pause() / .resume() / .abort()
• Rate limit detection with automatic cooldown

Bookmark Manager (Puppeteer)

File: src/bookmarkManager.js

Node.js/Puppeteer module for programmatic bookmark operations.

Functions

DOM Selectors

Rate Limiting & Safety

• 1.5s scroll delay between pagination cycles
• 0.8–2.2s delay between individual removals (gaussian randomized)
• Rate limit detection via [data-testid="toast"] with 60s cooldown
• Clearing is irreversible — export first with scripts/scrapeBookmarks.js

Troubleshooting