Sử dụng Helodata với các công cụ nhóm bạn đã dùng

Cách Helodata hoạt động với stack của bạn

Tương thích liền mạch (hiện tại)

Helodata cung cấp endpoint HTTP/SOCKS5 tiêu chuẩn với xác thực tên người dùng:mật khẩu. Bất kỳ client nào hỗ trợ các giao thức này — về cơ bản là mọi thư viện HTTP hiện đại, framework thu thập dữ liệu và trình duyệt headless — đều hoạt động không cần sửa đổi.

Bạn không cần thư viện Helodata chuyên dụng. Bạn không cần viết lại trình thu thập của mình. Chỉ cần trỏ client hiện tại đến cổng của chúng tôi, dán thông tin xác thực từ bảng điều khiển và bạn đã sẵn sàng.

Hỗ trợ đẳng cấp nhất (đang phát triển)

Thư viện native với tự động xoay vòng, thử lại, phiên dạng dính và xử lý phản hồi an toàn kiểu sẽ ra mắt vào Q3 2026:

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

Hiện tại, phương pháp tích hợp liền mạch dưới đây bao gồm mọi quy trình làm việc. Xem lộ trình SDK để biết chi tiết.

Framework AI agent và LLM

LangChain

Sử dụng Helodata làm backend HTTP cho bất kỳ công cụ LangChain nào truy cập web — RequestsGetTool, RequestsPostTool hoặc Tool tùy chỉnh của riêng bạn.

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

Trình đọc web của LlamaIndex sử dụng httpx bên trong. Truyền cấu hình proxy khi xây dựng trình đọc.

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

Nút HTTP Request của n8n có trường proxy trên tab Authentication. Đặt URL cổng Helodata của bạn vào đó — hoạt động cho mọi nút phía sau.

Đối với n8n tự lưu trữ, hãy đặt biến môi trường: N8N_DEFAULT_PROXY=http://USER:PASS@gate.helodata.io:7777

MCP server

MCP server chính thức của Helodata sẽ ra mắt vào Q3 2026 — cài đặt bằng một lệnh, hiển thị khả năng proxy cho Claude Desktop, Cursor, Cline và bất kỳ client tương thích MCP nào.

Cho đến lúc đó, hãy trỏ công cụ HTTP của bất kỳ MCP server nào tới cổng Helodata bằng thông tin xác thực tương tự bạn dùng ở bất kỳ đâu. Nhận thông báo khi MCP server ra mắt →

Framework thu thập dữ liệu web

Scrapy

Scrapy hỗ trợ proxy thông qua HttpProxyMiddleware (đã tích hợp sẵn). Thêm vào settings.py của bạn:

# 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"

Để xoay vòng proxy theo từng yêu cầu, hãy sử dụng scrapy-rotating-proxies và cung cấp danh sách thông tin xác thực phiên dạng dính của Helodata.

Playwright

Truyền cấu hình proxy vào ngữ cảnh trình duyệt (Python, Node.js, Java, .NET đều sử dụng cùng định dạng):

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 nhận cấu hình proxy như một đối số khởi chạy:

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+ hỗ trợ proxy qua đối tượng 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 Actors chấp nhận đầu vào proxyConfiguration. Đối với proxy tự quản lý, hãy sử dụng:

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

Browserless

Browserless hỗ trợ proxy tùy chỉnh qua cờ --proxy-server trong tham số kết nối trang:

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

Truyền thông tin xác thực xác thực qua Page.authenticate sau khi kết nối.

BeautifulSoup (với requests)

BeautifulSoup phân tích cú pháp HTML — nó không tải dữ liệu. Kết hợp với requests hoặc httpx để tải qua 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")

Di chuyển từ zyte

zyte Smart Proxy Manager và zyte API đều cung cấp endpoint proxy tương tự Helodata. Để di chuyển:

1. Thay thế proxy.zyte.com:8011 bằng gate.helodata.io:7777
2. Đổi khóa API zyte của bạn sang thông tin xác thực Helodata
3. Phiên dạng dính: sử dụng định dạng username-session-XXXX (tương thích zyte)
4. Nhắm mục tiêu địa lý: truyền country-XX trong tên người dùng (tương thích zyte)

Hầu hết tích hợp zyte hiện có không cần thay đổi mã nào khác. Việc thu thập IP có đạo đức và tuân thủ KYC của Helodata là những bổ sung ròng, không phải thay thế cho đề xuất giá trị của zyte.

Thư viện 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 phân tích cú pháp HTML trên Node, giống BeautifulSoup trên Python. Kết hợp với axios hoặc got để tải qua 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

Không thấy công cụ của bạn?

Nếu công cụ của bạn hỗ trợ proxy HTTP hoặc SOCKS5 — và hầu hết mọi công cụ dữ liệu hiện đại đều hỗ trợ — Helodata hoạt động được. Các trường hợp phổ biến chúng tôi được hỏi:

• wget, lynx, w3m — --proxy tiêu chuẩn hoặc biến môi trường http_proxy
• Java HttpClient — System.setProperty("http.proxyHost", ...)
• .NET HttpClient — lớp WebProxy
• Rust reqwest — Proxy::http("...")
• PHP Guzzle — tùy chọn 'proxy' trong cấu hình yêu cầu
• Ruby Faraday — Faraday::ProxyOptions
• Go net/http — Transport.Proxy = http.ProxyURL(...)

Nếu stack của bạn thực sự không hỗ trợ cấu hình proxy tiêu chuẩn, gửi email cho nhóm hỗ trợ — chúng tôi sẽ ghi lại giải pháp thay thế hoặc đưa vào lộ trình.

Câu hỏi thường gặp

Helodata có tích hợp chính thức với LangChain / LlamaIndex / n8n không?

Helodata hoạt động với LangChain, LlamaIndex và n8n ngay hôm nay qua cấu hình proxy HTTP tiêu chuẩn — không cần gói Helodata chuyên dụng. Tích hợp native first-party (với các tính năng tự động xoay vòng tích hợp sẵn) đang trong lộ trình Q3 2026 của chúng tôi.

Tôi có cần Helodata SDK để sử dụng Helodata không?

Không. Helodata được truy cập qua HTTP/SOCKS5 tiêu chuẩn, vì vậy bất kỳ HTTP client hoặc framework thu thập dữ liệu nào cũng hoạt động mà không cần thư viện Helodata chuyên dụng. SDK ra mắt Q3 2026 sẽ thêm các tính năng tiện lợi như tự động xoay vòng, thử lại và xử lý phản hồi an toàn kiểu — nhưng chúng là tùy chọn.

Tôi có thể di chuyển từ Bright Data, Oxylabs hoặc zyte mà không cần viết lại mã không?

Trong hầu hết các trường hợp, có. Helodata sử dụng cùng giao thức HTTP/SOCKS5 như các nhà cung cấp đó và hỗ trợ các quy ước nhắm mục tiêu địa lý dựa trên tên người dùng và phiên dạng dính tương tự. Đối với hầu hết khách hàng, việc di chuyển chỉ là thay đổi thông tin xác thực. Gửi email cho nhóm hỗ trợ nếu bạn muốn được hướng dẫn di chuyển cho stack cụ thể của mình.

Helodata có hoạt động với trình thu thập dữ liệu tự lưu trữ như Crawlee không?

Có. Crawlee, Colly (Go) và các framework thu thập dữ liệu tự lưu trữ khác đều hỗ trợ proxy HTTP/SOCKS5 qua cấu hình tiêu chuẩn. Mẫu tích hợp giống hệt các ví dụ Scrapy và Puppeteer ở trên.