Agent skill
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.
Install this agent skill to your Project
npx add-skill https://github.com/nirholas/XActions/tree/main/skills/follower-monitoring
Metadata
Additional technical details for this skill
- author
- nichxbt
- version
- 4.0
SKILL.md
Follower Monitoring
Browser console scripts for tracking follower changes on X/Twitter. All scripts use localStorage for persistent snapshot comparison.
Script Selection
| Goal | File | Navigate to |
|---|---|---|
| Detect who unfollowed you | src/detectUnfollowers.js |
x.com/USERNAME/followers |
| Monitor any public account | src/monitorAccount.js |
x.com/TARGET/followers |
| Continuous monitoring + alerts | src/continuousMonitor.js |
x.com/USERNAME/followers |
| New follower tracking + welcome | src/newFollowersAlert.js |
x.com/USERNAME/followers |
| Follower growth over time | src/followerGrowthTracker.js |
x.com/USERNAME/followers |
| Follower demographics | src/audienceDemographics.js |
x.com/USERNAME/followers |
| Audit follower quality | src/auditFollowers.js |
x.com/USERNAME/followers |
| Follow ratio management | src/followRatioManager.js |
x.com/USERNAME |
How They Work
All scripts use the same snapshot-compare pattern:
- First run: Scrapes visible users by scrolling, saves snapshot to localStorage
- Subsequent runs: Scrapes current list, compares against saved snapshot, reports additions/removals
detectUnfollowers.js
Compares follower snapshots. Auto-downloads unfollowers as .txt file. Simple two-run workflow: paste once to baseline, paste again later to detect changes.
monitorAccount.js
Works on ANY public account (not just yours). Tracks both followers and following list changes. Downloads removed accounts list.
continuousMonitor.js
Long-running script with auto-refresh on interval (default: 5 minutes). Sends browser Notification API alerts and plays Web Audio API sounds on changes. Tab must stay open.
newFollowersAlert.js
Tracks new followers with display names. Generates welcome message templates. Also reports unfollowers as secondary output.
followerGrowthTracker.js
Records follower count snapshots over time with timestamps. Calculates daily/weekly/monthly growth rates. Projects future milestones. Visual growth chart in console.
Controls: XActions.track(), XActions.history(), XActions.project(target)
audienceDemographics.js
Scrapes follower profiles and classifies by niche, account size, bot likelihood, and verified status. Visual distribution charts.
followRatioManager.js
Navigate to profile page. Monitors follower/following ratio with letter grades. Generates improvement plans.
Controls: XActions.track(), XActions.plan(), XActions.history()
Storage Keys
| Script | localStorage Key |
|---|---|
| detectUnfollowers | xactions_my_followers |
| monitorAccount | xactions_monitor_{username}_{type} |
| newFollowersAlert | xactions_new_followers |
| followerGrowthTracker | xactions_follower_growth |
| followRatioManager | xactions_ratio_history |
Strategy Guide
Daily monitoring setup
- Open
x.com/USERNAME/followersin a pinned tab - Paste
src/continuousMonitor.js— it auto-refreshes every 5 minutes - Enable browser notifications when prompted
- Check back periodically for alerts
Weekly follower health check
src/followerGrowthTracker.js->XActions.track()to log this weeksrc/followRatioManager.js->XActions.track()for ratio snapshotsrc/auditFollowers.jsto check for new bot followerssrc/audienceDemographics.jsto verify audience quality
Resetting data
localStorage.removeItem('xactions_my_followers')
localStorage.removeItem('xactions_follower_growth')
localStorage.removeItem('xactions_ratio_history')
Notes
- All scripts auto-export results as downloadable JSON
continuousMonitor.jsrequires the tab to stay open (Chrome throttles background timers)- Monitoring accuracy improves with more scroll rounds (increase in CONFIG)
- localStorage persists across browser sessions but NOT across browser profiles
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.
settings-privacy
Manages X/Twitter account settings and privacy controls including protected tweets, muted words, content filtering, notification preferences, and account configuration. Use when changing privacy settings, managing muted words, or configuring account preferences.
Didn't find tool you were looking for?