用途:通过统一 POSIX 脚本 scripts/zoomkit.sh 自动化 Яндекс.Директ 的日常操作,包括检查广告链接与页面错误、配置自动定向归零、查看余额与账单、管理出价规则与链接检查设置。
主要能力:读取类命令有 token、balance、invoices、clients、campaigns、reports、report、report-wait、bidrules、url-check-settings、url-check-tasks、url-check-task;修改类命令有 report-create、report-delete、client-update、autotargeting、bidrule-common-update、bidrule-keywords-create/update/delete、url-check-settings-update。完整响应保存到 cache/latest-<命令>.json,可用 --output 指定路径,--raw 打印完整 JSON。
使用方式:先确定 SKILL.md 所在目录,执行 sh scripts/zoomkit.sh <命令> [参数]。依赖 curl(网络命令)与 jq(校验请求体、解析 JSON)。密钥存于 config/.env,脚本每次运行读取;环境变量仅作临时覆盖。首次使用可运行 sh scripts/zoomkit.sh getting-started(无需密钥与网络),并按 config/README.md 完成注册、充值、发密钥、写入 config/.env、执行 token 验证。修改类命令需 --confirm,可先用 --dry-run 预检;请求体模板在 assets/ 中,应复制后修改。
适用场景:多广告账户审计、出价规则与自动定向配置、链接检查、账单与余额查询。
限制:官方 API 1.9.0 只能读取余额与已开账单,无法创建账单、传任意信息或获取付款链接;自动定向命令会直接创建规则,仅在明确要求修复时执行;诊断请求不得触发修改;价格以官方页面为准,资料未提供具体价格与免费期。