webshare/.kiro/steering/tech.md

inclusion
always

Technology Stack

Language & Runtime

• Python 3: Main scripting language with UTF-8 encoding support
• Bash: Shell scripting for automation

Dependencies

• requests: HTTP client for API calls
• yaml: YAML configuration file generation
• json: JSON configuration handling
• base64: Encoding for V2Ray subscriptions
• os: Environment variable and file system operations

Configuration Formats

• YAML: Clash proxy client configurations
• JSON: SingBox and V2Ray configurations
• Plain text: Raw proxy lists in various formats
• Base64: V2Ray subscription links

Common Commands

Setup

# Install dependencies (if using pip)
pip install requests pyyaml

# Set up environment
echo "TOKEN=your_webshare_api_key" > .env

Execution

# Run the main proxy fetcher
python3 fetch_proxies.py

# Quick API test (manual)
bash pr.sh

Output Files Generated

• proxies_raw.txt: Raw format (host:port:username:password)
• proxies_http.txt: HTTP format URLs
• proxies_socks5.txt: SOCKS5 format URLs
• clash_config.yaml: Clash client configuration
• singbox_config.json: SingBox client configuration
• v2ray_config.json: V2Ray client configuration
• v2ray_subscription.txt: Base64 encoded subscription

API Integration

• Webshare.io API v2: Primary proxy source
• Token-based authentication with download tokens
• RESTful endpoints for proxy list retrieval