A professional read-only CLI interface for the Pinterest REST API v5 that enables deep analysis of ad accounts, campaign performance, and market trends.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install pinterest-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 pinterest-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 Pinterest Ads CLI?
The Pinterest Ads CLI is a specialized tool integrated into Openclaw Skills that provides developers and marketers with a programmatic way to query the Pinterest REST API v5. It is designed for high-efficiency data retrieval, allowing users to inspect ad account structures, analyze audience behavior, and browse product catalogs without leaving the terminal. This skill focuses on read-only access, ensuring that performance audits and reporting can be conducted securely and reliably.
By leveraging this skill, AI agents can navigate the complex Pinterest entity hierarchy—from ad accounts down to individual keywords—to generate actionable insights. It handles the nuances of the Pinterest API, such as micro-currency conversion and cursor-based pagination, making it an essential component of the Openclaw Skills ecosystem for automated digital marketing analysis.
Pinterest Ads CLI Use Cases
- Tracking ad spend and performance metrics across multiple Pinterest ad accounts.
- Generating automated reports for campaigns, ad groups, and individual creative performance.
- Auditing conversion tracking setup and verifying the status of conversion tags.
- Researching seasonal and growing search trends by region to inform content strategy.
- Reviewing billing profiles and order lines for financial reconciliation.
How Pinterest Ads CLI Works
- Authentication is established using a Pinterest OAuth2 access token provided via environment variables or a configuration file.
- The user identifies accessible ad accounts to determine the scope of data retrieval.
- Commands are executed to drill down into specific campaigns, ad groups, or ads using filtered queries.
- Analytics data is pulled for defined date ranges, specifying precise metric columns like spend, impressions, and conversions.
- The tool processes raw API responses, including converting micro-currency values (dividing by 1,000,000) into standard currency formats for human-readable reports.
Pinterest Ads CLI Setup
To get started with this component of Openclaw Skills, first install the CLI globally:
npm install -g pinterest-ads-cli
Next, configure your Pinterest OAuth2 token. You can export it as an environment variable:
export PINTEREST_ADS_ACCESS_TOKEN='your_token_here'
Alternatively, create a configuration file at ~/.config/pinterest-ads-cli/credentials.json with your access token.
Pinterest Ads CLI Data Schema & Taxonomy
The skill returns structured JSON data reflecting the Pinterest entity hierarchy. Below is the organization of metadata and metrics:
| Data Category | Key Entities | Metrics/Metadata |
|---|---|---|
| Campaign Management | Campaigns, Ad Groups, Ads | Entity IDs, status, start/end dates, and budget types. |
| Performance | Analytics Reports | Spend (micro-dollars), impressions, clicks, and CTR. |
| Targeting | Keywords, Audiences, Customer Lists | Keyword match types, audience size, and list status. |
| Shopping | Catalogs, Feeds, Product Groups | Feed processing status and product group validation. |
| Market Insights | Trends | Growing, monthly, and seasonal search terms by region. |
Pinterest Ads CLI Advanced Features
- Micro-currency Handling: Automatic calculation logic to convert Pinterest's internal micro-dollar format into standard currency units.
- Attribution Window Customization: Support for specifying click and view attribution windows (up to 60 days) for account-level analytics.
- Granular Trend Filtering: Ability to discover search trends filtered by specific interests, genders, and age demographics across various regions.
- Cursor-based Pagination: Built-in support for the --bookmark flag to navigate large result sets in the Pinterest API.
- Multi-Agent Compatibility: Seamlessly integrates with other Openclaw Skills to enable complex marketing automation workflows.
SKILL.md
Loading
Related Openclaw Skills
Poster Forge
A universal visual content generator that leverages AI, HTML templates, and text rendering to create high-quality posters and social media assets.
QG Car Skill
A technical interface for the qg CLI that enables users to query Qiguan campus bus schedules and generate secure WeChat booking links.
Analytics Tracking Automation
A comprehensive automation skill for managing the end-to-end lifecycle of GA4 and GTM tracking implementations.
Canvas Claw
A specialized skill for generating and animating high-quality AI images and videos through a unified agent interface.
Moodle Student Sync
A comprehensive automation tool for syncing Moodle academic data into actionable summaries and study plans.
Claw Code Suite
A security-first Python harness providing 184 tools and 207 commands for offline code analysis and AI agent orchestration.
Featured*
