x-monitor-manager

X Blogger Monitoring Manager

Manage X (Twitter) blogger monitoring configuration, supporting adding, deleting, enabling, and disabling monitored bloggers.

Quick Start

View the current monitoring list:

python3 skills/x-monitor-manager/scripts/manage.py list

Add a blogger:

python3 skills/x-monitor-manager/scripts/manage.py add <username> [--max-tweets 20] [--enabled]

Delete a blogger:

python3 skills/x-monitor-manager/scripts/manage.py remove <username>

Enable/disable a blogger:

python3 skills/x-monitor-manager/scripts/manage.py enable <username>
python3 skills/x-monitor-manager/scripts/manage.py disable <username>

Configuration File

Configuration file location:config/x-monitor.json

{
  "global": {
    "request_delay_min": 30,
    "request_delay_max": 90,
    "retry_backoff_seconds": 60,
    "data_dir": "./x_monitor_data"
  },
  "monitors": [
    {
      "username": "oran_ge",
      "enabled": true,
      "max_tweets": 20
    }
  ]
}

Command Details

list

List all monitored bloggers and their statuses.

python3 skills/x-monitor-manager/scripts/manage.py list

Example output:

📋 当前监控的博主列表：
1. @oran_ge (enabled) - 每次检查 20 条推文

add

Add a new blogger to the monitoring list.

python3 skills/x-monitor-manager/scripts/manage.py add <username> [--max-tweets 20] [--enabled]

Parameters:

username: X username (without @)
--max-tweets: Number of tweets to check each time (default 20)
--enabled: Whether to enable monitoring (enabled by default)

Example:

python3 skills/x-monitor-manager/scripts/manage.py add elonmusk --max-tweets 10

remove

Remove a blogger from the monitoring list.

python3 skills/x-monitor-manager/scripts/manage.py remove <username>

Example:

python3 skills/x-monitor-manager/scripts/manage.py remove elonmusk

enable

Enable monitoring for a blogger.

python3 skills/x-monitor-manager/scripts/manage.py enable <username>

disable

Disable monitoring for a blogger (keep in the list but do not check).

python3 skills/x-monitor-manager/scripts/manage.py disable <username>

test

Test monitoring a specified blogger (run one check immediately).

python3 skills/x-monitor-manager/scripts/manage.py test <username>

Anti-Crawling Configuration

In the global section, anti-crawling parameters can be adjusted:

request_delay_min: Minimum delay between user requests (seconds)
request_delay_max: Maximum delay between user requests (seconds)
retry_backoff_seconds: Retry backoff time (seconds)

Recommended values:

1-3 bloggers: delay 30-60 seconds
4-6 bloggers: delay 60-120 seconds
7+ bloggers: delay 90-180 seconds

Usage Examples

Scenario 1: Add multiple bloggers

python3 skills/x-monitor-manager/scripts/manage.py add elonmusk --max-tweets 10
python3 skills/x-monitor-manager/scripts/manage.py add naval --max-tweets 15
python3 skills/x-monitor-manager/scripts/manage.py add samaltman --max-tweets 20

Scenario 2: Temporarily disable a blogger

python3 skills/x-monitor-manager/scripts/manage.py disable elonmusk

Scenario 3: Test a newly added blogger

python3 skills/x-monitor-manager/scripts/manage.py test naval

Notes

Anti-crawling: When adding too many bloggers, appropriately increase the request delay
Initialization: When adding a blogger for the first time, it is recommended to run test to initialize the history records
Backup: Before modifying the configuration, it will automatically be backed up to config/x-monitor.json.bak

Troubleshooting

Blogger already exists:

Use a different username, or delete first and then add

Configuration file corrupted:

From config/x-monitor.json.bak restore the backup

Test failed:

Check whether the username is correct
Confirm that the X account is public