Stagehand — это SDK для браузерных агентов: natural-language шаги act / extract / observe рядом с привычными page.goto и locator. Playwright заточен под тесты, Stagehand — под агентов. Канон: docs.stagehand.dev и Quickstart v4.
Связка: Firecrawl, Cursor Browser, Cursor MCP. Pillar: n8n для начинающих.
Для кого Stagehand
- Нужна автоматизация UI, где CSS-селекторы ломаются после редизайна.
- Пишете агента (LangChain, CrewAI, Mastra, свой loop) и даёте ему «руки» в браузере.
- Хотите один скрипт на TypeScript, Python или Go поверх CDP.
- Стартуете локально, потом без смены логики уходите на Browserbase cloud browsers.
Быстрый старт v4
- Установите SDK:
pnpm install @browserbasehq/stagehand zodилиpip install stagehand. - Поднимите браузер фабрикой:
browserbase.launch({ apiKey })илиlocalBrowser.launch(). - Создайте рантайм:
Stagehand.create({ browser })— в v4 это static factory, неnew Stagehand().init(). - Возьмите page из
browser.context.pages(), сделайтеgoto, затемextract/act/observe. - Закройте оба хендла:
stagehand.close()иbrowser.close().
| Примитив | Задача | Пример инструкции |
|---|---|---|
| act | Действие на странице | click the login button |
| extract | Структурированные данные + schema | extract the price (zod / pydantic) |
| observe | Список доступных действий | find submit buttons |
| page API | Детерминированный контроль | goto, locator.fill, screenshot |
| browserbase.launch | Cloud browser + Model Gateway | нужен BROWSERBASE_API_KEY |
| localBrowser.launch | Локальный Chromium | разработка без облака |
Сверка: docs.stagehand.dev introduction + v4 quickstart (проверка 2026-09-08). Stagehand сам не читает env — ключ Browserbase передаёте в launch явно. Тарифы Browserbase/моделей не выдумываем: смотрите кабинет провайдера.
v3 → v4: что ломается
- Инициализация: вместо внутреннего браузера — явная фабрика +
Stagehand.create. - Agent API v3 (
stagehand.agent()) в v4 убран: переходите на Code Mode / tool calling и свой agent loop. - Нет зависимости от Playwright: CDP через Understudy, знакомый subset API на page.
Сильные стороны
- Можно мешать AI-шаги и жёсткие селекторы в одном скрипте.
- Типизированный extract по schema.
- Метрики inference через
metrics(). - Интеграции с Claude Code, Codex, CrewAI, Mastra, Vercel AI SDK (см. docs Integrations).
Типичные ошибки
- Копировать v3-примеры
new Stagehand().init()в новый проект. - Забыть
browser.close()послеstagehand.close()— сессия Browserbase останется висеть. - Ждать, что Stagehand = Firecrawl Crawl: это браузерный SDK, не bulk markdown API.
- Класть цены Browserbase «на глаз» в статью или README.
FAQ: Stagehand
Что такое Stagehand?
Stagehand — SDK браузерной автоматизации для агентов от команды Browserbase. Даёт AI-примитивы act/extract/observe плюс Playwright-style API на page. Канон: docs.stagehand.dev (v4).
Обязателен ли Browserbase?
Нет. Можно localBrowser.launch() на своём Chromium. Browserbase рекомендуют для продакшена: hosted browser, server-side caching, Model Gateway. Quickstart docs используют browserbase.launch с BROWSERBASE_API_KEY.
Чем Stagehand v4 отличается от Playwright?
Stagehand едет по CDP без зависимости от Playwright. Браузер поднимаете фабрикой, затем Stagehand.create({{ browser }}). AI-шаги — natural language; детерминированные — locator/goto/click.
Какие языки поддерживает v4?
TypeScript, Python и Go с паритетом методов. Пакеты: @browserbasehq/stagehand, pip stagehand, Go module packages/sdk-go/v4.
Нужен ли отдельный ключ модели?
В quickstart при запуске на Browserbase Model Gateway выбирает модель сам — отдельный provider key не обязателен. Свой LLM можно задать в конфигурации models.
Вывод
Stagehand — руки агента в браузере: act/extract/observe + page API. Начните с quickstart v4 на Browserbase или localBrowser, затем подключайте к своему agent harness. Для чистого scrape markdown смотрите Firecrawl.
Хотите нейросети под свои задачи, а не «для всех»?
Когда базовых гайдов уже мало, помогает разбор под вашу работу. Наставничество, курсы и подписка Артёма Денисова — все форматы на странице обучения. Тех-pillar — n8n для начинающих.