human-browser-free - SKILL.md Agent Skill

name: human-browser-free description: Free-first browser skill for SCRIPTUS. Use this for web automation with human-like mouse/typing/scroll while keeping default mode local and free (no proxy, no trial network calls). Enable proxy only manually per run with explicit credentials and HB_ALLOW_PROXY=1. Use CAPTCHA solving only with your own TWOCAPTCHA_KEY or opts.apiKey.

Human Browser Free

Локальный форк human-browser для безопасного бесплатного режима по умолчанию.

Политика (обязательно)

Дефолтный режим: free local.
Никаких автозапросов trial/upsell.
Proxy включается только вручную и только на конкретный запуск.
CAPTCHA работает только с вашим личным API-ключом.

Когда использовать

Используйте этот skill для любых веб-задач в workspace-Scripter: открыть сайт, пройти по странице, кликать/вводить/скроллить, собрать данные, сохранить авторизацию в storage state.

Быстрый старт (free default)

const { launchHuman } = require('./scripts/browser-human');

const { browser, page, humanType, humanClick, humanScroll } = await launchHuman({
  headless: false,
  useProxy: false,
});

await page.goto('https://example.com', { waitUntil: 'domcontentloaded' });
await humanScroll(page, 'down');
await browser.close();

Ручной proxy режим (опционально)

Включайте только если сайт реально требует прокси.

$env:HB_ALLOW_PROXY = '1'
$env:HB_PROXY_USER = 'your_user'
$env:HB_PROXY_PASS = 'your_pass'
# optional:
$env:HB_PROXY_SERVER = 'http://host:port'

const { launchHuman } = require('./scripts/browser-human');
const { browser, page } = await launchHuman({ useProxy: true, headless: false });

Если useProxy:true без HB_ALLOW_PROXY=1 или без кредов, функция завершится контролируемой ошибкой:

PROXY_DISABLED_BY_POLICY
PROXY_CREDENTIALS_MISSING
PROXY_DISABLED_BY_ENV (если включён HB_NO_PROXY=1)

CAPTCHA (опционально)

const { solveCaptcha } = require('./scripts/browser-human');
await solveCaptcha(page, { apiKey: process.env.TWOCAPTCHA_KEY, verbose: true });

Без ключа (opts.apiKey или TWOCAPTCHA_KEY) будет явная ошибка.

Совместимость API

Экспорт сохранён как в upstream:

launchHuman
solveCaptcha
humanMouseMove, humanClick, humanType, humanScroll, humanRead
shadowQuery, shadowFill, shadowClickButton, dumpInteractiveElements, pasteIntoEditor

Важно

getTrial() в этом форке отключён политикой и всегда возвращает ошибку TRIAL_DISABLED_BY_POLICY.
Upstream skills/human-browser не изменяется и остаётся reference-only.
Для установки из GitHub и публикации см. PUBLISH_GITHUB.md.