用途：通过 Yandex Direct API v5 管理广告账户，覆盖广告系列、广告组、广告、关键词、出价调整、受众定向、附加信息与统计报告等操作。
主要能力：提供 campaigns.sh、ads.sh、keywords.sh、reports.sh、dictionaries.sh 等脚本，可列出/获取/暂停/恢复/归档广告系列与广告，管理关键词与自动定向，拉取广告系列、广告组、广告、关键词、搜索词、人群等维度的效果报告，并获取地区、货币等参考数据。API 还包含 BidModifiers、AudienceTargets、RetargetingLists、Strategies、Feeds 等服务。
使用方式：在 config/.env 配置 YANDEX_DIRECT_TOKEN，可选 YANDEX_DIRECT_SANDBOX=true 与 YANDEX_DIRECT_CLIENT_LOGIN。所有请求需 Authorization: Bearer 令牌与 Content-Type: application/json; charset=utf-8。脚本须用 bash 前缀和绝对路径运行，例如 bash scripts/check_connection.sh、bash scripts/campaigns.sh --action list --states ON、bash scripts/reports.sh --date-range LAST_7_DAYS。自定义调用可在 bash 脚本中 source scripts/common.sh 后使用 direct_request。
限制：令牌有效期 1 年；每日 API 点数按账户计算，每小时刷新，错误消耗 20 点；每广告主最多 5 个并发请求；单次分页上限 10000；沙箱与生产隔离，报告每次仅限一个广告系列，闲置 1 个月数据删除。金额在标准接口中以微单位表示，报告可设 returnMoneyInMicros: false。具体价格与更多细节暂未提供。