RanaPriyansh/unfollow-management
skills/unfollow-management/SKILL.md
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.
tools
Updated Apr 23, 2026
$ install --global
skillsauthnpx skillsauth add RanaPriyansh/XActions unfollow-managementInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 10, 2026, 2:12 AM39.9s2 files scanned
SKILL.md
- name:
- unfollow-management
- description:
- 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.
- license:
- MIT
- author:
- nichxbt
- version:
- 3.0
Unfollow Management
Browser console scripts for managing who you follow on X/Twitter. All scripts run in DevTools console.
Script Selection
| Goal | File | Navigate to |
|------|------|-------------|
| Unfollow ALL accounts | src/unfollowEveryone.js | x.com/USERNAME/following |
| Unfollow only non-followers | src/unfollowback.js | x.com/USERNAME/following |
| Unfollow non-followers + download log | src/unfollowWDFBLog.js | x.com/USERNAME/following |
| Time-based smart unfollow with whitelist | src/automation/smartUnfollow.js | x.com/USERNAME/following |
| Detect who unfollowed you | src/detectUnfollowers.js | x.com/USERNAME/followers |
| Monitor follow/following ratio + plan | src/followRatioManager.js | x.com/USERNAME |
| Remove specific followers from YOUR list | src/removeFollowers.js | x.com/USERNAME/followers |
Script Details
For detailed algorithms, controls, configurations, and DOM selectors for each script, see references/script-details.md.
Rate Limiting & Safety
- Default delay: 1–2 seconds between unfollows (gaussian randomized)
- Batch delay: 2–3 seconds between scroll batches
- Rate limit detection: Scripts check for
[data-testid="toast"]warning banners - Backoff: If rate limited, scripts wait 30–60 seconds before retrying
- Daily limit guidance: X may restrict after ~400 unfollows/day; spread over multiple sessions
- Recovery: If action-restricted, wait 12–24 hours
Strategy Guide
Cleaning a bloated following list
- Run
src/followRatioManager.json your profile to assess current ratio - Use
XActions.plan()to see how many unfollows are needed - Run
src/unfollowback.jsto remove non-followers first (safest) - If more cleanup needed, use
src/unfollowEveryone.jswith abort when satisfied - Re-check ratio with
XActions.track()
Maintaining a healthy ratio over time
- Set up periodic runs of
src/detectUnfollowers.jsto track losses - Use
src/followRatioManager.jsweekly to monitor trends - Run
src/unfollowback.jsmonthly to remove non-reciprocal follows - Keep a whitelist in
smartUnfollow.jsfor accounts you always want to follow
Before a big unfollow session
- Export your following list first:
scripts/scrapeFollowing.js - Run
src/unfollowWDFBLog.js(saves log of who was unfollowed) - Review the downloaded log for any mistakes
- Use
src/followRatioManager.jsto verify improvements
Troubleshooting
| Problem | Solution |
|---------|----------|
| "No unfollow buttons found" | Make sure you're on the Following page, not Followers |
| Script stops after ~20 unfollows | X rate limit triggered — wait 1 hour and re-run |
| Confirmation dialog doesn't appear | DOM may have changed — check confirmationSheetConfirm selector |
| Script unfollows mutuals | Use unfollowback.js instead of unfollowEveryone.js |
| "Action restricted" warning | Account is temporarily limited — wait 12-24 hours |
| Script misses accounts | Re-run the script — some load below the scroll area |
Related Skills
- follower-monitoring — Track follower growth and detect unfollowers
- blocking-muting-management — Block/unblock for removing followers
- growth-automation — Grow followers to improve ratio organically
- analytics-insights — Understand engagement before unfollowing
Related Skills
RanaPriyansh/xactions-mcp-server
tools
VerifiedTrustedCommunity
Free MCP server providing 68+ tools for AI agents to automate X/Twitter. Scrapes profiles, followers, tweets. Posts, follows, likes, retweets, downloads videos, analyzes sentiment, monitors brands, manages DMs, runs workflows, and more. Uses local Puppeteer -- no API keys or payments required. Compatible with Claude Desktop, Cursor, Windsurf, VS Code. Use when setting up or using AI agent Twitter automation via MCP.
SKILL.mdUpdated Apr 23, 2026
RanaPriyansh/xactions-cli
tools
VerifiedTrustedCommunity
Command-line interface for scraping X/Twitter data, managing MCP server config, and running automation. Scrapes profiles, followers, tweets, search results, and more from terminal. Outputs text, JSON, or CSV. Uses Puppeteer stealth. Use when running Twitter operations from command line or automated pipelines.
SKILL.mdUpdated Apr 23, 2026
RanaPriyansh/viral-thread-generation
content-media
VerifiedTrustedCommunity
Researches trending topics and competitor threads to generate high-engagement thread content with optimized hooks, value ladders, and calls to action. Use when creating threads or planning viral content.
SKILL.mdUpdated Apr 23, 2026
RanaPriyansh/twitter-scraping
development
VerifiedTrustedCommunity
Scrapes X/Twitter data without API access using Puppeteer stealth and browser console scripts. Extracts profiles, followers, following lists, tweets, search results, hashtags, threads, media, bookmarks, notifications, DMs, likes, and viral tweets. Exports to JSON/CSV. Use when collecting, exporting, or analyzing Twitter data.
SKILL.mdUpdated Apr 23, 2026