| 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
| Goal | File | Navigate to |
|---|
| Export bookmarks (full metadata) | scripts/scrapeBookmarks.js | x.com/i/bookmarks |
| Organize bookmarks by category | src/bookmarkOrganizer.js | x.com/i/bookmarks |
| Clear all bookmarks | src/clearAllBookmarks.js | x.com/i/bookmarks |
| Manage bookmarks (Puppeteer) | src/bookmarkManager.js | x.com/i/bookmarks |
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
- Navigate to
x.com/i/bookmarks
- Open DevTools (F12) → Console
- Paste the script → Enter
- Auto-downloads when complete
Configuration
MAX_BOOKMARKS: 2000 — maximum to collectFORMAT: 'both' — 'json', 'csv', or 'both'INCLUDE_MEDIA_URLS: true — include image/video URLsINCLUDE_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.
- Navigate to
x.com/i/bookmarks → paste in DevTools → Enter
- 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
- Navigate to
x.com/i/bookmarks → paste in DevTools → Enter
Features
keepKeywords: [] — protect bookmarks containing specific wordsdryRun: false — preview removals without deletingexportOnComplete: 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
| Function | Purpose |
|---|
getBookmarks(page, { limit, format }) | Export bookmarks as JSON or CSV |
createFolder(page, folderName) | Create bookmark folder (Premium) |
clearAllBookmarks(page) | Remove all bookmarks |
DOM Selectors
| Element | Selector |
|---|
| Bookmark button | [data-testid="bookmark"] |
| Remove bookmark | [data-testid="removeBookmark"] |
| Tweet in bookmarks | article[data-testid="tweet"] |
| Tweet text | [data-testid="tweetText"] |
| Create folder | [data-testid="createBookmarkFolder"] |
| Clear all | [data-testid="clearBookmarks"] |
| Confirm dialog | [data-testid="confirmationSheetConfirm"] |
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
| Problem | Solution |
|---|
| No bookmarks found | Ensure you're on x.com/i/bookmarks, not /i/lists |
| Export missing tweets | Increase MAX_BOOKMARKS or maxBookmarks config |
| Folder creation fails | Bookmark folders require Premium subscription |
| Clear stops midway | Rate limit triggered — script auto-retries after cooldown |
