Agentes de IA

Cómo un agente de IA alquila un proxy móvil por un día o 30 días, rota su IP y amplía el alquiler con tu saldo prepago, con una clave de API y un límite diario.

En esta página

Un agente de IA puede recorrer todo el ciclo por sí mismo a través de la API: consultar las ofertas, añadir saldo con sus propios USDC, alquilar un proxy móvil dedicado por 1 o 30 días, obtener los datos de conexión, rotar su IP y ampliar el alquiler. Lo configuras una vez con una clave de API; después no necesita el panel.

El ciclo

  1. Consultar las ofertas: GET /stock, sin clave.
  2. Añadir saldo: GET /fund?amountMinor=N responde 402 con una oferta. El agente firma una transferencia de USDC en Base, la envía con su clave y consulta statusUrl hasta que el pago queda credited, normalmente en pocos minutos. De US$1 a US$500 por recarga; los detalles están en «Añadir saldo desde tu agente» de la referencia de la API.
  3. Alquilar: POST /rentals con una Idempotency-Key y lo máximo que puede pagar por dispositivo en maxPriceMinor, y luego GET /orders/{orderId} mientras el pedido esté en paid.
  4. Obtener los datos de conexión: cuando el pedido está fulfilled, GET /rentals/{id} da el host, los puertos, el usuario y la contraseña del proxy.
  5. Rotar: POST /rentals/{id}/rotate pide una IP nueva.
  6. Ampliar: GET /rentals/{id}/extension-price y luego POST /rentals/{id}/extend con una Idempotency-Key y maxPriceMinor.

Alquilar y ampliar gastan el saldo y cuentan para el límite diario de la clave. Una recarga gasta los USDC del propio agente, nunca el dinero del cliente, y no se reembolsa en la cadena: queda como saldo.

Configúralo una vez

  1. En Account settings → API keys del panel, crea una clave de lectura y escritura, con una caducidad de 30 o 90 días y un límite diario. Copia la clave: solo se muestra una vez.
  2. Da la clave al agente en la variable de entorno IPVOLT_API_KEY, nunca en un prompt.
  3. Para las recargas, dale una cartera con USDC en Base, con la clave privada también en su entorno. También puedes añadir saldo tú mismo en el panel.

Una clave de solo lectura permite al agente mirar sin gastar. La referencia de la API tiene todos los endpoints, los errores y ejemplos en cURL, Python y Node.js, uno de ellos una recarga seguida de un alquiler.

Proxy Toolkit MCP

Ejecutado en local, el servidor Proxy Toolkit MCP (en inglés) añade herramientas de cuenta cuando IPVOLT_API_KEY está definida en su entorno; usan la API con esa clave. Sin la variable, el servidor local no tiene herramientas de cuenta, y el servidor alojado en https://mcp.ipvolt.com/mcp mantiene sus cuatro herramientas, que no necesitan clave.

json
{
  "mcpServers": {
    "ipvolt-proxy-toolkit": {
      "command": "npx",
      "args": [
        "--yes",
        "@ipvolt/proxy-toolkit-mcp@0.3.0"
      ],
      "env": {
        "IPVOLT_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

La configuración contiene la clave, así que mantén el archivo privado. Para probar las herramientas antes de tener una cuenta, define IPVOLT_SANDBOX con el valor 1 en lugar de la clave: entonces funcionan sobre una cuenta simulada dentro del servidor local, no envían ninguna petición a ipvolt y no cobran nada.

Sin cuenta

Un agente también puede alquilar un proxy móvil dedicado sin una cuenta de ipvolt. Crea un pedido con POST /guest/orders, aceptando los Términos, y recibe una sola vez un ID de factura (invoice ID). Paga con sus propios USDC en la dirección de pago de arriba, enviando el ID de factura en la cabecera Authorization, y después alquila con POST /rentals. GET /guest indica los pasos, la versión de los Términos y los límites. El ID de factura es la única forma de volver al pedido: el agente debe mantenerlo en secreto y a salvo. Un paquete de tráfico funciona igual: el pedido indica su packId y POST /traffic/purchase lo compra con el saldo del pedido.

Tokens de agente

Un agente también puede obtener acceso con auth.md en lugar de una clave: lo confirmas con un código de 6 dígitos y eliges acceso de solo lectura o un límite de gasto.

La Política de uso aceptable (en inglés) se aplica a todo lo que un agente hace a través de la API.

Conecta tu primer proxy.

Móvil desde US$9 al día. Residencial desde US$0.60 por GB, en paquetes desde US$5.