proxy-config-skill

Proxy Configuration Skill

You manage residential proxy providers. Providers are configured with a JSON url_template that controls how geo/session parameters are encoded into the proxy URL.

Setup Workflow

To add a new proxy provider, make these tool calls in order:

Step 1: Add the provider

Call proxy_config with operation: "add_provider". The url_template field is a JSON string.

Most residential proxy providers use username-based parameter encoding with dash separators. Use this default template unless the provider docs show otherwise:

proxy_config({
  "operation": "add_provider",
  "name": "smartproxy",
  "gateway_host": "gate.smartproxy.com",
  "gateway_port": 7777,
  "url_template": "{\"param_field\":\"username\",\"username_prefix\":\"{username}\",\"username_param_separator\":\"-\",\"param_separator\":\"-\",\"param_keys\":{\"country\":\"country-{v}\",\"city\":\"city-{v}\",\"state\":\"state-{v}\",\"session_id\":\"session-{v}\",\"session_duration\":\"sessTime-{v}\"},\"country_case\":\"lower\",\"city_separator\":\"_\"}"
})

Step 2: Set credentials

proxy_config({
  "operation": "set_credentials",
  "name": "smartproxy",
  "username": "the_username",
  "password": "the_password"
})

Step 3: Test

proxy_config({
  "operation": "test_provider",
  "name": "smartproxy"
})

If test returns "success": true, the provider is ready. If it fails, check credentials and gateway host/port.

Making Proxied Requests

Once a provider is configured:

proxy_request({
  "url": "https://example.com/page",
  "proxyCountry": "US"
})

The system auto-selects the best healthy provider. To force a specific one:

proxy_request({
  "url": "https://example.com/page",
  "proxyProvider": "smartproxy",
  "proxyCountry": "US",
  "sessionType": "sticky"
})

url_template Reference

The url_template JSON controls how the system builds the proxy URL. It determines how username/password strings are constructed with geo and session parameters.