Unofficial Windscribe proxy SDK with custom SNI support, bulk testing, and session management for Node.js
npm install windscribe-proxy-sdkbash
npm install windscribe-proxy-sdk
`
$3
`javascript
const { session, serverCredentials, testProxy } = require('windscribe-proxy-sdk');
// Login and test a proxy
await session('username', 'password');
await serverCredentials();
const result = await testProxy('us-east-001.totallyacdn.com');
console.log(✅ Connected! IP: ${result.ip}, Latency: ${result.latency}ms);
`
$3
`javascript
const { WindscribeSDK } = require('windscribe-proxy-sdk');
const sdk = new WindscribeSDK({
autoReconnect: true,
enableLogging: true,
healthCheckInterval: 30000
});
// Event-driven monitoring
sdk.on('proxy_connected', (server) => {
console.log(Connected to: ${server.hostname});
});
sdk.on('health_check', (result) => {
console.log(Health: ${result.status}, Latency: ${result.latency}ms);
});
// Advanced operations
await sdk.session('username', 'password');
const bestServers = await sdk.findBestServers({
country: 'US',
maxLatency: 500,
testCount: 10
});
`
📚 Core API
$3
`javascript
// Basic login
await session('username', 'password');
// Login with 2FA
await session('username', 'password', '123456');
// Get proxy credentials
await serverCredentials();
`
$3
`javascript
// Test single proxy
const result = await testProxy('proxy.windscribe.com');
// Advanced testing with custom SNI
const result = await testCustomProxy({
hostname: 'proxy.windscribe.com',
port: 443,
customSni: 'www.google.com',
targetUrl: 'https://httpbin.org/ip'
});
// Bulk testing with concurrency
const results = await bulkTestProxies(proxies, {
concurrency: 5,
timeout: 10000,
customSni: 'www.google.com'
});
`
$3
`javascript
// Find best servers by location
const bestServers = await sdk.findBestServers({
country: 'US',
maxLatency: 300,
testCount: 5
});
// Real-time connection monitoring
const monitoring = await sdk.monitorConnection(
'us-central-001.windscribe.com',
443,
60000 // Monitor for 1 minute
);
// Load balancing across servers
const response = await sdk.loadBalanceRequests([
'us-east-001.windscribe.com',
'us-west-001.windscribe.com'
], 'https://httpbin.org/ip');
// Get detailed statistics
const stats = sdk.getStatistics();
console.log(Success Rate: ${stats.successRate}%);
`
💡 Examples
Check out the examples/ directory for complete usage examples:
$3
`bash
Update credentials in login.js first
node examples/login.js
`
$3
`bash
Load session and test all available servers
node examples/testproxy.js
`
$3
`bash
Test with enhanced privacy using custom SNI
node examples/customreq.js
`
$3
`bash
Monitor proxy connections with health checks
node examples/monitoring.js
`
$3
`bash
Distribute requests across multiple servers
node examples/loadbalance.js
`
$3
`bash
Step 1: Update credentials in login.js
Step 2: Login and save session
node examples/login.js
Step 3: Test custom proxy with SNI
node examples/customreq.js
Step 4: (Optional) Test all servers
node examples/testproxy.js
Step 5: (Optional) Try advanced monitoring
node examples/monitoring.js
`
🔧 Advanced Configuration
$3
`javascript
// Most effective SNI options (recommended)
customSni: 'www.google.com' // Best overall performance
customSni: 'cloudflare.com' // Alternative option
customSni: 'www.microsoft.com' // Corporate environments
`
$3
`javascript
const sdk = new WindscribeSDK({
autoReconnect: true, // Enable auto-reconnection
enableLogging: true, // Enable debug logging
healthCheckInterval: 30000, // Health check interval (ms)
maxRetries: 3, // Max connection retries
timeout: 10000, // Request timeout (ms)
cacheTimeout: 600000 // Server cache timeout (ms)
});
`
$3
`javascript
const results = await bulkTestProxies(proxies, {
concurrency: 3, // Concurrent connections
timeout: 10000, // Connection timeout
customSni: 'www.google.com',
retries: 2 // Retry failed connections
});
`
📖 API Reference
$3
| Method | Description | Returns |
|--------|-------------|---------|
| session(user, pass, 2fa?) | Authenticate with Windscribe | Promise