/content-cleanup

name: content-cleanup
description: Mass-cleanup your X/Twitter account. Delete every post matching a search (for example every reply you sent one account), unlike all posts, clear all reposts/retweets, clear all bookmarks, and remove unwanted followers. Use when users want to clean their account history, delete replies to someone, remove old likes, or start fresh.
license: Apache-2.0
metadata:
  author: nichxbt
  version: "3.0"

Content Cleanup with XActions

Browser console scripts for mass-cleaning your X/Twitter account history.

Available Scripts

| Script | File | Purpose | |--------|------|---------| | Search Sweep | `scripts/searchSweep.js` | Delete (or like/repost/reply to) every post an X search returns | | Bulk Delete Tweets | `src/bulkDeleteTweets.js` | Delete your own posts from your profile timeline by age, keyword, or engagement | | Unlike All Posts | `src/unlikeAllPosts.js` | Remove all likes from your likes page | | Clear All Reposts | `src/clearAllReposts.js` | Remove all retweets/reposts | | Clear All Bookmarks | `src/clearAllBookmarks.js` | Remove all saved bookmarks | | Remove Followers | `src/removeFollowers.js` | Soft-block to remove specific followers |

Search Sweep: delete everything matching a search

**File:** `scripts/searchSweep.js` (full guide: `docs/search-sweep.md`)

The one to reach for when the user wants "delete every reply I sent @someone", "remove all my posts mentioning X", or "delete everything I posted before 2024". X has no bulk tool for that, but its search finds the posts:

https://x.com/search?q=from%3AYOUR_HANDLE%20%40someone&src=typed_query&f=live

How to use

1. Open that search on x.com (use the Latest tab, `f=live`; Top ranking hides most results) 2. Open DevTools (F12) then Console 3. Paste `scripts/searchSweep.js`. A panel appears bottom-right, pre-filled with the query already in the address bar 4. Pick the action: Delete, Like, Repost, or Reply. Leave Dry run ON and click Start 5. Read the log, untick Dry run, start again

What to tell the user

• **Delete only ever touches their own posts.** Anything by another account is refused.
• **It needs more than one run.** X search returns a slice at a time and its index lags

deletions by minutes. The script re-runs the query for several passes and remembers every id it acted on, so running it again a day later only picks up stragglers.

• **Filters protect posts worth keeping**: minimum age, likes/reposts ceiling, keyword

exclusions, and the pinned post is always skipped.

• **Deletion is permanent.** Back up first with `scripts/backupAccount.js`.

Query building

| Want | Query | |------|-------| | Every reply you sent someone | `from:you @someone` | | Only direct replies to them | `from:you to:someone` | | Everything you posted before a date | `from:you until:2024-01-01` | | Your posts on a topic | `from:you keyword` | | Only replies, no links | `from:you @someone filter:replies -filter:links` |

Unlike All Posts

**File:** `src/unlikeAllPosts.js`

Mass-unlike all posts from your likes page.

How to use

1. Navigate to `x.com/YOUR_USERNAME/likes` 2. Open DevTools (F12) → Console 3. Paste the script → Enter

Configuration

const CONFIG = {
  maxUnlikes: Infinity,     // Set a number to limit
  minDelay: 800,            // Minimum delay between unlikes (ms)
  maxDelay: 2000,           // Maximum delay
};

Key selector

| Element | Selector | |---------|----------| | Unlike button | `[data-testid="unlike"]` |

Clear All Reposts

**File:** `src/clearAllReposts.js`

Remove all retweets/reposts from your profile.

How to use

1. Navigate to `x.com/YOUR_USERNAME` 2. Open DevTools (F12) → Console 3. Paste the script → Enter

Key selectors

| Element | Selector | |---------|----------| | Unretweet button | `[data-testid="unretweet"]` | | Confirm unretweet | `[data-testid="unretweetConfirm"]` |

Clear All Bookmarks

**File:** `src/clearAllBookmarks.js`

Remove all saved bookmarks. Tries the built-in "Clear All" button first, falls back to individual removal.

How to use

1. Navigate to `x.com/i/bookmarks` 2. Open DevTools (F12) → Console 3. Paste the script → Enter

Remove Followers

**File:** `src/removeFollowers.js`

Remove specific followers without fully blocking them (soft-block technique).

Configuration

const CONFIG = {
  usersToRemove: ['username1', 'username2'],
  removeAll: false,     // Set to true to remove ALL visible followers
  maxRemovals: 50,
  dryRun: true,         // Set to false to actually remove
};

How to use

1. Navigate to `x.com/YOUR_USERNAME/followers` 2. Edit the usernames to remove (or set `removeAll: true`) 3. Set `dryRun: false` 4. Open DevTools (F12) → Console 5. Paste the script → Enter

Notes

• Deleting a post cannot be undone, and X search keeps listing deleted posts for a few minutes
• Unlike/unretweet operations cannot be undone — the original post remains, but your interaction is removed
• Clearing bookmarks is permanent
• Remove followers uses the "Remove this follower" option from the three-dot menu on the followers page
• All scripts include configurable delays to respect rate limits
• Progress is logged every 10 items