Nstdata Python SDK Быстрый старт: Ваш первый обход за 5 минут
TL;DR
Проверенный пакет Python для Nstdata Crawl - это nstdata-ai-crawl; установите его из PyPI и импортируйте nstdata_ai_crawl.
Получите токен из панели управления Nstdata и храните его в NSTDATA_API_TOKEN, никогда не в исходном коде.
SDK охватывает Crawl; Proxy и Proxy Manager являются отдельными продуктами, используемыми через прокси-URL, HTTP-клиенты или их задокументированные интерфейсы.
Живой запрос Crawl требует токен учетной записи, поэтому пример ниже подтверждён по синтаксису, но не представлен в виде выполненного производственного вызова.
Быстрый старт Python Nstdata имеет одну важную деталь в наименовании: имя установки использует дефисы, в то время как имя импорта использует подчеркивания.
Этот блок соответствует установленной поверхности SDK. Он требует реального токена и использует ресурсы живого сервиса, поэтому запускайте его только после просмотра текущих настроек аккаунта и выставления счетов.
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)
Проверьте успешность на уровне тела, содержимое и ожидаемые маркеры страницы перед сохранением вывода. Один HTTP-ответ не подтверждает, что запрашиваемый контент был извлечен.
Пример 2: Используйте прокси Nstdata на Python
Прокси Nstdata не требуется SDK для ползания. Используйте сгенерированную конечную точку канала со стандартным клиентом:
ModuleNotFoundError: подтвердите виртуальную среду и имя импорта.
Отсутствует токен: проверьте NSTDATA_API_TOKEN в текущем процессе.
Принятая задача без содержимого: проверьте статус задачи и ошибки на уровне тела.
Ошибка аутентификации прокси: сгенерируйте конечную точку заново и URL-кодируйте компоненты учетных данных.
Таймауты: используйте ограниченные повторы с джиттером и не повторяйте постоянные отказы.
Заключение
Используйте SDK для ползания для задач ползания, стандартный HTTP-клиент для прокси и URL маршрутизатора для менеджера прокси. Ясное разделение этих границ облегчает тестирование и устранение неполадок интеграции.
Попробуйте Nstdata — начните бесплатную пробную версию сегодня
Установите nstdata-ai-crawl и импортируйте nstdata_ai_crawl.
В: Есть ли один SDK Python для всех трех продуктов Nstdata?
Не существует проверенного унифицированного SDK; официальный пакет охватывает Crawl, тогда как Proxy и Proxy Manager используют свои задокументированные интерфейсы подключения.
В: Могу ли я запустить пример без API токена?
Нет. Запрос на ползание требует токена учетной записи.
В: Где должен храниться токен?
Используйте переменную окружения или одобренный менеджер секретов, никогда не сохраняйте в источниках файлов.
Lena Zhou
Sep. 18th 2026
110M+ реальных IP с 99.9% успешных доступов
Средний отклик ~0.5с для задач высокой конкуренции
Всего от $0.1/GB
Мгновенный доступ к премиальным residential, datacenter, IPv6 и ISP пулам.
