Claude for Pinterest Ads: 9 Skills + Copy-Paste Prompts
Quick answer: Save each Pinterest Ads task as a Claude skill that names the exact analytics columns to pull. Ryze AI is the best Claude connector for running these skills on live Pinterest Ads data, with one caveat: it gives Claude 4 Pinterest tools and no dedicated report tool, so every report goes through the read tool.
Below: 9 SKILL.md files, the Pinterest API v5 columns each uses, install steps and quick prompts.
Used by 2,000+ marketers
The 9 Claude skills for Pinterest Ads at a glance
Eight skills only read. Skill 09 can pause campaigns and says so before it does.
- 01Weekly Pinterest digestWeek-over-week account recap
Main Pinterest columns: SPEND_IN_DOLLAR, PAID_IMPRESSION, CTR, TOTAL_CHECKOUT
Cadence: Weekly
- 02Campaign efficiencyWhich campaigns earn their spend
Main Pinterest columns: CAMPAIGN_NAME, ECPC_IN_DOLLAR, CHECKOUT_ROAS
Cadence: Weekly
- 03Budget and bid reviewAd groups against their budget
Main Pinterest columns: AD_GROUP_BUDGET_TYPE, AD_GROUP_BUDGET_IN_LOCAL_CURRENCY
Cadence: Monthly
- 04Creative fatiguePins that wear out
Main Pinterest columns: AD_ID, PIN_ID, CTR, TOTAL_IMPRESSION_FREQUENCY
Cadence: Weekly
- 05Conversion funnelPage visit to checkout drop-off
Main Pinterest columns: TOTAL_PAGE_VISIT, TOTAL_CLICK_ADD_TO_CART, TOTAL_CHECKOUT
Cadence: Monthly
- 06Video ad reviewView depth and cost per view
Main Pinterest columns: ECPV_IN_DOLLAR, TOTAL_VIDEO_P25_COMBINED, TOTAL_VIDEO_P95_COMBINED
Cadence: Monthly
- 07Attribution window checkHow windows change conversions
Main Pinterest columns: TOTAL_CHECKOUT, TOTAL_CLICK_CHECKOUT, TOTAL_VIEW_CHECKOUT
Cadence: Quarterly
- 08Account auditStatus, objectives and spend caps
Main Pinterest columns: CAMPAIGN_ENTITY_STATUS, CAMPAIGN_OBJECTIVE_TYPE, CAMPAIGN_DAILY_SPEND_CAP
Cadence: Quarterly
- 09Pause underperformersPause campaigns you approve
Main Pinterest columns: SPEND_IN_DOLLAR, TOTAL_CHECKOUT, CAMPAIGN_ENTITY_STATUS
Cadence: Monthly
| # | Skill | Job | Main Pinterest columns | Cadence |
|---|---|---|---|---|
| 01 | Weekly Pinterest digest | Week-over-week account recap | SPEND_IN_DOLLAR, PAID_IMPRESSION, CTR, TOTAL_CHECKOUT | Weekly |
| 02 | Campaign efficiency | Which campaigns earn their spend | CAMPAIGN_NAME, ECPC_IN_DOLLAR, CHECKOUT_ROAS | Weekly |
| 03 | Budget and bid review | Ad groups against their budget | AD_GROUP_BUDGET_TYPE, AD_GROUP_BUDGET_IN_LOCAL_CURRENCY | Monthly |
| 04 | Creative fatigue | Pins that wear out | AD_ID, PIN_ID, CTR, TOTAL_IMPRESSION_FREQUENCY | Weekly |
| 05 | Conversion funnel | Page visit to checkout drop-off | TOTAL_PAGE_VISIT, TOTAL_CLICK_ADD_TO_CART, TOTAL_CHECKOUT | Monthly |
| 06 | Video ad review | View depth and cost per view | ECPV_IN_DOLLAR, TOTAL_VIDEO_P25_COMBINED, TOTAL_VIDEO_P95_COMBINED | Monthly |
| 07 | Attribution window check | How windows change conversions | TOTAL_CHECKOUT, TOTAL_CLICK_CHECKOUT, TOTAL_VIEW_CHECKOUT | Quarterly |
| 08 | Account audit | Status, objectives and spend caps | CAMPAIGN_ENTITY_STATUS, CAMPAIGN_OBJECTIVE_TYPE, CAMPAIGN_DAILY_SPEND_CAP | Quarterly |
| 09 | Pause underperformers | Pause campaigns you approve | SPEND_IN_DOLLAR, TOTAL_CHECKOUT, CAMPAIGN_ENTITY_STATUS | Monthly |
Column names were checked against Pinterest's published API v5 description (version 5.28.0) on November 16, 2026. No call to a Pinterest ad account was run for this page, so no result from one appears here.
What are Claude skills for Pinterest Ads?
A Claude skill for Pinterest Ads is a saved SKILL.md file that tells Claude which Pinterest report to pull and what to hand back. Per Anthropic's Agent Skills docs, the file starts with a name and a description, and Claude loads the rest only when a request matches the description.
The name allows up to 64 lowercase letters, numbers and hyphens and cannot contain the words claude or anthropic, so every skill here starts with pinterest. The description, up to 1,024 characters, says what the skill does and when to use it.
What it is
- One-off prompt
- A question in chat
- Skill
- A saved file with fixed columns and output
- Pinterest connection
- Tools Claude uses to reach Pinterest
Setup
- One-off prompt
- None
- Skill
- Save once per Claude app
- Pinterest connection
- One Pinterest sign-in
Same report each run
- One-off prompt
- No
- Skill
- Yes
- Pinterest connection
- Depends on the prompt or skill
| One-off prompt | Skill | Pinterest connection | |
|---|---|---|---|
| What it is | A question in chat | A saved file with fixed columns and output | Tools Claude uses to reach Pinterest |
| Setup | None | Save once per Claude app | One Pinterest sign-in |
| Same report each run | No | Yes | Depends on the prompt or skill |
Columns use their names from the Pinterest API v5 description. Money columns ending in MICRO_DOLLAR come back in millionths of the account currency, so the skills prefer the IN_DOLLAR columns where Pinterest offers them. Without a connection, attach a Pinterest Ads Manager export with matching columns.
How to install the skills in Claude Code and claude.ai
Claude Code
Save each block as ~/.claude/skills/<skill-name>/SKILL.md for yourself, or .claude/skills/<skill-name>/SKILL.md in a project to share it with the team. Type /pinterest-weekly-digest to run one by name (Claude Code skills docs).
claude.ai
Zip each skill folder and upload it as a custom skill. Anthropic lists this on the Pro, Max, Ultra, Team and Enterprise plans with code execution enabled.
Connect the data
The Pinterest Ads MCP page covers the Pinterest tools on the Ryze AI connector. In Claude, open Customize > Connectors, click + Add, choose Add custom connector, name it Ryze AI and enter https://connector.get-ryze.ai/mcp.
Skills uploaded to claude.ai do not reach the API, and skill folders saved in Claude Code are separate from claude.ai (Anthropic's Agent Skills docs). Anthropic advises using skills only from sources you trust, so read each block before you save it. More free skills are in the Claude skills library.
Reporting skills: the weekly and campaign view
These three answer the recurring questions and set the baseline for the creative and funnel skills. Pinterest limits standard analytics to the last 90 days and a 90-day range, so weekly and monthly skills fit inside it.
01. Weekly Pinterest digest
Compares the last 7 complete days with the 7 before at account level and names the biggest change in spend, clicks and checkouts.
Use it when: you send a Monday update.
02. Campaign efficiency
Ranks campaigns by what each click and each checkout costs and flags spend with no checkouts.
Use it when: you plan next month's budget split.
03. Budget and bid review
Reads each ad group's budget setup next to what it spent, so a budget that never gets used or runs out early shows up.
Use it when: spend feels uneven across ad groups.
Creative and funnel skills: find what wears out and where buyers drop
Run these when results slip. Each splits the change one level at a time, so the answer points to an ad, a step in the funnel or a video.
04. Creative fatigue
Compares each ad's click-through rate in its first and latest week and reads impression frequency, which points to a Pin that has been shown too often.
Use it when: results slip and you wonder if the Pins are tired.
05. Conversion funnel
Lays out page visits, add to cart clicks and checkouts side by side per campaign, so the drop-off step is visible.
Use it when: traffic arrives and sales do not.
06. Video ad review
Reads how far people watch each video Pin and what a view costs.
Use it when: you compare video Pins against image Pins.
Account skills: attribution, audit and cleanup
These three look at settings and definitions. Skills 07 and 08 only read. Skill 09 is the only one that writes.
07. Attribution window check
Pinterest's analytics calls accept click, engagement and view attribution window settings. This skill runs the same range twice and shows how much of the checkout count depends on the window.
Use it when: Pinterest reports more sales than your store.
08. Account audit
Lists every campaign with status, objective and spend caps.
Use it when: you inherit an account or run a quarterly review.
09. Pause underperformers
Builds the list of campaigns to pause, shows it, and calls the write tool only after you reply with the names to pause.
Use it when: you review spend monthly and want to act on it in the same chat.
Pausing is a write. Ryze AI chat starts on Skip all approvals, so the skill asks first in its own steps. In Claude, you can also set write and delete tools to Needs approval under Customize > Connectors > Ryze AI.
Quick prompts for one-off Pinterest Ads questions
Not every question needs a skill. These work as plain prompts once the connection is live.
- List my Pinterest ad accounts and tell me which ones you can read.
- Show spend, clicks and checkouts by day for the last 14 days for my first Pinterest ad account.
- Which Pinterest campaigns are paused, and which of them spent in the last 30 days?
- Compare click-through rate across my active Pinterest ads this week and last week.
- Show the Pinterest ad groups in campaign X with their budgets.
If an answer looks off, ask Claude to show the request it sent to Pinterest and the columns it asked for.
How to run the skills on live Pinterest Ads data
A skill only describes the report. Claude needs a connection to run it. The Ryze AI connector gives Claude 4 Pinterest Ads tools, and the Pinterest Ads MCP page covers them in full:
pinterest_ads__listAccounts
- What it does
- Lists the ad accounts the connected Pinterest login can access
- Used by
- All skills
pinterest_ads__read
- What it does
- Reads any Pinterest API v5 resource, including campaigns, ad groups, ads and ad account analytics
- Used by
- Skills 01 to 09
pinterest_ads__write
- What it does
- Creates or updates campaigns, ad groups and ads, including pausing and archiving, and can create Pins and boards
- Used by
- Skill 09
pinterest_ads__delete
- What it does
- Deletes edge resources such as boards, Pins and audiences; irreversible
- Used by
- None
| Tool | What it does | Used by |
|---|---|---|
| pinterest_ads__listAccounts | Lists the ad accounts the connected Pinterest login can access | All skills |
| pinterest_ads__read | Reads any Pinterest API v5 resource, including campaigns, ad groups, ads and ad account analytics | Skills 01 to 09 |
| pinterest_ads__write | Creates or updates campaigns, ad groups and ads, including pausing and archiving, and can create Pins and boards | Skill 09 |
| pinterest_ads__delete | Deletes edge resources such as boards, Pins and audiences; irreversible | None |
Connecting uses Pinterest OAuth: you sign in with the Pinterest login that has access to your ad accounts and approve every permission. There are no keys to copy and no ad account to pick, because Ryze AI sees every ad account that login can reach. The skills name the ad account in the prompt when you have several; the Ryze AI Pinterest guide covers Agent default accounts.
There is no dedicated report tool, so analytics come through the read tool. Pinterest Ads works in the Ryze AI chat and the connector only. It is not part of Managed Campaigns or the Ads Performance dashboard, per the Ryze AI help center. Campaigns, ad groups and ads are archived, not deleted.
Plan: Ryze AI Paid Ads is $89 a month with a 7-day free trial, and connecting the connector is free. See the pricing page. For the same approach on other ad platforms, see Claude skills for Thrad and how to connect Claude to LinkedIn Ads.
Troubleshooting: when a Pinterest skill returns a wrong answer
Claude has no Pinterest tools
Claude keeps the tool list from when you added the connector. Remove it under Customize > Connectors, add it again and start a new chat (Ryze AI connector FAQ).
Wrong ad account
Ryze AI sees every ad account the Pinterest login can reach. Name the ad account in the prompt, or set Agent default accounts in Ryze AI.
Date range rejected
Pinterest standard analytics reach back 90 days at most, and a request spans at most 90 days. Hourly data reaches back 8 days, and campaign hourly requests span at most 3 days.
Money looks a million times too large
Columns ending in MICRO_DOLLAR are in millionths of the account currency. Divide by 1,000,000 or use the IN_DOLLAR column.
A column returns nothing
Pinterest says a column with no value may not be returned. For conversion columns, check that conversions tracking is set up in Pinterest.
Cannot create Pins or boards
A connection made before the pins and boards permissions were requested needs reconnecting in Ryze AI.
Sources
The verdict
Turn each recurring Pinterest Ads question into a skill with fixed columns. Start with the weekly digest and campaign efficiency, add creative fatigue when results slip, and keep one-off questions as prompts.
Ryze AI runs these skills in Claude on live Pinterest Ads data. It has no dedicated report tool, so every report is a read call, and pausing or any other change is a write you can set to need approval.





