Используйте Helodata с инструментами, которые ваша команда уже использует

Как Helodata работает с вашим стеком

Совместимость без доработок (сегодня)

Helodata предоставляет стандартную HTTP/SOCKS5 конечную точку с аутентификацией по имени пользователя и паролю. Любой клиент, поддерживающий эти протоколы — а это практически все современные HTTP-библиотеки, фреймворки для сбора данных и headless-браузеры — работает без модификаций.

Вам не нужна специальная библиотека Helodata. Вам не нужно переписывать свой парсер. Направьте существующий клиент на наш шлюз, вставьте учётные данные из панели управления — и вы в сети.

Поддержка первого уровня (в разработке)

Нативные библиотеки с авторатацией, повторными попытками, липкими сессиями и типобезопасной обработкой ответов запускаются в Q3 2026:

• Python SDK
• Node.js SDK
• Go SDK
• Java SDK
• Open-source MCP server for AI agents

А пока подход без доработок, описанный ниже, покрывает все сценарии работы. Подробнее см. на странице дорожная карта SDK для получения подробной информации.

Фреймворки для AI-агентов и LLM

LangChain

Используйте Helodata в качестве HTTP-бэкенда для любого инструмента LangChain, который обращается к вебу — RequestsGetTool, RequestsPostTool или вашего собственного пользовательского Tool.

from langchain_community.tools.requests.tool import (
    RequestsGetTool,
)
from langchain_community.utilities.requests import (
    TextRequestsWrapper,
)

# Get credentials from your Helodata dashboard
PROXY = "http://USER:PASS@gate.helodata.io:7777"

wrapper = TextRequestsWrapper(
    headers={},
    auth=None,
    proxies={"http": PROXY, "https": PROXY},
)
tool = RequestsGetTool(
    requests_wrapper=wrapper,
    allow_dangerous_requests=True,
)

LlamaIndex

Веб-ридеры LlamaIndex используют httpx внутри. Передайте конфигурацию прокси при создании ридера.

from llama_index.readers.web import SimpleWebPageReader
import httpx

PROXY = "http://USER:PASS@gate.helodata.io:7777"
client = httpx.Client(proxies=PROXY, timeout=30.0)
reader = SimpleWebPageReader(html_to_text=True, _client=client)
documents = reader.load_data(urls=["https://example.com"])

n8n

Узел HTTP Request в n8n имеет поле прокси на вкладке Authentication. Укажите там URL шлюза Helodata — работает для всех последующих узлов.

Для self-hosted n8n установите переменную окружения: N8N_DEFAULT_PROXY=http://USER:PASS@gate.helodata.io:7777

MCP серверы

Первый MCP-сервер Helodata запускается в Q3 2026 — установка одной командой, доступ к возможностям прокси для Claude Desktop, Cursor, Cline и любого MCP-совместимого клиента.

А пока направьте HTTP-инструмент любого MCP-сервера на шлюз Helodata, используя те же учётные данные, что и везде. Узнать о запуске MCP-сервера →

Фреймворки для веб-скрапинга

Scrapy

Scrapy поддерживает прокси через HttpProxyMiddleware (встроенный). Добавьте в ваш settings.py:

# settings.py
DOWNLOADER_MIDDLEWARES = {
    'scrapy.downloadermiddlewares.httpproxy.'
    'HttpProxyMiddleware': 110,
}

HTTP_PROXY  = "http://USER:PASS@gate.helodata.io:7777"
HTTPS_PROXY = "http://USER:PASS@gate.helodata.io:7777"

Для ротации прокси по запросам используйте scrapy-rotating-proxies и передайте список учётных данных Helodata с липкими сессиями.

Playwright

Передайте конфигурацию прокси в контекст браузера (Python, Node.js, Java, .NET — все используют одинаковый формат):

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(proxy={
        "server": "http://gate.helodata.io:7777",
        "username": "USER",
        "password": "PASS",
    })
    page = browser.new_page()
    page.goto("https://example.com")

Puppeteer

Puppeteer принимает конфигурацию прокси как аргумент запуска:

import puppeteer from 'puppeteer';

const browser = await puppeteer.launch({
  args: ['--proxy-server=http://gate.helodata.io:7777'],
});
const page = await browser.newPage();
await page.authenticate({ username: 'USER', password: 'PASS' });
await page.goto('https://example.com');

Selenium

Selenium 4+ поддерживает прокси через объект Capabilities:

from selenium import webdriver
from selenium.webdriver.common.proxy import Proxy, ProxyType

proxy = Proxy()
proxy.proxy_type = ProxyType.MANUAL
proxy.http_proxy  = "USER:PASS@gate.helodata.io:7777"
proxy.ssl_proxy   = "USER:PASS@gate.helodata.io:7777"

caps = webdriver.DesiredCapabilities.CHROME.copy()
proxy.add_to_capabilities(caps)
driver = webdriver.Chrome(desired_capabilities=caps)

Apify

Акторы Apify принимают входной параметр proxyConfiguration. Для самостоятельного управления прокси используйте:

{
  "proxyConfiguration": {
    "useApifyProxy": false,
    "proxyUrls": [
      "http://USER:PASS@gate.helodata.io:7777"
    ]
  }
}

Browserless

Browserless поддерживает пользовательские прокси через флаг --proxy-server в параметрах подключения к странице:

https://chrome.browserless.io?token=KEY&--proxy-server=http://gate.helodata.io:7777

Передайте учётные данные для аутентификации через Page.authenticate после подключения.

BeautifulSoup (с requests)

BeautifulSoup парсит HTML — он не выполняет запросы. Используйте его с requests или httpx для получения данных через Helodata:

import requests
from bs4 import BeautifulSoup

PROXY = "http://USER:PASS@gate.helodata.io:7777"
r = requests.get(
    "https://example.com",
    proxies={"http": PROXY, "https": PROXY},
)
soup = BeautifulSoup(r.text, "html.parser")

Миграция с zyte

zyte Smart Proxy Manager и zyte API предоставляют прокси-конечные точки, аналогичные Helodata. Чтобы мигрировать:

1. Замените proxy.zyte.com:8011 на gate.helodata.io:7777
2. Замените ваш zyte API-ключ на учётные данные Helodata
3. Липкие сессии: используйте формат username-session-XXXX (совместимо с zyte)
4. Гео-таргетинг: укажите country-XX в имени пользователя (совместимо с zyte)

Большинству существующих интеграций zyte не требуются другие изменения кода. Этичное получение IP и KYC-соответствие Helodata — это дополнительные преимущества, а не замена ценностного предложения zyte.

HTTP-библиотеки

Python requests

import requests

PROXY = "http://USER:PASS@gate.helodata.io:7777"
r = requests.get(
    "https://api.target.com/v1/data",
    proxies={"http": PROXY, "https": PROXY},
    timeout=30,
)

Node.js axios

import axios from 'axios';
import { HttpsProxyAgent } from 'https-proxy-agent';

const agent = new HttpsProxyAgent(
  'http://USER:PASS@gate.helodata.io:7777'
);
const r = await axios.get('https://api.target.com', {
  httpAgent: agent,
  httpsAgent: agent,
  timeout: 30000,
});

Python httpx

import httpx

proxy = "http://USER:PASS@gate.helodata.io:7777"
with httpx.Client(proxies=proxy, timeout=30.0) as client:
    r = client.get("https://api.target.com")

Node.js Cheerio

Cheerio парсит HTML на Node.js, как BeautifulSoup на Python. Используйте с axios или got для получения данных через Helodata:

import axios from 'axios';
import * as cheerio from 'cheerio';
import { HttpsProxyAgent } from 'https-proxy-agent';

const agent = new HttpsProxyAgent(
  'http://USER:PASS@gate.helodata.io:7777'
);
const r = await axios.get('https://example.com', {
  httpsAgent: agent,
});
const $ = cheerio.load(r.data);

curl

curl -x http://USER:PASS@gate.helodata.io:7777 \
     https://api.target.com/v1/data

Не нашли свой инструмент?

Если ваш инструмент поддерживает HTTP- или SOCKS5-прокси — а почти все современные инструменты для работы с данными это делают — Helodata работает. Часто задаваемые сценарии:

• wget, lynx, w3m — стандартный --proxy или переменная окружения http_proxy
• Java HttpClient — System.setProperty("http.proxyHost", ...)
• .NET HttpClient — класс WebProxy
• Rust reqwest — Proxy::http("...")
• PHP Guzzle — опция 'proxy' в конфигурации запроса
• Ruby Faraday — Faraday::ProxyOptions
• Go net/http — Transport.Proxy = http.ProxyURL(...)

Если ваш стек действительно не поддерживает стандартную настройку прокси, напишите в службу поддержки — мы либо задокументируем обходной путь, либо добавим это в дорожную карту.

Часто задаваемые вопросы

Есть ли у Helodata официальная интеграция с LangChain / LlamaIndex / n8n?

Helodata работает с LangChain, LlamaIndex и n8n сегодня через стандартную настройку HTTP-прокси — специальный пакет Helodata не требуется. Нативные интеграции первого уровня (со встроенными функциями авторатации) находятся в нашей дорожной карте на Q3 2026.

Нужен ли мне Helodata SDK для использования Helodata?

Нет. Helodata доступен через стандартные HTTP/SOCKS5, поэтому любой HTTP-клиент или фреймворк для сбора данных работает без специальной библиотеки Helodata. SDK, запускаемые в Q3 2026, добавят удобные функции, такие как авторатация, повторные попытки и типобезопасная обработка ответов — но они опциональны.

Могу ли я мигрировать с Bright Data, Oxylabs или zyte без переписывания кода?

В большинстве случаев — да. Helodata использует тот же протокол HTTP/SOCKS5, что и эти провайдеры, и поддерживает аналогичные соглашения по гео-таргетингу через имя пользователя и липкие сессии. Для большинства клиентов миграция — это замена учётных данных. Напишите в службу поддержки, если хотите получить инструкции по миграции для вашего конкретного стека.

Работает ли Helodata с саморазмещёнными парсерами, такими как Crawlee?

Да. Crawlee, Colly (Go) и другие саморазмещённые фреймворки для сбора данных поддерживают HTTP/SOCKS5-прокси через стандартную настройку. Паттерн интеграции идентичен примерам Scrapy и Puppeteer выше.