Agent skill
bookmarks-management
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.
Install this agent skill to your Project
npx add-skill https://github.com/nirholas/XActions/tree/main/skills/bookmarks-management
Metadata
Additional technical details for this skill
- author
- nichxbt
- version
- 3.0
SKILL.md
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 |
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
articles-longform
Compose, preview, publish, and manage long-form Articles on X/Twitter. Premium+ feature. Includes article creation, formatting, media insertion, and performance tracking. Use when users want to write, publish, manage, or analyze X Articles.
x-pro-management
Navigate to X Pro (TweetDeck), set up monitoring columns, and manage multi-column view. Use when users want to use X Pro / TweetDeck features or set up a multi-column dashboard.
business-ads
Manages X/Twitter business intelligence including brand monitoring, audience insights, competitor analysis, tweet A/B testing, auto-plug replies for promotion, and content performance optimization. Use when users want brand monitoring, audience analysis, competitor comparison, or promotion optimization on X.
engagement-interaction
Automates X/Twitter engagement actions — like, unlike, reply, bookmark, hide replies, and auto-like by keyword. Also bulk-unlikes all posts. Use when users want to automate likes, send replies, manage bookmarks on tweets, hide replies, or clear their entire likes history.
unfollow-management
Mass unfollow on X/Twitter via browser console scripts. Unfollows everyone, only non-followers, non-followers with username logging, smart time-based unfollow with whitelists, and follow/following ratio management. Use when cleaning up a following list, removing non-followers, bulk unfollowing accounts, or optimizing your follow ratio.
follower-monitoring
Monitors X/Twitter follower changes using browser console scripts. Detects who unfollowed, tracks new followers with welcome messages, monitors any public account, runs continuous monitoring with alerts, tracks follower growth over time, and analyzes follower demographics. Use when tracking follower changes, detecting unfollowers, or monitoring Twitter accounts.
Didn't find tool you were looking for?