Casos de uso
Actualizado:
Cada flujo muestra un ejemplo de solicitud y las herramientas a las que recurre el asistente, en orden. No es necesario nombrar las herramientas; basta con un lenguaje sencillo.
Comprueba qué va a caducar
💬 «¿Cuáles de mis proxies IPv4 caducan en los próximos 7 días? Muestra la IP, el país y la fecha de caducidad».
Una llamada: list_proxies con type: "ipv4", ends: true.
Comprar proxies
💬 «Compra 10 proxies IPv4 de EE. UU. durante 1 mes para Google; paga con el saldo».
get_reference — Códigos de país y de época válidos.
calc_order_cost — Precio: el asistente lo muestra y pide confirmación.
get_balance — ¿Hay fondos suficientes?
make_order — tras tu confirmación.
comprobar_estado_del_pedido — hasta que se emitan las delegaciones.
export_proxies —
ip:portlíneas, más una nota indicando que se han omitido las contraseñas; con tu confirmación,reveal: truepara «connectable»login:password@host:portlíneas.
Consigue proxies residenciales para una ubicación
💬 «Dame 5 proxies residenciales en Berlín, con IP fija, en el formato nombre de usuario:contraseña@servidor:puerto».
get_resident_geo_count —
country: "DE",city: "Berlin"— ¿Hay nodos?add_resident_list —
ports: 5,rotation: -1,country: "DE",city: "Berlin"— la región que necesita la API (State of Berlin) se busca automáticamente.export_proxies —
type: "resident",listId,ext: "%login%:%password%@%ip%:%port%"— La plantilla solicita credenciales, por lo que el asistente lo confirma contigo y lo transmitereveal: true.
Sin el paso de confirmación, una plantilla que nombre %password% se rechaza y el asistente te pregunta primero; se devuelve una exportación sin formato (sin plantilla) como ip:port líneas con una nota indicando que se han omitido las contraseñas; eso es lo habitual, no un error.
Analizar el tráfico residencial
💬 «¿Cuánto tráfico residencial consumí en agosto y cuánto me costó? ¿Qué lista consumió más?»
get_resident_consumption —
date_start: "2026-08-01",date_end: "2026-08-31".get_resident_package — lo que queda.
Da a un compañero de equipo su propio tráfico
💬 «Crea un subusuario con 5 GB y una lista de EE. UU. con 20 puertos, con rotación cada 5 minutos».
get_resident_package — ¿Queda suficiente tráfico?
create_resident_subpackage —
traffic_limit: 5368709120,is_link_date: true.add_resident_subuser_list —
country: "US",ports: 20,rotation: 300.export_proxies —
type: "subresident",package_key— unip:portlista; con tu confirmación,reveal: truepor las credenciales que facilites.
Déjalo para más tarde:
💬 «Pon en pausa a ese subusuario»
→ update_resident_subpackage con is_active: false.
No dejes que caduquen nunca los proxies
💬 «Activa la renovación automática de todos mis proxies de mi proveedor de Internet desde el saldo y recarga 50 $ cada vez que el saldo baje de los 20 $».
calc_autoprolong_cost — importe recurrente y fecha del próximo cargo.
enable_autoprolong — tras confirmación.
get_autotopup — ¿Una carta está vinculada?
set_autotopup —
threshold: 20,amount: 50.
Ambos elementos alimentan una acusación recurrente; véase Pagos y seguridad.
Corregir un proxy defectuoso
💬 «El proxy 185.x.x.x no funciona, cámbialo».
list_proxies — Encuéntralo.
replace_proxy —
reason: "NOT_WORK".
Gestionar el acceso
💬 «Añade mi IP 1.1.1.1 a la lista blanca para el pedido 1234567»
Una llamada: add_auth con ip, orderNumber.
💬 «Cambia la contraseña de esa cuenta a…»
list_auth — Busca la autorización.
change_auth — Envía solo los cambios.
💬 «Cambia la lista blanca del orden 1234567 a 2.2.2.2»
→ list_auth → change_auth (ip).
💬 «Bloquear el acceso desde 1.1.1.1»
→ list_auth → delete_auth — No se puede desactivar una autorización de IP sin una nueva IP.
Crear una integración
💬 «¿Cómo renuevo los proxies a través de la API? Muestra un ejemplo en Node.js».
ps_docs_search — Busca la página correcta.
ps_api_get_endpoint — Lee las instrucciones.
ps_sdk_snippet —
lang: "node".
Funciona únicamente con docs:read — Nunca se toca tu cuenta.