bookmarks-management

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

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

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