SuperAPI AI 工具集

tiktok-ads

营销与增长

查看项目

更新于 10-15 21:41

技能介绍

用途:通过官方 TikTok Business API v1.3 直接操作 TikTok 广告,使用内置包装脚本而非 SDK 或手写 HTTP 请求。

主要能力:支持广告主查询、账户信息、广告系列/广告组/广告的读取与创建、更新、状态变更,以及报表读取;可调用其他已文档化的 v1.3 端点,并支持流式 multipart 上传本地文件。

使用方式:仅需 Python 3,命令统一通过 scripts/tiktok_ads.sh 执行,API 主机固定为 https://business-api.tiktok.com,路径限定在 /open_api/v1.3/。授权需 TIKTOK_ADS_APP_ID 与 TIKTOK_ADS_APP_SECRET,缺失时按设置指南提示用户补充。无 Access-Token 时运行 bash <skill-path>/scripts/tiktok_ads.sh authorize 作为后台任务,回调默认监听 localhost:51021/callback,完成后凭证保存至 ${XDG_CONFIG_HOME:-~/.config}/tiktok-ads/credentials.json(0600)。可用 auth-status 查看授权,refresh-token 处理短期账户令牌刷新。

限制与安全:所有非 GET 操作默认预览,需用户确认后加 --execute;变更前需核对目标对象,变更后需回读验证;不自动重试写入操作;令牌仅通过官方 Access-Token 头传递,输出中脱敏;密钥文件须为当前用户所有、非符号链接、权限 0400 或 0600。长期 Marketing API 令牌不支持刷新端点,失效后需重新授权。具体端点可用性与参数以官方 v1.3 参考为准。