webshare/.kiro/steering/tech.md

56 lines
1.4 KiB
Markdown

---
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
```bash
# Install dependencies (if using pip)
pip install requests pyyaml
# Set up environment
echo "TOKEN=your_webshare_api_key" > .env
```
### Execution
```bash
# 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