Idioma
Iniciar sesión Regístrate

Compra agéntica: la superficie x402 y MCP de Proxy4G

Proxy4G expone una superficie de compra legible por máquina para que los agentes de IA autónomos puedan financiar un saldo y comprar proxies móviles sin intervención humana. El flujo utiliza el protocolo de pago x402 (esquema exact, USDC en Base) a través de un único endpoint, /agent-api.php, devolviendo una respuesta real HTTP 402 Payment Required que tu agente liquida con una autorización USDC EIP-3009.

Compra agéntica: la superficie x402 y MCP de Proxy4G

La superficie agéntica es un espejo programático de nuestro checkout humano: un agente lee un archivo de descubrimiento, crea una cuenta para obtener un token Bearer, solicita una recarga de saldo, recibe un HTTP 402 con un bloque accepts, firma un pago USDC en Base, lo reenvía con una cabecera X-PAYMENT y luego gasta el saldo financiado en cualquiera de nuestros 18 países y 43 operadores. Sin tarjeta, sin PayPal, sin paso de aprobación humana.

¿Para qué sirve la superficie x402 + MCP?

x402 revive el código de estado HTTP 402 Payment Required latente como un verdadero protocolo de pago: una solicitud no autenticada o sin financiación devuelve un 402 más un bloque estructurado accepts que describe exactamente cómo pagar, el agente paga y reenvía la misma solicitud con la prueba. Proxy4G implementa esto para la única acción que necesita dinero —financiar el saldo de una billetera— de modo que un agente autónomo pueda comprar proxies móviles 4G de principio a fin.

Este es el mismo saldo descrito en nuestro checkout con cripto: los humanos recargan con Bitcoin, Ethereum, Solana o USDT, mientras que los agentes recargan con USDC en Base mediante x402. Una vez financiado, el saldo compra planes dedicados o SOCKS5 a través de la misma lógica de pedido. Si estás construyendo infraestructura autónoma, consulta el caso de uso de agentes de IA y automatización para conocer patrones de ejecución.

La superficie agéntica de un vistazo

402Estado HTTP para el pago
USDCActivo de liquidación
BaseRed de liquidación
exactEsquema x402

¿Cómo descubre un agente la API?

Antes de realizar transacciones, un agente debe obtener los descriptores legibles por máquina para poder planificar el flujo sin tener que extraer datos del HTML. Se sirven tres archivos en la raíz del sitio:

  • /.well-known/agent.json — la tarjeta del agente: capacidades, la base /agent-api.php y el esquema de pago (x402, exact, USDC en Base).
  • /openapi.json — la definición OpenAPI completa de cada acción (account, topup, endpoints de pedido) con las estructuras de solicitud/respuesta.
  • /llms.txt — un mapa en texto plano del sitio para los rastreadores de modelos de lenguaje, con un complemento /pricing.md para la tabla de precios por país.

El descubrimiento es de solo lectura y no autenticado, de modo que un agente puede decidir si comprar y qué comprar antes incluso de crear una cuenta o mover fondos.

El flujo de compra: configurar → cotizar → pagar → aprovisionar

  1. 1

    Configurar

    El agente lee agent.json y pricing.md, luego elige un plan entre 18 países / 43 operadores — p. ej. un puerto dedicado US T-Mobile 5G, o una IP compartida France Free Mobile que rota cada 5 minutos.

  2. 2

    Cuenta

    POST /agent-api.php?action=account crea una cuenta sin KYC en la primera llamada y devuelve un token Bearer. No se requiere verificación de nombre, dirección, teléfono ni correo electrónico.

  3. 3

    Cotizar

    POST /agent-api.php?action=topup con la cabecera X-Payment-Mode: x402 y sin prueba de pago devuelve un HTTP 402 más un bloque accepts (esquema exact, activo USDC, red Base, importe, dirección payTo, nonce/validez).

  4. 4

    Pagar

    El agente firma una transferWithAuthorization EIP-3009 por el importe USDC cotizado a la dirección payTo en Base, produciendo una carga útil de autorización firmada.

  5. 5

    Liquidar

    Reenvía la misma solicitud de recarga con la cabecera X-PAYMENT que lleva la autorización firmada. Tras la verificación, se acredita el saldo y la respuesta devuelve 200.

  6. 6

    Aprovisionar

    El saldo financiado compra el plan elegido. Las credenciales (HOST, PORT, usuario, contraseña) se envían por correo en minutos, y el acceso HTTP/HTTPS/SOCKS5 queda activo con una IP de operador con puntuación de confianza del 100%.

Paso 1 — crear una cuenta, obtener un token Bearer

bash
curl -s -X POST 'https://proxy4g.co/agent-api.php?action=account' \
  -H 'Content-Type: application/json'

# 200 OK
# {
#   "account_id": "acct_...",
#   "token": "BEARER_TOKEN",
#   "balance_usdc": "0.00"
# }

Paso 2 — solicitar una recarga, recibir la cotización 402

bash
curl -s -i -X POST 'https://proxy4g.co/agent-api.php?action=topup' \
  -H 'Authorization: Bearer BEARER_TOKEN' \
  -H 'X-Payment-Mode: x402' \
  -H 'Content-Type: application/json' \
  -d '{"amount_usd": 27}'

# HTTP/1.1 402 Payment Required
# {
#   "x402Version": 1,
#   "accepts": [{
#     "scheme": "exact",
#     "network": "base",
#     "asset": "USDC",
#     "maxAmountRequired": "27000000",
#     "payTo": "0xYOUR_PAYTO_ADDRESS",
#     "resource": "/agent-api.php?action=topup",
#     "nonce": "0x...",
#     "validUntil": 1748505600
#   }]
# }

Paso 3 — firmar EIP-3009 y reenviar con X-PAYMENT

bash
# Sign an EIP-3009 transferWithAuthorization for the quoted USDC
# amount to payTo on Base, then base64 the payload into X-PAYMENT.

curl -s -X POST 'https://proxy4g.co/agent-api.php?action=topup' \
  -H 'Authorization: Bearer BEARER_TOKEN' \
  -H 'X-Payment-Mode: x402' \
  -H 'X-PAYMENT: <base64 signed authorization>' \
  -H 'Content-Type: application/json' \
  -d '{"amount_usd": 27}'

# 200 OK -> balance credited; spend it on any plan.
# Verify a provisioned proxy:
# curl -x http://USER:PASS@HOST:PORT https://api.ipify.org

Lo que el flujo agéntico hereda del flujo humano

  • Sin KYC: sin documento de identidad oficial, sin nombre ni dirección, sin teléfono, sin verificación de correo electrónico — la cuenta se crea automáticamente en la primera llamada
  • IPs de operadores reales en SIMs físicas en 18 países y 43 operadores, puntuación de confianza del 100%
  • La misma lógica de planes: dedicado (rotación bajo demanda o automática cada 1–60 min) o compartido (rotación automática cada 5 min)
  • Los tres protocolos: HTTP, HTTPS y SOCKS5, con autenticación por usuario/contraseña o por lista blanca de IP
  • No registramos el tráfico de destino — las compras agénticas no conllevan telemetría adicional

Construye con la superficie agéntica

Preguntas frecuentes

¿Qué es x402 y por qué lo usa Proxy4G?

x402 es un protocolo de pago construido sobre el código de estado HTTP 402 Payment Required. Una solicitud que necesita fondos devuelve un 402 con un bloque estructurado accepts que describe cómo pagar; el cliente paga y reenvía la solicitud con la prueba. Proxy4G lo usa para que los agentes autónomos puedan financiar un saldo con USDC en Base y comprar proxies móviles sin ningún paso de checkout humano.

¿Qué red y qué activo utiliza el pago del agente?

El esquema es exact, el activo es USDC y la liquidación se realiza en la red Base. El agente firma una transferWithAuthorization EIP-3009 por el importe cotizado a la dirección payTo devuelta en la respuesta 402, y luego reenvía la solicitud con esa autorización firmada en la cabecera X-PAYMENT.

¿Necesitan los agentes completar el KYC?

No. El flujo agéntico hereda nuestro modelo sin KYC: sin documento de identidad oficial, sin nombre ni dirección, sin teléfono y sin verificación de correo electrónico. La cuenta se crea automáticamente en la primera llamada action=account, y no registramos el tráfico de destino.

¿Cómo descubre un agente la API sin extraer datos del HTML?

Obtén los descriptores servidos en la raíz del sitio: /.well-known/agent.json para la tarjeta del agente y el esquema de pago, /openapi.json para los esquemas de acción completos, y /llms.txt más /pricing.md para el mapa del sitio y la tabla de precios. Todo el descubrimiento es de solo lectura y no autenticado.

¿Qué recibe el agente tras una compra exitosa?

Lo mismo que recibe un comprador humano: credenciales de proxy —host, puerto, usuario y contraseña— enviadas por correo en cuestión de minutos tras el pedido. El proxy admite HTTP, HTTPS y SOCKS5, con autenticación por usuario/contraseña o por lista blanca de IP, sobre una IP de operador real de uno de los 18 países y 43 operadores.

¿Puede el agente reutilizar el saldo para varios pedidos?

Sí. La recarga acredita el saldo de una billetera, no un único pedido. Una vez financiado con USDC en Base, un agente puede realizar varios pedidos con cargo a ese saldo —por ejemplo, varios puertos dedicados en distintos países— y recargar de nuevo con otro ciclo x402 cuando el saldo se agote.

Construye la compra autónoma de proxies

Apunta tu agente a /.well-known/agent.json, financia un saldo en USDC mediante x402 y aprovisiona IPs de operadores reales sin intervención humana.

Lee la tarjeta del agente