/community-health-monitoring

name: community-health-monitoring
description: Audits follower quality, engagement authenticity, unfollower patterns, and network efficiency to produce a community health score. Use when monitoring account health or detecting bot/spam followers.
license: Apache-2.0
metadata:
  author: nichxbt
  version: "4.0"

Community Health Monitoring

MCP-powered workflow for auditing follower quality, engagement health, and network efficiency. Produces a scored health report.

MCP Tools Used

| Tool | Purpose | |------|---------| | `x_get_profile` | Account-level stats | | `x_get_followers` | Follower list for quality audit | | `x_get_following` | Following list for reciprocity check | | `x_get_non_followers` | Identify non-reciprocal follows | | `x_get_tweets` | Engagement data for authenticity check | | `x_detect_unfollowers` | Track recent unfollower patterns |

Browser Scripts

Complement MCP analysis with browser-side tools:

| Goal | Script | |------|--------| | Audit follower quality | `src/auditFollowers.js` | | Detect unfollowers | `src/detectUnfollowers.js` | | Audience demographics | `src/audienceDemographics.js` | | Follow ratio analysis | `src/followRatioManager.js` | | Account health dashboard | `src/accountHealthMonitor.js` | | Shadowban check | `src/shadowbanChecker.js` |

Workflow

1. **Profile baseline** -- Call `x_get_profile` to get follower count, following count, and calculate follower-to-following ratio. 2. **Audit follower quality** -- Call `x_get_followers` with `limit: 200`. Classify each follower:

• **Active**: Has bio, 50+ followers, posted in last 30 days
• **Low quality**: No bio, <10 followers, or no recent activity
• **Suspect bot**: Default avatar, username with many numbers, 0 tweets, follows 1000+

3. **Check engagement authenticity** -- Call `x_get_tweets` with `limit: 30`. For each tweet, compare engagement volume to follower count. Flag anomalies: likes/follower ratio > 10% (potential engagement pods) or < 0.1% (ghost followers). 4. **Analyze unfollower patterns** -- Call `x_detect_unfollowers`. Note churn rate and whether unfollowers correlate with specific content types or posting gaps. 5. **Assess reciprocity** -- Call `x_get_non_followers`. Calculate reciprocity rate: `mutual_follows / total_following * 100`. Identify high-value accounts not following back. 6. **Calculate health score** -- Weighted composite (0-100):

• Follower quality: 30% (% active followers)
• Engagement authenticity: 25% (normal engagement patterns)
• Churn rate: 20% (low unfollower rate)
• Reciprocity: 15% (healthy follower/following balance)
• Growth trend: 10% (net positive follower change)

7. **Generate report** -- Compile into the template below with actionable recommendations.

Output Template

## Community Health Report: @{username}
Date: {date} | Health Score: {score}/100

### Score Breakdown
| Category | Score | Weight | Weighted |
|----------|-------|--------|----------|
| Follower Quality | {n}/100 | 30% | {n} |
| Engagement Authenticity | {n}/100 | 25% | {n} |
| Churn Rate | {n}/100 | 20% | {n} |
| Reciprocity | {n}/100 | 15% | {n} |
| Growth Trend | {n}/100 | 10% | {n} |

### Follower Audit
- Total: {count} | Active: {n}% | Low quality: {n}% | Suspect bots: {n}%

### Engagement Health
- Avg engagement rate: {rate}%
- Anomalous posts: {count} flagged

### Reciprocity
- Following: {count} | Follow back: {n}% | Non-followers: {count}

### Recommendations
1. {actionable recommendation}
2. {actionable recommendation}
3. {actionable recommendation}

Strategy Guide

Monthly health audit routine

1. Run full MCP workflow above for baseline report 2. Compare against previous month's scores 3. Action items: block flagged bots, unfollow non-reciprocals above threshold 4. Use `src/accountHealthMonitor.js` for quick between-audit checks

Score interpretation

| Score | Grade | Action | |-------|-------|--------| | 80-100 | Excellent | Maintain current strategy | | 60-79 | Good | Minor adjustments needed | | 40-59 | Fair | Review engagement strategy, clean follower list | | 20-39 | Poor | Major cleanup needed, block bots, reassess content | | 0-19 | Critical | Possible shadowban, mass bot followers, or inactive account |

Improving a low health score

1. Block suspect bot followers with `src/blockBots.js` 2. Unfollow non-reciprocals with `src/unfollowback.js` 3. Increase posting consistency to reduce churn 4. Engage authentically to improve engagement rate

Notes

• Health score is a heuristic -- use as directional guidance, not exact measurement
• Bot detection uses profile signals, not ML -- some false positives expected
• Run quarterly for trend tracking, monthly for active management