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.

Stars 197
Forks 39

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:

  1. First run: Scrapes visible users by scrolling, saves snapshot to localStorage
  2. 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

  1. Open x.com/USERNAME/followers in a pinned tab
  2. Paste src/continuousMonitor.js — it auto-refreshes every 5 minutes
  3. Enable browser notifications when prompted
  4. Check back periodically for alerts

Weekly follower health check

  1. src/followerGrowthTracker.js -> XActions.track() to log this week
  2. src/followRatioManager.js -> XActions.track() for ratio snapshot
  3. src/auditFollowers.js to check for new bot followers
  4. src/audienceDemographics.js to verify audience quality

Resetting data

javascript
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

Expand your agent's capabilities with these related and highly-rated skills.

nirholas/XActions

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.

197 39
Explore
nirholas/XActions

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.

197 39
Explore
nirholas/XActions

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.

197 39
Explore
nirholas/XActions

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.

197 39
Explore
nirholas/XActions

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.

197 39
Explore
nirholas/XActions

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.

197 39
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results