Drop Graviix Into the Stack You Already Use

Supported languages and tools

Scrapy: per-request or global proxy

Scrapy can apply a proxy globally through downloader middleware or per request through request meta. Use the per-request approach when only some spiders should route through residential IPs, and keep retry middleware enabled so transient failures do not abort a crawl.

# settings.py
DOWNLOADER_MIDDLEWARES = {
    "scrapy.downloadermiddlewares.httpproxy.HttpProxyMiddleware": 110,
}
HTTPPROXY_ENABLED = True
DOWNLOAD_TIMEOUT = 30

# spider request
yield scrapy.Request(
    url,
    meta={
        "proxy": "http://USERNAME:PASSWORD@proxy.graviix.com:8080",
        "download_timeout": 30,
    },
)

Playwright and Puppeteer

Browser automation needs the proxy configured at launch, not per page. Pass credentials in the launch options, then set targeting headers on the browser context. For Puppeteer, the equivalent options are args: ["--proxy-server=http://proxy.graviix.com:8080"] plus page authentication.

const { chromium } = require("playwright");

const browser = await chromium.launch({
  proxy: {
    server: "http://proxy.graviix.com:8080",
    username: "USERNAME",
    password: "PASSWORD",
  },
});

const page = await browser.newPage({
  extraHTTPHeaders: { "X-Graviix-Country": "DE" },
});
await page.goto("https://httpbin.org/ip");
console.log(await page.textContent("body"));
await browser.close();

Environment variables

Many tools read standard proxy environment variables. This is the quickest way to route an existing script without changing its code. Remember that some libraries ignore these variables unless explicitly told to trust them.

export HTTP_PROXY="http://USERNAME:PASSWORD@proxy.graviix.com:8080"
export HTTPS_PROXY="http://USERNAME:PASSWORD@proxy.graviix.com:8080"
export NO_PROXY="localhost,127.0.0.1"

Never commit credentials to a repository. Load the proxy URL from a secret manager or environment file that is excluded from version control.

Compatibility notes

Integration questions