Nstdata Python SDK Quickstart: Tu primer rastreo en 5 minutos
TL;DR
El paquete de Python verificado para Nstdata Crawl es nstdata-ai-crawl; instálalo desde PyPI e importa nstdata_ai_crawl.
Obtén un token en el panel de control de Nstdata y guárdalo en NSTDATA_API_TOKEN, nunca en el código fuente.
El SDK abarca Crawl; Proxy y Proxy Manager son productos separados utilizados a través de URLs proxy, clientes HTTP, o sus interfaces documentadas.
Una solicitud de Crawl en vivo requiere un token de cuenta, así que el ejemplo a continuación está verificado en sintaxis pero no se presenta como una llamada de producción ejecutada.
El inicio rápido de Python de Nstdata tiene un detalle importante de nomenclatura: el nombre de instalación usa guiones, mientras que el nombre de importación usa guiones bajos.
Este bloque coincide con la superficie del SDK instalado. Necesita un token real y consume recursos de servicio en vivo, así que ejecútalo solo después de revisar la configuración actual de la cuenta y de facturación.
import os
from nstdata_ai_crawl import NstDataClient, ScrapeRequestDto, Format
token = os.environ["NSTDATA_API_TOKEN"]with NstDataClient(token)as client: result = client.submit_scrape_task_sync( ScrapeRequestDto( url="https://example.com/", formats=[Format.MARKDOWN], onlyMainContent=True,))print(result)
Valide el éxito a nivel de cuerpo, contenido y marcadores de página esperados antes de almacenar la salida. Una respuesta HTTP por sí sola no prueba que se recuperó el contenido solicitado.
Ejemplo 2: Utilice un Proxy Nstdata en Python
El Proxy Nstdata no requiere el SDK de Crawl. Utilice el punto final del canal generado con un cliente estándar:
ModuleNotFoundError: confirme el entorno virtual y el nombre de importación.
Token faltante: verifique NSTDATA_API_TOKEN en el proceso actual.
Tarea aceptada sin contenido: inspeccione el estado de la tarea y los errores a nivel de cuerpo.
Fallo de autenticación de proxy: regenere el punto final y codifique en URL los componentes de las credenciales.
Timeouts: use reintentos limitados con jitter y no reintente denegaciones permanentes.
Conclusión
Utilice el SDK de Crawl para tareas de raspado, un cliente HTTP estándar para Proxy y una URL de Router para el Administrador de Proxy. Mantener esos límites explícitos facilita la prueba y solución de problemas de la integración.
Experimente Nstdata: Comience su Prueba Gratuita Hoy
Q: ¿Cuál es el nombre del paquete Python de Nstdata?
Instale nstdata-ai-crawl e importe nstdata_ai_crawl.
Q: ¿Un SDK de Python cubre los tres productos de Nstdata?
No existe un SDK unificado verificado; el paquete oficial cubre Crawl, mientras que Proxy y el Administrador de Proxy utilizan sus interfaces de conexión documentadas.
Q: ¿Puedo ejecutar el ejemplo sin un token de API?
No. Una solicitud de Crawl en vivo requiere un token de cuenta.
Q: ¿Dónde debe almacenarse el token?
Utilice una variable de entorno o un gestor de secretos aprobado, nunca un archivo fuente comprometido.
Lena Zhou
Sep. 18th 2026
110M+ IP reales con 99.9% de acceso exitoso
Respuesta media ultrarrapida ~0.5s para tareas de alta concurrencia
Desde solo $0.1/GB
Acceso inmediato a pools premium de proxies residenciales, datacenter, IPv6 e ISP.
