@puberty-labs/clits/docs/CLOUDFLARE_QUICK_REFERENCE.md

CLiTS (Chrome Logging and Inspection Tool Suite) is a powerful Node.js library for AI-controlled Chrome browser automation, testing, and inspection. Features enhanced CSS selector support (:contains(), XPath), dry-run mode, element discovery tools, and co

# 🛡️ Cloudflare Quick Reference

## Problem
Getting "Can't verify the user is human" errors when using CLiTS automation on Cloudflare-protected sites.

## Solution (Copy-Paste Ready)

### Option 1: Use Official Script
```bash
./scripts/start-cloudflare-safe-chrome.sh
```

### Option 2: Manual Commands
```bash
pkill -f "Google Chrome"
"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \
  --remote-debugging-port=9222 \
  --user-data-dir=/tmp/chrome-debug \
  --disable-blink-features=AutomationControlled \
  --exclude-switches="enable-automation" \
  --disable-extensions-except \
  --disable-plugins-discovery \
  --no-first-run \
  --no-default-browser-check &
sleep 5
```

## Verification
```bash
lsof -i :9222 && curl -s http://localhost:9222/json/version && clits inspect --tabs --chrome-port 9222
```

## Key Flag
`--disable-blink-features=AutomationControlled` - This is the magic flag that prevents `navigator.webdriver = true`

## Troubleshooting
- **Chrome won't start**: Check `ps aux | grep Chrome` and kill all processes first
- **Port not listening**: Use `lsof -i :9222` to verify port is bound
- **Still getting blocked**: Try with your regular profile (remove `--user-data-dir` flag)

## Full Documentation
See [docs/CLOUDFLARE_WORKAROUND.md](./CLOUDFLARE_WORKAROUND.md) for complete guide.