Mia Twitter Stealth 🕵️‍♀️

Twitter/X automation with advanced stealth techniques to avoid bot detection.

Anti-Detection Features

1. Playwright Stealth

• Hides navigator.webdriver
• Masks Chrome automation flags
• Spoofs plugins and languages

2. Headful Mode

• headless: false by default
• Real browser UI visible
• Avoids headless detection

3. Human Behavior

• Random typing delays (50-150ms)
• Mouse movement simulation
• Random wait times
• Natural scroll patterns

4. Session Persistence

• Cookie storage
• LocalStorage persistence
• User data directory

5. Cooldown Management

• Rate limit tracking
• Automatic backoff
• 24h cooldown if flagged

Usage

# Post tweet
mia-twitter post "Hello world"

# Reply to tweet
mia-twitter reply <tweet-id> "Great post!"

# Like tweets by search
mia-twitter like --search "AI agents" --limit 10

# Follow users
mia-twitter follow --search "founder" --limit 5

# Check notifications
mia-twitter notifications

Safety

• Max 5 actions per hour
• Max 50 per day
• 2-5 min delays between actions
• Human-like patterns only

Requirements

• X_AUTH_TOKEN env var
• X_CT0 env var
• Playwright with Chromium