webshare/.kiro/steering/product.md

995 B

inclusion
always

Product Overview

This is a proxy management tool that fetches proxy lists from Webshare API and generates configuration files for multiple proxy clients.

Core Functionality

  • Fetches SOCKS/HTTP proxies from Webshare.io API using download tokens
  • Supports multiple output formats: raw, HTTP, SOCKS5
  • Generates configuration files for popular proxy clients:
    • Clash (YAML format)
    • SingBox (JSON format)
    • V2Ray (JSON config + Base64 subscription)

Key Features

  • Automatic API key management from .env file or environment variables
  • Multiple authentication methods (username/password, IP auth)
  • Country and location filtering support
  • Automatic proxy health checking and failover configurations
  • Chinese language support with UTF-8 encoding

Target Users

Developers and users who need to manage proxy configurations across different clients and platforms, particularly those requiring access to geo-restricted content or enhanced privacy.