diff --git a/cliproxy-traffic-proxy/SKILL.md b/cliproxy-traffic-proxy/SKILL.md new file mode 100644 index 0000000..bd321a7 --- /dev/null +++ b/cliproxy-traffic-proxy/SKILL.md @@ -0,0 +1,142 @@ +--- +name: cliproxy-traffic-proxy +description: Cliproxy traffic proxy integration for CLI workflows. Build and debug authenticated proxy commands for both HTTP (`curl -x`) and SOCKS5 (`curl --socks5`) using dynamic account parameters (`region`, `st`, `sid`, `t`). Use when users need to switch exit country/state, control sticky vs rotating IP behavior, validate proxy formatting, or troubleshoot Cliproxy connection/authentication issues. +--- + +# Cliproxy Traffic Proxy + +## Overview +Generate ready-to-run Cliproxy commands for HTTP and SOCKS5 clients, with correct account parameter formatting and session behavior. +Prefer explicit, copy-paste commands and keep explanations short and operational. + +## Core Inputs To Collect + +- Relay host and port (example: `sg.arxlabs.io:3010`) +- Base username (for account identity) +- Password (for authentication only) +- `region` (ISO 3166-1 alpha-2 code, uppercase) +- Optional `st` (state/province) +- Optional `sid` (session ID) +- Optional `t` (IP duration in minutes, used in sticky mode) +- Proxy mode: `http` or `socks5` +- Target URL for verification (example: `mayips.com`) + +If the user does not provide a relay host, prefer the provider relay nearest to the exit region. Current documented relays are `us.cliproxy.io` and `sg.cliproxy.io`, but always prioritize the endpoint provided by the user/account panel. + +## Account Grammar + +Build account strings using hyphen-separated key-value tokens. + +All parameters: + +`-region--st--sid--t-` + +Required: + +- `` +- `region-` + +Optional: + +- `st-` +- `sid-` +- `t-` + +### Sticky Mode Format + +Use sticky mode when the user wants a stable IP for a session window: + +`-region--st--sid--t-` + +Behavior: + +- Changing `sid` creates a new session and usually a new exit IP. +- Keeping the same `sid` keeps session affinity. +- `t` controls sticky duration; after expiry, IP can rotate automatically. + +### Rotating Mode Format + +Use rotating mode when the user wants frequent IP changes: + +`-region--st-` + +Behavior: + +- Without `sid` stickiness, requests generally rotate across available IPs. + +## Command Templates + +### HTTP Proxy (`curl -x`) + +```bash +curl -x : \ + -U ":" \ + +``` + +### SOCKS5 Proxy (`curl --socks5`) + +```bash +curl --socks5 : \ + -U ":" \ + +``` + +## Canonical Examples + +### HTTP, Japan, Sticky Session + +```bash +curl -x sg.arxlabs.io:3010 \ + -U "p6nq1109601-region-JP-sid-uU2ZHxYn-t-5:w8dadvyn" \ + mayips.com +``` + +### SOCKS5, Japan, Sticky Session + +```bash +curl --socks5 sg.arxlabs.io:3010 \ + -U "p6nq1109601-region-JP-sid-uU2ZHxYn-t-5:w8dadvyn" \ + mayips.com +``` + +### SOCKS5, Vietnam, Sticky Session + +```bash +curl --socks5 sg.arxlabs.io:3010 \ + -U "p6nq1109601-region-VN-sid-vHqJQfpt-t-5:w8dadvyn" \ + mayips.com +``` + +## Generation Workflow + +1. Confirm proxy mode (`http` or `socks5`). +2. Normalize `region` to uppercase two-letter code. +3. Build account string in the requested mode: + - Sticky: include `sid` and optionally `t`. + - Rotating: omit `sid` and `t`. +4. Render one copy-paste command. +5. If requested, render multiple variants (different `region`, `sid`, or mode). +6. Provide one verification target (`mayips.com` or user-provided endpoint). + +## Validation Checklist + +- Use `-x` only for HTTP proxy mode. +- Use `--socks5` for SOCKS5 mode. +- Keep username tokens separated by `-` exactly. +- Ensure password is after `:` inside `-U ":"`. +- Ensure `region` uses ISO two-letter country code (see `references/iso-country-examples.md`). +- Keep credentials unmodified; do not URL-encode unless user asks. + +## Troubleshooting + +- Authentication failure: verify password and full account string (including token order). +- Wrong exit country: verify `region-` code and relay proximity. +- IP not rotating: rotate `sid` or switch to rotating format. +- High latency/timeouts: switch relay (`us` vs `sg`) closer to target region. + +## Output Style + +- Return final command(s) first. +- Keep explanations concise and tied to `region`, `sid`, and mode behavior. +- When user provides real credentials, avoid echoing them repeatedly; show once unless asked. diff --git a/cliproxy-traffic-proxy/agents/openai.yaml b/cliproxy-traffic-proxy/agents/openai.yaml new file mode 100644 index 0000000..a6e3610 --- /dev/null +++ b/cliproxy-traffic-proxy/agents/openai.yaml @@ -0,0 +1,4 @@ +interface: + display_name: "Cliproxy-流量-代理" + short_description: "Build Cliproxy HTTP and SOCKS5 proxy commands" + default_prompt: "Create and verify Cliproxy proxy commands with region, sid, and sticky/rotating parameters." diff --git a/cliproxy-traffic-proxy/references/iso-country-examples.md b/cliproxy-traffic-proxy/references/iso-country-examples.md new file mode 100644 index 0000000..ece6745 --- /dev/null +++ b/cliproxy-traffic-proxy/references/iso-country-examples.md @@ -0,0 +1,26 @@ +# ISO Country Examples + +Use ISO 3166-1 alpha-2 uppercase country codes after `region-`. + +Common examples: + +- `JP` = Japan +- `VN` = Vietnam +- `US` = United States +- `SG` = Singapore +- `HK` = Hong Kong +- `KR` = South Korea +- `DE` = Germany +- `FR` = France +- `GB` = United Kingdom +- `CA` = Canada +- `AU` = Australia +- `IN` = India +- `BR` = Brazil +- `MX` = Mexico + +Example account snippets: + +- `test123456-region-US` +- `test123456-region-SG-t-15` +- `test123456-region-US-st-Louisiana-sid-e6CXdJDm-t-15`