agent-browser

Локальный браузер для ИИ-агентов, укреплённый против детекции. Ноль зависимостей. Управляет уже установленным Chrome через протокол DevTools, извлекает компактный Markdown, экономящий токены, и не тривиально определяется как автоматизация.

npx -y @truenix/agent-browser markdown https://news.ycombinator.com

Всё работает локально. Без аккаунта, без API-ключа, без удалённого сервиса, без квот.

Зачем

Скармливать агенту сырой HTML — значит тратить большую часть его контекста впустую. Замеры на реальных страницах:

А браузер, который выдаёт себя за автоматизацию, получает другой контент или вовсе блокируется — что незаметно искажает всё, что агент извлёк.

Related MCP server: Browser-MCP Navigator

Установка

Как MCP-сервер

claude mcp add browser -- npx -y @truenix/agent-browser mcp

{
  "mcpServers": {
    "browser": {
      "command": "npx",
      "args": ["-y", "@truenix/agent-browser", "mcp"]
    }
  }
}

Инструменты: browser_markdown, browser_text, browser_html, browser_links, browser_evaluate, browser_accessibility_tree, browser_pdf, browser_probe.

Как библиотека

npm install @truenix/agent-browser

import { withBrowser } from '@truenix/agent-browser';

const md = await withBrowser({}, async (session) => {
  await session.navigate('https://example.com');
  return session.markdown();
});

Как плагин DSH / Cordis

Однострочная установка (рекомендуется — автоматически подключается, когда вы действительно работаете с DSH):

npx -y @truenix/agent-browser install          # edits ~/.dsh/profiles/web/cordis.patch.yml + package.json, then pnpm install
# npx -y @truenix/agent-browser install --profile web --dry-run  # preview
# npx -y @truenix/agent-browser uninstall      # remove again

Перезапустите dsh — browser_markdown, browser_text, browser_links, browser_evaluate, browser_screenshot, browser_probe появятся как нативные инструменты. Никакой обработчик не запускается при обычном npm install; требуется осознанный install.

Вручную (если предпочитаете править композицию сами):

npm i -g @truenix/agent-browser
# or inside the harness checkout: pnpm add @truenix/agent-browser

Требуется Node ≥ 18 и установленный Chrome/Chromium. Затем добавьте в хост композицию (реестр инструментов живёт на хосте, а не у отдельного агента):

# ~/.dsh/profiles/web/cordis.patch.yml  — persists for every web session
- insert:
  - id: agent-browser
    name: '@truenix/agent-browser/cordis'
    config:
      timeoutMs: 180000   # per-tool call budget; default respects AGENT_BROWSER_BIN / ENDPOINT
      # cli: 'npx -y @truenix/agent-browser'  # override only if needed

Короткая форма (когда композиция уже оборачивает install):

- '@truenix/agent-browser/cordis':
    timeoutMs: 180000

Переменные окружения: AGENT_BROWSER_BIN (путь к Chrome), AGENT_BROWSER_ENDPOINT (подключение к уже запущенному экземпляру), либо --endpoint.

CLI

agent-browser <command> [options]

  markdown <url>     Extract the page as Markdown (main content by default)
  text <url>         Visible text only
  html <url>         Full serialized DOM after JavaScript runs
  links <url>        Every anchor as JSON
  screenshot <url>   PNG/JPEG   (-o file, --full)
  pdf <url>          PDF        (-o file)
  a11y <url>         Filtered accessibility tree
  eval <url> <expr>  Evaluate JS in the page
  probe              Browser, GPU and capability report
  mcp                Run as an MCP server on stdio

Библиотека

GXP11

Bot detection

Что делает «hardening»

GXP12

Зачем отключён спуфинг WebGL

GXP13

GXP14

Переменные окружения

Требования

Node ≥ 18 и установленный Chrome/Chromium. Без шага сборки.

Благодарности

Этот проект обязан почти всем своим «хардненингом» чужим опубликованным исследованиям по детекции — см. CREDITS.md. Особая благодарность rebrowser-bot-detector, bot.sannysoft.com, deviceandbrowserinfo.com и Camoufox за то, что показали, как это делается правильно.

Лицензия

MIT