A lightweight yet powerful proxy fetching library to bypass web restrictions, inspired by Elaina.

@elainaa/proxy is a modern, promise-based HTTP client proxy. It's designed to help you fetch content from websites that might be otherwise inaccessible by routing requests through a pool of web proxy servers.

• Simple & Intuitive API: Get started in seconds with a clean and modern API.
• Flexible Server Selection: Manually pick from a wide range of US and EU servers.
• Built-in Retry Mechanism: Features a smart .auto() mode that automatically retries with a different server on failure.
• Multiple Usage Patterns: Supports simple function calls, a client factory pattern, and even a drop-in replacement for fetch.

Install the package using NPM or your favorite package manager:

npm install @elainaa/proxy

Here are the different ways you can use the library, from simplest to most advanced.

The default export is a simple function that takes a URL and an optional options object. It returns the response body as a string.

import proxy from '@elainaa/proxy';

// 1. Simple fetch (uses default us1 server)
const html1 = await proxy('https://example.com');

// 2. Fetch with specific server options
const options = { region: 'eu', serverId: 15 };
const html2 = await proxy('https://example.com', options);

For applications making multiple requests with the same configuration, you can create a reusable client instance.

import { createProxyClient } from '@elainaa/proxy';

// Create a client configured for the US server #7
const usClient = createProxyClient({ region: 'us', serverId: 7 });

// Reuse the client for multiple fetches
const page1 = await usClient.fetch('https://example.com/page1');
const page2 = await usClient.fetch('https://example.com/page2');

Let the library handle server selection and retries for you. It will randomly pick a server from the specified region and retry on failure.

import proxy from '@elainaa/proxy';

try {
  // Automatically select a random US server, with up to 3 retries on failure
  const options = { region: 'us', retries: 3 };
  const html = await proxy.auto('https:example.com', options);
  console.log('✅ Success!');
} catch (error) {
  console.error('❌ Failed after multiple attempts:', error);
}

For maximum flexibility, create a proxy-wrapped fetch function that behaves like the standard Web API fetch. This is useful for integrating with existing libraries that expect a fetch-compatible function.

import { createProxyFetch } from '@elainaa/proxy';

// Create a proxied fetch function targeting US server #1
const nefuFetch = createProxyFetch({ region: 'us', serverId: 1 });

// Use it exactly like the standard fetch API
const response = await nefuFetch('https://example.com');

if (response.ok) {
  console.log('Status:', response.status);
  const html = await response.text();
  console.log(html.substring(0, 200));
}

The options object can contain the following properties:

You can choose any combination of the following regions and server IDs.

Happy fetching!