{"_id":"@bluevs/vhcli-tiktok-ads","_rev":"4-27c5ff8c21ac3c1647c6cb10c5dd8e1d","name":"@bluevs/vhcli-tiktok-ads","dist-tags":{"latest":"0.0.17"},"versions":{"0.0.14":{"name":"@bluevs/vhcli-tiktok-ads","version":"0.0.14","license":"MIT","_id":"@bluevs/vhcli-tiktok-ads@0.0.14","maintainers":[{"name":"yuqi.li","email":"yuqi.li1@bluefocus.com"},{"name":"yangyanghou","email":"houyangyang868@gmail.com"},{"name":"ningxin","email":"n-xin@foxmail.com"}],"bin":{"ttcli":"scripts/run.js"},"dist":{"shasum":"3fa832000517a374babcef1f4d385e86c5a8a0d2","tarball":"https://registry.npmjs.org/@bluevs/vhcli-tiktok-ads/-/vhcli-tiktok-ads-0.0.14.tgz","fileCount":4,"integrity":"sha512-c0+fNyRmGvcYcyZMiU9t1unKeNrJ+tLp06lR/rbPb5UtMjyr3VLfHC02+U/zB22WTyz5lcFuO1kx8jOdFnG9Sw==","signatures":[{"sig":"MEUCICUWhC280U6BpFHVzjt0GmI3ntaycGzhTaD68t8YJBZ2AiEA4ivKBx2xtukG9ILDFANHTvgcNO8m6bGkYLFsLy95Hd0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":62434},"engines":{"node":">=16"},"gitHead":"a16ceab8e221440ab86ab70ef2bb726f528da3d2","scripts":{"postinstall":"bash $(npm root -g)/@bluevs/vhcli-tiktok-ads/skills/ttcli/scripts/install-skill.sh 2>&1 || echo '⚠️  skill auto-sync skipped (likely permission/container env). Run manually: bash $(npm root -g)/@bluevs/vhcli-tiktok-ads/skills/ttcli/scripts/install-skill.sh'"},"_npmUser":{"name":"ningxin","email":"n-xin@foxmail.com"},"repository":{"url":"","type":"git"},"_npmVersion":"10.9.8","description":"TikTok CLI - designed for AI Agent and developers","directories":{},"_nodeVersion":"22.23.1","_hasShrinkwrap":false,"optionalDependencies":{"@bluevs/vhcli-tiktok-ads-linux-x64":"0.0.14","@bluevs/vhcli-tiktok-ads-win32-x64":"0.0.14","@bluevs/vhcli-tiktok-ads-darwin-x64":"0.0.14","@bluevs/vhcli-tiktok-ads-linux-arm64":"0.0.14","@bluevs/vhcli-tiktok-ads-win32-arm64":"0.0.14","@bluevs/vhcli-tiktok-ads-darwin-arm64":"0.0.14"},"_npmOperationalInternal":{"tmp":"tmp/vhcli-tiktok-ads_0.0.14_1784102992506_0.4440299349416885","host":"s3://npm-registry-packages-npm-production"}},"0.0.15":{"name":"@bluevs/vhcli-tiktok-ads","version":"0.0.15","license":"MIT","_id":"@bluevs/vhcli-tiktok-ads@0.0.15","maintainers":[{"name":"yuqi.li","email":"yuqi.li1@bluefocus.com"},{"name":"yangyanghou","email":"houyangyang868@gmail.com"},{"name":"ningxin","email":"n-xin@foxmail.com"}],"bin":{"ttcli":"scripts/run.js"},"dist":{"shasum":"f11f9f263623f177e3187cdadbece9506943d159","tarball":"https://registry.npmjs.org/@bluevs/vhcli-tiktok-ads/-/vhcli-tiktok-ads-0.0.15.tgz","fileCount":5,"integrity":"sha512-tNlrwrHgdEV8lnvK0z8RCjqTgXrCKl+a5yQ/UgOila70reaFjjq2gu16xs4+B5mduF5AMGt5kftIqdATLXkcgA==","signatures":[{"sig":"MEYCIQC80MMpCLPanh+I4TDxcdDhmurvQeKQpGZrTSnREGUongIhALhf9LsbjRTS/nPD8Aytcy/KOrV5QRuGii31v6VLNH0m","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":64646},"engines":{"node":">=16"},"gitHead":"a16ceab8e221440ab86ab70ef2bb726f528da3d2","scripts":{"postinstall":"bash $(npm root -g)/@bluevs/vhcli-tiktok-ads/skills/ttcli/scripts/install-skill.sh 2>&1 || echo '⚠️  skill auto-sync skipped (likely permission/container env). Run manually: bash $(npm root -g)/@bluevs/vhcli-tiktok-ads/skills/ttcli/scripts/install-skill.sh'"},"_npmUser":{"name":"ningxin","email":"n-xin@foxmail.com"},"repository":{"url":"","type":"git"},"_npmVersion":"10.9.8","description":"TikTok CLI - designed for AI Agent and developers","directories":{},"_nodeVersion":"22.23.1","_hasShrinkwrap":false,"optionalDependencies":{"@bluevs/vhcli-tiktok-ads-linux-x64":"0.0.15","@bluevs/vhcli-tiktok-ads-win32-x64":"0.0.15","@bluevs/vhcli-tiktok-ads-darwin-x64":"0.0.15","@bluevs/vhcli-tiktok-ads-linux-arm64":"0.0.15","@bluevs/vhcli-tiktok-ads-win32-arm64":"0.0.15","@bluevs/vhcli-tiktok-ads-darwin-arm64":"0.0.15"},"_npmOperationalInternal":{"tmp":"tmp/vhcli-tiktok-ads_0.0.15_1784103754068_0.20760433965330405","host":"s3://npm-registry-packages-npm-production"}},"0.0.16":{"name":"@bluevs/vhcli-tiktok-ads","version":"0.0.16","license":"MIT","_id":"@bluevs/vhcli-tiktok-ads@0.0.16","maintainers":[{"name":"yuqi.li","email":"yuqi.li1@bluefocus.com"},{"name":"yangyanghou","email":"houyangyang868@gmail.com"},{"name":"ningxin","email":"n-xin@foxmail.com"}],"bin":{"ttcli":"scripts/run.js"},"dist":{"shasum":"faf80cc9d1ce123d2a4c456fd6b0c49dfb37941d","tarball":"https://registry.npmjs.org/@bluevs/vhcli-tiktok-ads/-/vhcli-tiktok-ads-0.0.16.tgz","fileCount":6,"integrity":"sha512-hKsZuVcsviL0KVLfloeRz7Wu0j26WT/SuEDlCy4hygb0wCnIboWnpMm9XRPTGuUujGMPjvz/osHg//0KHDrF8A==","signatures":[{"sig":"MEQCIGUoQhHmCtFXKTO4L9bI8WKxdgh9u+QzSAsf+dxZdzDqAiAynFt3ul6WzZykZa3vL4GuzV5eY4D2ZsHiMf/Eo2nDXw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":66826},"engines":{"node":">=16"},"gitHead":"b9c98ceea752944466f77800078fa56ba0fe03b7","scripts":{"postinstall":"bash $(npm root -g)/@bluevs/vhcli-tiktok-ads/skills/ttcli/scripts/install-skill.sh 2>&1 || echo '⚠️  skill auto-sync skipped (likely permission/container env). Run manually: bash $(npm root -g)/@bluevs/vhcli-tiktok-ads/skills/ttcli/scripts/install-skill.sh'"},"_npmUser":{"name":"ningxin","email":"n-xin@foxmail.com"},"repository":{"url":"","type":"git"},"_npmVersion":"10.9.8","description":"TikTok CLI - designed for AI Agent and developers","directories":{},"_nodeVersion":"22.23.1","_hasShrinkwrap":false,"optionalDependencies":{"@bluevs/vhcli-tiktok-ads-linux-x64":"0.0.16","@bluevs/vhcli-tiktok-ads-win32-x64":"0.0.16","@bluevs/vhcli-tiktok-ads-darwin-x64":"0.0.16","@bluevs/vhcli-tiktok-ads-linux-arm64":"0.0.16","@bluevs/vhcli-tiktok-ads-win32-arm64":"0.0.16","@bluevs/vhcli-tiktok-ads-darwin-arm64":"0.0.16"},"_npmOperationalInternal":{"tmp":"tmp/vhcli-tiktok-ads_0.0.16_1784104326047_0.009304026529852072","host":"s3://npm-registry-packages-npm-production"}},"0.0.17":{"name":"@bluevs/vhcli-tiktok-ads","version":"0.0.17","description":"TikTok CLI - designed for AI Agent and developers","bin":{"ttcli":"scripts/run.js"},"scripts":{"postinstall":"bash $(npm root -g)/@bluevs/vhcli-tiktok-ads/skills/ttcli/scripts/install-skill.sh 2>&1 || echo '⚠️  skill auto-sync skipped (likely permission/container env). Run manually: bash $(npm root -g)/@bluevs/vhcli-tiktok-ads/skills/ttcli/scripts/install-skill.sh'"},"optionalDependencies":{"@bluevs/vhcli-tiktok-ads-darwin-arm64":"0.0.17","@bluevs/vhcli-tiktok-ads-darwin-x64":"0.0.17","@bluevs/vhcli-tiktok-ads-linux-arm64":"0.0.17","@bluevs/vhcli-tiktok-ads-linux-x64":"0.0.17","@bluevs/vhcli-tiktok-ads-win32-arm64":"0.0.17","@bluevs/vhcli-tiktok-ads-win32-x64":"0.0.17"},"engines":{"node":">=16"},"repository":{"type":"git","url":""},"license":"MIT","_id":"@bluevs/vhcli-tiktok-ads@0.0.17","gitHead":"b9c98ceea752944466f77800078fa56ba0fe03b7","_nodeVersion":"22.23.1","_npmVersion":"10.9.8","dist":{"integrity":"sha512-funzMZz1tDarEYcVd5SO3Q33Z3Ig47CKNDlNxvAMg8dt0dd3r3igMhxN4Y0Dt+SALaFLp7NmfDNJkj0I5KRCPA==","shasum":"43a9fa83bf03223d5af49254569120f6c874b6cc","tarball":"https://registry.npmjs.org/@bluevs/vhcli-tiktok-ads/-/vhcli-tiktok-ads-0.0.17.tgz","fileCount":5,"unpackedSize":66844,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDJW+feSJ3NNbFg/54Hh1kydCLV5lVai31uk7fTs1VyDQIgG+MscCMqtW7YdjkmbHeE5eCaaqpP/MBB9vYyMMYeoSk="}]},"_npmUser":{"name":"ningxin","email":"n-xin@foxmail.com"},"directories":{},"maintainers":[{"name":"yuqi.li","email":"yuqi.li1@bluefocus.com"},{"name":"yangyanghou","email":"houyangyang868@gmail.com"},{"name":"ningxin","email":"n-xin@foxmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/vhcli-tiktok-ads_0.0.17_1784105113434_0.6213503741526043"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-15T08:09:52.345Z","modified":"2026-07-15T08:45:13.792Z","0.0.14":"2026-07-15T08:09:52.629Z","0.0.15":"2026-07-15T08:22:34.192Z","0.0.16":"2026-07-15T08:32:06.225Z","0.0.17":"2026-07-15T08:45:13.579Z"},"license":"MIT","repository":{"type":"git","url":""},"description":"TikTok CLI - designed for AI Agent and developers","maintainers":[{"name":"yuqi.li","email":"yuqi.li1@bluefocus.com"},{"name":"yangyanghou","email":"houyangyang868@gmail.com"},{"name":"ningxin","email":"n-xin@foxmail.com"}],"readme":"# @bluevs/vhcli-tiktok-ads\n\n[English](#english) | [中文](#中文)\n\n---\n\n## English\n\nTikTok Marketing API CLI — designed for AI agents and developers.\n\n### Installation\n\n```bash\nnpm install -g @bluevs/vhcli-tiktok-ads\n```\n\n### Authentication\n\nTokens are issued by **vhcli** (Vision Hub CLI). You do not need to handle access tokens directly.\n\n```bash\n# Fetch a token via vhcli and pass it to ttcli\nTOKEN=$(vhcli project account-token \\\n  --customer-project-id=<PROJECT_ID> \\\n  --account-id=<ADVERTISER_ID> \\\n  --format=json | jq -r .access_token)\n\nttcli --token=\"$TOKEN\" --advertiser-id=<ADVERTISER_ID> auth show\n```\n\nOr persist credentials for repeated use:\n\n```bash\nttcli auth set --token=\"$TOKEN\" --advertiser-id=<ADVERTISER_ID>\n```\n\n> **Mainland China users**: TikTok's API requires a proxy. Set `HTTPS_PROXY=http://127.0.0.1:7897` (or your local proxy port) before running any command.\n\n### Usage\n\n```\nttcli [command] [flags]\n\nFlags:\n  --advertiser-id string   Advertiser ID (overrides env / config)\n  --token string           Access token (overrides env / config)\n  --human                  Human-readable output (default is JSON)\n```\n\nOutput is JSON by default, suitable for piping and AI agent use. Pass `--human` for readable text.\n\n### Commands\n\n| Command | Description |\n|---|---|\n| `advertiser` | Account balance, transactions, budget |\n| `bc` | Business Center: accounts, balance, payment portfolio |\n| `campaign-label` | Campaign labels / tags |\n| `creative` | Creative assets for DM Ads |\n| `file` | Ad file library (video, image upload) |\n| `identity` | Ad-publishing identities (Spark Ads) |\n| `minis` | TikTok Minis (small games / short dramas) |\n| `optimizer` | Automated rules |\n| `report` | Async reporting tasks |\n| `smart-plus` | Smart+ campaigns |\n| `targeting` | Interest / behavior / hashtag taxonomy |\n| `tool` | Utilities: geo, bid, device, timezone, url-validate, … |\n| `tt-video` | TikTok video posts authorized for Spark Ads |\n| `user` | Marketing API user info |\n| `auth` | Manage credentials |\n| `schema` | Dump full command tree (JSON) |\n\n```bash\n# Explore all commands\nttcli --help\nttcli <command> --help\n\n# Dump full command tree for AI agents\nttcli schema | jq '.subcommands[] | {path, short}'\n```\n\n---\n\n## 中文\n\nTikTok 营销 API 命令行工具，专为 AI Agent 和开发者设计。\n\n### 安装\n\n```bash\nnpm install -g @bluevs/vhcli-tiktok-ads\n```\n\n### 鉴权\n\nToken 由 **vhcli**（Vision Hub CLI）发证，无需手动处理 access_token。\n\n```bash\n# 通过 vhcli 获取 token 并传给 ttcli\nTOKEN=$(vhcli project account-token \\\n  --customer-project-id=<项目ID> \\\n  --account-id=<广告主ID> \\\n  --format=json | jq -r .access_token)\n\nttcli --token=\"$TOKEN\" --advertiser-id=<广告主ID> auth show\n```\n\n或持久化凭据，后续无需每次传入：\n\n```bash\nttcli auth set --token=\"$TOKEN\" --advertiser-id=<广告主ID>\n```\n\n> **国内用户**：访问 TikTok API 需要代理。运行命令前设置 `HTTPS_PROXY=http://127.0.0.1:7897`（或本机代理端口）。\n\n### 使用方式\n\n```\nttcli [命令] [参数]\n\n全局参数：\n  --advertiser-id string   广告主 ID（覆盖环境变量 / 配置文件）\n  --token string           访问令牌（覆盖环境变量 / 配置文件）\n  --human                  人类可读输出（默认为 JSON）\n```\n\n默认输出 JSON，适合管道传递和 AI Agent 调用。加 `--human` 切换为易读文本。\n\n### 命令列表\n\n| 命令 | 说明 |\n|---|---|\n| `advertiser` | 账户余额、流水、预算 |\n| `bc` | Business Center：账户、余额、支付组合 |\n| `campaign-label` | 广告系列标签 |\n| `creative` | DM 广告创意素材 |\n| `file` | 广告素材库（视频、图片上传） |\n| `identity` | 广告发布身份（Spark Ads） |\n| `minis` | TikTok 小游戏 / 短剧 |\n| `optimizer` | 自动化规则 |\n| `report` | 异步报表任务 |\n| `smart-plus` | Smart+ 广告系列 |\n| `targeting` | 兴趣/行为/话题标签分类 |\n| `tool` | 工具集：地域、出价、设备、时区、URL 检测等 |\n| `tt-video` | 授权用于 Spark Ads 的 TikTok 视频 |\n| `user` | 营销 API 用户信息 |\n| `auth` | 管理凭据 |\n| `schema` | 输出完整命令树（JSON） |\n\n```bash\n# 查看所有命令\nttcli --help\nttcli <命令> --help\n\n# 输出完整命令树（供 AI Agent 使用）\nttcli schema | jq '.subcommands[] | {path, short}'\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}