nirholasnirholas/XActions/skills/bookmarks-management/SKILL.md

bookmarks-management

Skill648 starsChanged 9 months agoApache-2.0View on GitHub

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.

In this repository60 other files it gives its agents.
- AGENTS.mdAGENTS.md
- docs/agents.mdAGENTS.md
- python/AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- python/CLAUDE.mdCLAUDE.md
- xspace-agents/CLAUDE.mdCLAUDE.md
- .github/copilot-instructions.mdCopilot instructions
- llms-full.txtllms.txt
- llms.txtllms.txt
- python/llms-full.txtllms.txt
- python/llms.txtllms.txt
- a2a-multi-agentSkill
- account-backupSkill
- account-toolsSkill
- algorithm-cultivationSkill
- analytics-insightsSkill
- articles-longformSkill
- billing-managementSkill
- blocking-muting-managementSkill
- business-adsSkill
- community-health-monitoringSkill
- community-managementSkill
- community-notesSkill
- competitor-intelligenceSkill
- content-cleanupSkill
- content-postingSkill
- content-repurposingSkill
- creator-monetizationSkill
- crm-managementSkill
- delegate-accessSkill
- direct-messagesSkill
- discovery-exploreSkill
- engagement-interactionSkill
- follower-monitoringSkill
- graph-analysisSkill
- grok-aiSkill
- growth-automationSkill
- lead-generationSkill
- lists-managementSkill
- media-studioSkill
- notifications-managementSkill
- post-editingSkill
- premium-subscriptionsSkill
- profile-managementSkill
- reputation-auditSkill
- saved-searchesSkill
- settings-privacySkill
- spaces-liveSkill
- teams-managementSkill
- timeline-viewingSkill
- topic-managementSkill
- twitter-scrapingSkill
- unfollow-managementSkill
- video-downloadingSkill
- viral-thread-generationSkill
- webhooksSkill
- x402-paymentsSkill
- xactions-cliSkill
- xactions-mcp-serverSkill
- x-pro-managementSkill

The file

Create a free account to mount

Files

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 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.

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 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

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

It worked
Partly
It didn't

What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free