nirholas/xactions

bookmarks-management

Manages X/Twitter bookmarks — organize by category with auto-tagging, clear all bookmarks in bulk, and export/scrape bookmarks with full metadata.

First seen Feb 28, 2026

Installation

$ npx skills add nirholas/xactions --skill bookmarks-management

Summary

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

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from nirholas/xactions · top by installs.

npx skills add nirholas/xactions

Browse all from nirholas/xactions

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 510
License LICENSE
Default branch main
Open issues 9
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Version3.0
LicenseApache-2.0
More metadata
author
nichxbt
version
3.0

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 4,394 B
  • docs SUMMARY.md 350 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 12 installs

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

  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'
  • INCLUDEMEDIAURLS: 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