autoreg-skills-max: initial public release (restored, redacted, hardened)

skills/cloudflare-bypass-scraping/references/firecrawl-interact-turnstile-reg.md

@@ -0,0 +1,27 @@
+# firecrawl_interact для Turnstile-регистраций + локальный «белый экран» SPA (2026-09-10, RainProxy)
+
+## Симптом: SPA белый экран локально, но грузится через скрапер
+`dashboard.rainproxy.io` в Playwright MCP, Chrome DevTools MCP и даже в реальном Chrome (pid 32312) — пустая страница. В DevTools network: `/assets/index.*.js` висит в **pending** / `ERR_CONNECTION_RESET`, при этом:
+- `curl` качает тот же бандл: HTTP 200, 903KB;
+- `firecrawl_scrape` с `waitFor` рендерит страницу полностью (видно форму логина).
+
+Вывод: режет не сайт, а текущий выходной IP/путь. Диагноз за 2 шага:
+1. `curl -o /dev/null -w "%{http_code} %{size_download}" <asset-url>` — если 200 и размер полный, файл жив;
+2. `firecrawl_scrape(url, formats=[markdown], waitFor=8000)` — если контент есть, проблема в локальном IP, работать через stealth-скрапер.
+
+## firecrawl_interact — жёсткие операционные лимиты (проверено вживую)
+- **MCP-вызов умирает на 60s** независимо от `timeout=300` в аргументах. Сценарий «fill + поллить Turnstile 25s + click + wait» НЕ влезает → TimeoutError. Планировать фазы ≤45s чистого действия.
+- **Сессия по scrapeId живёт ~1-2 мин.** Повторный вызов `interact(scrapeId=...)` позже → «Job not found». Двухфазный план ненадёжен — предпочитать ОДИН атомарный промпт (fill + checkbox + poll + click).
+- **Лимит 2 параллельных джоба.** Зависшие сессии держат слоты; `interact_stop` по истёкшему scrapeId → 404. Освобождение только ожиданием ~2-3 мин.
+- После 3-4 таймаутов MCP-сервер уходит в «unreachable, auto-retry in ~40s» — не спамить ретраями, спать и менять тактику.
+
+## Turnstile-регистрация: что показал живой прогон
+Заполненная форма + чекбокс terms + мгновенный клик Register (без ожидания Turnstile) → сервер возвращает валидацию:
+- «Please verify you are not a robot» — Turnstile обязателен, клик до Success! бесполезен;
+- «Please enter a valid email» на gmail **`+`-алиас** (`user+tag@gmail.com`). Dot-алиас (`user.tag@gmail.com`) — рабочая замена для мультиаккаунтинга.
+
+Правильный атомарный промпт для interact (укладывается в 60s):
+«Fill fields X; check terms; poll every 3s up to 25s until Turnstile shows Success!; click Register; report snapshot immediately.»
+
+## Связь с tier-подходом этого скилла
+Firecrawl stealth-прокси работает как Tier 3 (удалённый рендер), когда Tier 1 (curl_cffi) не适用 — SPA+Turnstile, и локальный IP режет ассеты. Для регистрации с обязательным Turnstile автоматизация без решения капчи не проходит — тот же вывод, что для proxyscrape (см. proxy-free-trial skill).