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