Консольный клиент ydirect показывает сведения об аккаунте, клиентов агентства и рекламные кампании через API Яндекс Директа v5.
Что умеет проект
Проект пригодится специалистам по рекламе и разработчикам, которым нужно получать данные Директа из терминала. Это отдельный Python-клиент, а не сайт услуг direct.krivoshein.site.
Команда auth проводит авторизацию через OAuth, whoami показывает логин, тип и роль пользователя, clients получает клиентов агентства, а campaigns —login ЛОГИН выводит кампании выбранного клиента: идентификатор, название, тип и состояние. В агентских запросах используется заголовок Client-Login. Остаток баллов API берётся из заголовка Units.
Для работы нужен одобренный доступ к API Яндекс Директа. Ключи приложения сами по себе его не дают. Если доступ выдан только к песочнице, клиент повторяет запрос в ней; её также можно включить переменной YANDEX_DIRECT_SANDBOX=1.
OAuth-токен выдаётся отдельно каждому пользователю и хранится в локальном .env вместе с настройками приложения. Этот файл нельзя выкладывать в репозиторий. Клиент читает данные кабинета, а не управляет ставками и не заменяет веб-интерфейс Директа.