n8n-nodes-browserless-hots

🚀 Hot-fixed Browserless.io integration for n8n - headless browser automation with self-hosted support

🔥 What's Hot

This is an improved version of the original n8n-nodes-browserless package with critical fixes:

• ✅ Fixed type validation errors - no more "setExtraHTTPHeaders must be object" errors
• ✅ Full self-hosted support - works with local Browserless instances
• ✅ Complete parameter support - all Browserless API v2 features implemented
• ✅ Russian interface - all descriptions and hints in Russian
• ✅ Modern API compatibility - tested with latest Browserless versions

Установка

npm install n8n-nodes-browserless-hots

Credentials

Настройте credentials в n8n:

• Endpoint: URL вашего self-hosted Browserless сервера (например: http://localhost:3000)
• API Token: Токен API для авторизации

Различия с оригинальным n8n-nodes-browserless

| Функция | Оригинальный | n8n-nodes-browserless-hot | |---------|-------------|---------------------------| | Типы данных | ❌ Ошибки валидации | ✅ Исправлены все типы | | Self-hosted | ❌ Частично | ✅ Полная поддержка | | Launch параметры | ❌ Не реализованы | ✅ Все параметры | | Request параметры | ❌ Не реализованы | ✅ Все параметры | | Специфичные опции | ❌ Отсутствуют | ✅ Полная реализация | | Русский интерфейс | ❌ Английский | ✅ Полностью на русском | | Browserless API v2 | ❌ Частично | ✅ Полная поддержка |

Операции

1. Content (Контент)

Получает полный HTML страницы с JavaScript рендерингом.

2. Screenshot (Скриншот)

Создаёт скриншот страницы в форматах PNG/JPEG/WebP.

3. PDF

Генерирует PDF документ из страницы или HTML.

4. Scrape (Парсинг)

Извлекает структурированные данные по CSS селекторам.

5. Performance (Производительность)

Анализирует страницу через Lighthouse (performance, SEO, accessibility).

6. Unblock (Разблокировка)

Обходит защиту от ботов и получает контент заблокированных страниц.

Параметры

Launch параметры (query)

• headless: Режим без GUI
• stealth: Маскировка автоматизации
• blockAds: Блокировка рекламы
• blockConsentModals: Скрытие cookie баннеров
• slowMo: Задержка между действиями
• acceptInsecureCerts: Принимать небезопасные сертификаты

Request параметры (body)

• url: URL страницы
• html: HTML контент (альтернатива URL)
• gotoOptions: Опции навигации
• waitForSelector: Ожидание элемента
• bestAttempt: Продолжить при ошибках

Публикация

Для публикации пакета на npm:

# Убедитесь что версия обновлена в package.json
npm version patch  # или minor/major

# Публикация
npm publish

Разработка

npm install
npm run build
npm run dev

Структура проекта

n8n-nodes-browserless-hot/
├── package.json
├── tsconfig.json
├── .npmignore
├── README.md
├── credentials/
│   └── BrowserlessApi.credentials.ts
├── nodes/
│   └── Browserless/
│       ├── Browserless.node.ts          # Основная нода
│       ├── GenericFunctions.ts          # API функции
│       ├── browserless.svg              # Иконка
│       └── descriptions/                # Описания параметров
│           ├── CommonFields.ts          # Общие параметры
│           ├── ContentDescription.ts    # Content операция
│           ├── ScreenshotDescription.ts # Screenshot операция
│           ├── PdfDescription.ts        # PDF операция
│           ├── ScrapeDescription.ts     # Scrape операция
│           ├── PerformanceDescription.ts# Performance операция
│           └── UnblockDescription.ts    # Unblock операция
└── dist/                               # Скомпилированные файлы

License

MIT