SuperAPI AI 工具集

yandex-direct

营销与增长

查看项目

更新于 10-15 19:57

技能介绍

该技能用于通过 Yandex Direct 官方 API 研究广告、解释结果、准备素材并管理广告账户,适用于单个广告、广告活动或整个账户。使用流程为:明确任务与对象、确定有效转化目标、按所需粒度取数、计算并解释指标、区分观察与决策、准备操作并复查结果。

主要能力:查询账户与权限(accounts.py、whoami.py);查看广告活动与广告组(campaigns.py、adgroups.py);管理广告与关键词(ads.py、keywords.py、keywords_write.py);上传与检查图片(images.py);管理快速链接与说明(extensions.py);重定向与受众(retargeting.py、bids.py);统计、目标与对比报告(report.py);导出结构(campaign_dump.py);组合广告与预览审计(audit_combinatorial.py、ads_generate.py、preview.py);创建与修改(campaign_write.py、ads_write.py、keywords_write.py);Feed、商品广告与筛选(feeds.py、shopping.py);缓存(cache.py)。

使用方式:命令位于 scripts/,可用 uv run scripts/… 运行,也支持 Python 3.11 及以上的 python3 scripts/…,无第三方库;参数通过 --help 查看。命令会读取 config/.env,不展示令牌;连接新账户见 config/README.md。需指定 --account 以保留当前广告主。写操作默认只显示计划,加 --apply 才执行并重读对象。

限制:指标需基于用户选定的转化目标,未选择前不做转化、CPA 与效果结论;零分母显示“无数据”而非 0;不可跨账户沿用目标;比较需保持相同目标、归因、币种、含税与筛选口径;查询历史仅限最近 180 天;部分广告设置无法通过 API 检查,需在界面核对;旧 TextAd 主文案无法由现成命令修改。官方资料未提供安装命令、收费与价格信息。