Установка и обновление

DuckoNet 0.11.5 работает с 64-битным CPython 3.12. Выберите пакет для своей ОС и устанавливайте его в отдельное виртуальное окружение.

Windows

Пакет предназначен для Windows x64. Windows 11 совместима с текущей поставкой. Жёсткой проверки «только Windows 11» в библиотеке нет: на Windows 10 запуск зависит от доступности системного механизма идентификатора загрузки. Единого минимального номера сборки Windows библиотека не заявляет. Windows 7 и 8 не поддерживаются штатным CPython 3.12; совместимость с Windows 8.1 не заявляется.

SQLite включена в нативное ядро DuckoNet. Отдельно устанавливать SQLite или подбирать системную winsqlite3.dll не нужно. Это не отменяет остальных требований к Windows и Python.

Скачайте файл duckonet-0.11.5-cp312-none-win_amd64.whl. Выполните команды из каталога, куда он сохранён:

py -3.12 -m venv .venv
.venv\Scripts\python.exe -m pip install ./duckonet-0.11.5-cp312-none-win_amd64.whl

Linux

Пакет предназначен для Ubuntu 24.04 x64. В системе должны быть Python 3.12 и модуль venv. Скачайте duckonet-0.11.5-cp312-none-linux_x86_64.whl и выполните из того же каталога:

python3.12 -m venv .venv
.venv/bin/python -m pip install ./duckonet-0.11.5-cp312-none-linux_x86_64.whl

Pip установит зависимости пакета. Не используйте --no-deps для обычной установки. Другие версии Python, macOS и ARM этой поставкой не поддерживаются.

Первый запрос

Сохраните свой API-ключ в переменной окружения DUCKONET_API_KEY:

import os
from duckonet import HttpClient

with HttpClient(api_key=os.environ["DUCKONET_API_KEY"], browser="chrome") as client:
    response = client.get("https://example.com/")
    response.raise_for_status()
    print(response.text)

Клиент сам подготавливает установку, получает каталог и загружает подходящий подписанный профиль. Передавать доверенные ключи, собирать низкоуровневые объекты или устанавливать сам браузер для такого запроса не нужно. Первый запуск требует доступа к сервисам DuckoLab.

Версия браузера и обновления

Без version клиент выбирает доступную версию при открытии. Полная строка версии закрепляет конкретный профиль. Чтобы получать новые доступные профили во время длительной работы, используйте version="last" и обозначайте каждый полный прогон через client.run(). Новое поколение выбирается между прогонами; начатый прогон и открытые соединения сохраняют свой профиль. Библиотека не перезапускает ваш скрипт самостоятельно.

last означает последнюю опубликованную совместимую версию, разрешённую вашему ключу. Free и Pro могут получать разные версии. Наличие файла в локальном кеше не даёт доступа к Pro без действующих прав. В библиотеку не вложен полный комплект браузерных профилей: нужные файлы загружаются по запросу.

Сохранение установки и cookies

При обновлении пакета сохраняйте прежний state_dir. По умолчанию используется ~/.duckonet/default; это каталог состояния установки, доверия и загруженных данных. Не удаляйте его для устранения временной ошибки связи.

Cookies автоматически обрабатываются внутри клиента и сохраняются при смене профиля между прогонами. Для переноса cookies через закрытие приложения нужны явные export_data() и import_data(). Параметр persist_cookies отвечает за обработку Set-Cookie, а не за запись cookies на диск.

После временной сетевой ошибки создайте новый клиент с тем же ключом и state_dir. Прерванная первичная регистрация продолжается автоматически, в том числе после истечения подтверждения. Доступ без сети возможен только пока пригодны сохранённые данные и права; проверки подписи, сроков и отзыва не отключаются.

Версия установленного пакета

from importlib.metadata import version
print(version("duckonet"))

Подробнее: обновление профилей, cookies, прокси и ошибки.

Скачать DuckoNet 0.11.5

• win_amd64
• linux_x86_64

Доступные браузеры

Для Chrome используйте browser="chrome", для Microsoft Edge — browser="edge". Значение version="last" выбирает последнюю опубликованную совместимую версию, доступную вашему API-ключу. Полная версия закрепляет конкретный профиль. Примеры Edge.

Полные номера профилей

Текст страницы