A comprehensive read-only command-line interface for querying the Snapchat Marketing API to analyze ad performance and account structure.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install snapchat-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 snapchat-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 Snapchat Ads CLI?
The Snapchat Ads CLI is a powerful technical tool designed to bridge the gap between complex advertising data and actionable insights. As a key component in the library of Openclaw Skills, it provides developers and data analysts with read-only access to the Snapchat Marketing API (v1). This allows for programmatic exploration of organization hierarchies, ad account details, and deep performance metrics without the overhead of a full web UI.
By utilizing this skill, users can efficiently pull stats with specific attribution windows, inspect creative assets, and monitor the health of their Snap Pixel. It is built to facilitate automated reporting and data-driven decision-making within an AI-enhanced workflow, making it an essential addition for those leveraging Openclaw Skills for marketing automation.
Snapchat Ads CLI Use Cases
- Analyzing daily or hourly performance trends for Snapchat campaigns and ad squads.
- Debugging delivery bottlenecks by checking the real-time status of ads and campaigns.
- Estimating potential audience reach and bid requirements for upcoming marketing strategies.
- Auditing account access by listing organization members, roles, and permissions.
- Retrieving detailed billing information, including invoices and transaction history for financial reporting.
How Snapchat Ads CLI Works
- Discover accessible organizations and map out the associated ad accounts.
- Navigate the advertising hierarchy from the organization level down to specific ads and creatives.
- Pull performance statistics by specifying date ranges, granularity, and attribution windows.
- Process raw monetary values by converting Snapchat micro-currency into standard currency formats.
- Evaluate delivery health and audience insights using dedicated diagnostic commands.
Snapchat Ads CLI Setup
To integrate this functionality into your environment, first install the CLI tool globally using npm:
npm install -g snapchat-ads-cli
Authentication requires a Snapchat OAuth2 access token. This can be configured via the SNAPCHAT_ADS_ACCESS_TOKEN environment variable or by creating a credentials file at ~/.config/snapchat-ads-cli/credentials.json with your token:
{
"access_token": "YOUR_ACCESS_TOKEN"
}
Verify your setup by running snapchat-ads-cli organizations to list your available organizations.
Snapchat Ads CLI Data Schema & Taxonomy
The skill interacts with data structured according to the Snapchat Marketing API hierarchy. All output is provided in JSON format, facilitating easy integration with other Openclaw Skills.
| Entity | Data Provided |
|---|---|
| Organization | ID, name, and member roles. |
| Ad Account | Billing center links, funding sources, and pixel IDs. |
| Campaign | Objectives, status, and budget (in micro-currency). |
| Ad Squad | Targeting parameters, optimization goals, and bid estimates. |
| Stats | Metrics such as spend, impressions, swipes, and conversion types. |
| Pixel | Signal readiness scores and custom conversion rules. |
Snapchat Ads CLI Advanced Features
- Support for custom conversion source types including web, app, and total conversions.
- Granular reporting with hourly data slices for high-frequency performance monitoring.
- Automated audit logs for tracking external changelogs across different entity types.
- Bid estimation engine to optimize spend based on specific goals like impressions or swipes.
- Seamless workflow integration with other Openclaw Skills for multi-channel marketing analysis.
SKILL.md
Loading
Related Openclaw Skills
Spotify Ads CLI
A read-only CLI tool for the Spotify Ads API (v3) that enables deep reporting, audience estimation, and campaign analysis.
Feishu Notifier Core
A lightweight, secure bridge for sending automated notifications to Feishu (Lark) through Openclaw Skills.
Quantum Agent Memory
A quantum-optimized memory framework that uses QAOA to solve clustering, compaction, and synergy-based recall problems for AI agents.
X Ads CLI
A read-only command-line interface for querying X Ads API v12 to analyze campaign performance and account structure.
Bid Monitor V2.0
An automated business intelligence radar that crawls, filters, and pushes construction and EPC bidding opportunities directly to enterprise communication platforms.
Reviewer Agent
An independent project auditor that provides objective quality assessments, multi-dimensional scoring, and actionable improvement plans.
Featured*
