A read-only CLI skill for AI agents to interface with the TikTok Marketing API for data analysis and reporting.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install tiktok-ads-cli
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install tiktok-ads-cli using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is TikTok Ads CLI?
The TikTok Ads CLI skill provides AI agents with a direct, read-only interface to the TikTok Marketing API (v1.3). It allows developers and marketers to query advertiser accounts, retrieve synchronous and asynchronous performance reports, and inspect essential assets like creatives and pixels. By leveraging this tool within the Openclaw Skills ecosystem, users can automate the collection of marketing intelligence and perform deep-dive analysis on campaign efficacy without manual dashboard intervention.
TikTok Ads CLI Use Cases
- Tracking TikTok ad spend and performance metrics across multiple campaigns.
- Auditing ad creatives and assets, including images and video metadata.
- Extracting demographic insights through detailed audience reports.
- Managing and listing custom or lookalike audiences for targeting verification.
- Monitoring TikTok Pixel tracking health and conversion attribution.
How TikTok Ads CLI Works
- The AI agent initiates authentication using an OAuth access token stored in environment variables or a local configuration file.
- Commands are issued via the CLI using a specific Advertiser ID to scope the requests.
- The skill queries the TikTok Marketing API to fetch data ranging from campaign hierarchies to specific creative details.
- For performance metrics, the skill executes reports based on defined dimensions (e.g., ad_id, stat_time_day) and metrics (e.g., spend, conversions).
- Results are returned as structured JSON, allowing the agent to parse, summarize, or cross-reference the data with other Openclaw Skills.
TikTok Ads CLI Setup
To install the CLI, run the following command in your terminal:
npm install -g tiktok-ads-cli
Authentication requires a TikTok OAuth access token. You can configure this by setting the TIKTOK_ADS_ACCESS_TOKEN environment variable or by creating a credentials file at ~/.config/tiktok-ads-cli/credentials.json with the following structure:
{
"access_token": "YOUR_ACCESS_TOKEN"
}
TikTok Ads CLI Data Schema & Taxonomy
The skill interacts with the TikTok entity hierarchy and returns structured JSON responses. Performance metrics use major currency units (e.g., "12.34" for $12.34).
| Level | Description |
|---|---|
| Advertiser | The root account containing all campaigns and assets. |
| Campaign | The high-level objective and budget container. |
| Ad Group | Contains targeting, placement, and bidding settings. |
| Ad | The individual unit containing creative assets and tracking codes. |
| Audience | Custom and lookalike segments used for targeting. |
TikTok Ads CLI Advanced Features
- Support for asynchronous reports to handle large datasets and extended date ranges without timeouts.
- Granular filtering using JSON-formatted strings to isolate specific campaign or ad group data.
- Comprehensive audience analysis dimensions including gender, age, and country code.
- Multi-account querying capability using comma-separated advertiser IDs.
- Direct access to TikTok Pixel details for verifying conversion tracking implementations.
SKILL.md
Loading
Related Openclaw Skills
GREEN-API WhatsApp Skill
A comprehensive automation toolkit for sending WhatsApp messages, managing groups, and controlling instances via the GREEN-API gateway.
PizzINT Monitor
A specialized OSINT tool that monitors the Pentagon Pizza Index (PizzINT) to generate automated geopolitical threat reports.
Five Star Skill
A satirical AI agent skill that enforces relaxation and mediocrity by refusing to perform tasks.
Z1 Matrix Memory Palace
A file-driven memory operating system for multi-agent environments that combines spatial organization with continuous reflection layers to reduce context drift.
Pricing Strategy Advisor
A strategic business advisory skill designed to help developers set and optimize product pricing using minimalist entrepreneurship principles.
OmniSync
A high-performance synchronization engine designed to slash LLM token consumption by up to 90% through efficient delta tracking.
Featured*
