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/followers in 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 week
src/followRatioManager.js -> XActions.track() for ratio snapshot
src/auditFollowers.js to check for new bot followers
src/audienceDemographics.js to 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.js requires 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

follower-monitoring