Ira Bodnar··Updated ·12 min read

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.

Ryze AI · Paid Ads

Pinterest Ads skills on live data

  • 7-day free trial, $89 a month

Used by 2,000+ marketers

Uber Eats logoadidas logoDuolingo logoMGM Resorts logoWharton logoLendingClub logoNorton logoEventbrite logoHuel logoTogether AI logoghd logoHack The Box logo

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.

  1. 01Weekly Pinterest digestWeek-over-week account recap

    Main Pinterest columns: SPEND_IN_DOLLAR, PAID_IMPRESSION, CTR, TOTAL_CHECKOUT

    Cadence: Weekly

  2. 02Campaign efficiencyWhich campaigns earn their spend

    Main Pinterest columns: CAMPAIGN_NAME, ECPC_IN_DOLLAR, CHECKOUT_ROAS

    Cadence: Weekly

  3. 03Budget and bid reviewAd groups against their budget

    Main Pinterest columns: AD_GROUP_BUDGET_TYPE, AD_GROUP_BUDGET_IN_LOCAL_CURRENCY

    Cadence: Monthly

  4. 04Creative fatiguePins that wear out

    Main Pinterest columns: AD_ID, PIN_ID, CTR, TOTAL_IMPRESSION_FREQUENCY

    Cadence: Weekly

  5. 05Conversion funnelPage visit to checkout drop-off

    Main Pinterest columns: TOTAL_PAGE_VISIT, TOTAL_CLICK_ADD_TO_CART, TOTAL_CHECKOUT

    Cadence: Monthly

  6. 06Video ad reviewView depth and cost per view

    Main Pinterest columns: ECPV_IN_DOLLAR, TOTAL_VIDEO_P25_COMBINED, TOTAL_VIDEO_P95_COMBINED

    Cadence: Monthly

  7. 07Attribution window checkHow windows change conversions

    Main Pinterest columns: TOTAL_CHECKOUT, TOTAL_CLICK_CHECKOUT, TOTAL_VIEW_CHECKOUT

    Cadence: Quarterly

  8. 08Account auditStatus, objectives and spend caps

    Main Pinterest columns: CAMPAIGN_ENTITY_STATUS, CAMPAIGN_OBJECTIVE_TYPE, CAMPAIGN_DAILY_SPEND_CAP

    Cadence: Quarterly

  9. 09Pause underperformersPause campaigns you approve

    Main Pinterest columns: SPEND_IN_DOLLAR, TOTAL_CHECKOUT, CAMPAIGN_ENTITY_STATUS

    Cadence: 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.

  1. 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
  2. Setup

    One-off prompt
    None
    Skill
    Save once per Claude app
    Pinterest connection
    One Pinterest sign-in
  3. Same report each run

    One-off prompt
    No
    Skill
    Yes
    Pinterest connection
    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.

SKILL.md
--- name: pinterest-weekly-digest description: Weekly Pinterest Ads recap, last 7 days against the 7 days before. Use for weekly spend, click or checkout summaries. --- # Pinterest weekly digest Use the Pinterest Ads read tool for ad account analytics: - date ranges: last 7 complete days, then the 7 days before - granularity: TOTAL for each range - columns: SPEND_IN_DOLLAR, PAID_IMPRESSION, CTR, ECPC_IN_DOLLAR, TOTAL_CLICKTHROUGH, TOTAL_CHECKOUT, CHECKOUT_ROAS Steps: 1. Compute the percent change per column. 2. Name the 2 columns that moved most and say whether spend or efficiency drove it. Output: 5 short sentences, then a table with this week, last week and the change. Use returned numbers only.

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.

SKILL.md
--- name: pinterest-campaign-efficiency description: Ranks Pinterest Ads campaigns by cost per click and checkout ROAS. Use when asked which campaigns to scale or cut. --- # Pinterest campaign efficiency 1. List the campaigns in the ad account (the campaign IDs are needed for analytics, 250 at most per request). 2. Pull campaign analytics for the last 28 days, granularity TOTAL, columns: CAMPAIGN_ID, CAMPAIGN_NAME, CAMPAIGN_OBJECTIVE_TYPE, SPEND_IN_DOLLAR, CTR, ECPC_IN_DOLLAR, TOTAL_CHECKOUT, CHECKOUT_ROAS Steps: 1. Flag campaigns above the median spend with TOTAL_CHECKOUT of 0 or CHECKOUT_ROAS below the account average. 2. Group the flags by CAMPAIGN_OBJECTIVE_TYPE so awareness and conversion campaigns are not judged on the same column. Output: a table sorted by spend, flagged rows first, one line per flag.

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.

SKILL.md
--- name: pinterest-budget-review description: Compares Pinterest Ads ad group budgets with spend. Use when asked whether budgets fit. --- # Pinterest budget and bid review Pull ad group analytics for the last 14 days, granularity TOTAL, columns: AD_GROUP_NAME, AD_GROUP_ENTITY_STATUS, AD_GROUP_BUDGET_TYPE, AD_GROUP_BUDGET_IN_LOCAL_CURRENCY, SPEND_IN_DOLLAR, CPM_IN_DOLLAR, ECPC_IN_DOLLAR Steps: 1. Skip ad groups that are not ACTIVE. 2. Compare 14 days of spend with the budget for the budget type shown. State which type you assumed. 3. Flag ad groups that spent far below or at their budget. Output: a table of flagged ad groups with the budget, the spend and one suggested check. Do not change anything.

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.

SKILL.md
--- name: pinterest-creative-fatigue description: Finds Pinterest ads whose click-through rate fell while frequency rose. Use when results drop or before refreshing creative. --- # Pinterest creative fatigue Pull ad analytics for the last 28 days, granularity WEEK, columns: AD_ID, AD_NAME, PIN_ID, PAID_IMPRESSION, CTR, TOTAL_IMPRESSION_FREQUENCY, SPEND_IN_DOLLAR Steps: 1. Keep ads with 1,000 or more impressions in the latest week. 2. Flag ads where CTR fell week over week while TOTAL_IMPRESSION_FREQUENCY rose. Output: flagged ads by spend with CTR and frequency for each week. Suggest a refresh only for flagged ads.

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.

SKILL.md
--- name: pinterest-conversion-funnel description: Shows Pinterest Ads page visit to checkout drop-off per campaign. Use when clicks are fine but sales are low. --- # Pinterest conversion funnel Pull campaign analytics for the last 28 days, granularity TOTAL, columns: CAMPAIGN_NAME, TOTAL_CLICKTHROUGH, TOTAL_PAGE_VISIT, TOTAL_CLICK_ADD_TO_CART, TOTAL_CHECKOUT, TOTAL_CHECKOUT_VALUE_IN_MICRO_DOLLAR, SPEND_IN_DOLLAR Steps: 1. Divide the micro dollar value by 1,000,000. 2. Compute step rates: page visit per click, add to cart per page visit, checkout per add to cart. 3. Name the weakest step per campaign. If the conversion columns return no values, say the Pinterest tag or conversions setup may be missing and stop.

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.

SKILL.md
--- name: pinterest-video-review description: Reviews Pinterest video ads by view depth and cost per view. Use when judging video creative. --- # Pinterest video review Pull ad analytics for the last 28 days, granularity TOTAL, columns: AD_ID, AD_NAME, PIN_ID, VIDEO_LENGTH, TOTAL_VIDEO_3SEC_VIEWS, TOTAL_VIDEO_P25_COMBINED, TOTAL_VIDEO_P95_COMBINED, TOTAL_VIDEO_AVG_WATCHTIME_IN_SECOND, ECPV_IN_DOLLAR, SPEND_IN_DOLLAR Steps: 1. Keep ads with video columns that have values. 2. Compute the share of 3-second views that reach P25 and P95. Output: a table sorted by spend, with the weakest drop-off point per video.

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.

SKILL.md
--- name: pinterest-attribution-windows description: Compares Pinterest Ads checkouts under two attribution window settings. Use when Pinterest and the store disagree. --- # Pinterest attribution window check Pull campaign analytics for the last 28 days, granularity TOTAL, columns: CAMPAIGN_NAME, TOTAL_CHECKOUT, TOTAL_CLICK_CHECKOUT, TOTAL_VIEW_CHECKOUT, TOTAL_ENGAGEMENT_CHECKOUT Steps: 1. Ask which window settings the user wants to compare. Run the report once per setting. 2. Show how many checkouts come from clicks, engagements and views. Output: one table and 3 sentences. Say that the store's own order count is the final check.

Use it when: Pinterest reports more sales than your store.

08. Account audit

Lists every campaign with status, objective and spend caps.

SKILL.md
--- name: pinterest-account-audit description: Audits Pinterest Ads campaigns for status, objective and spend caps. Use for a quarterly cleanup list. --- # Pinterest account audit Pull campaign analytics for the last 90 days, granularity TOTAL, columns: CAMPAIGN_ID, CAMPAIGN_NAME, CAMPAIGN_ENTITY_STATUS, CAMPAIGN_OBJECTIVE_TYPE, CAMPAIGN_DAILY_SPEND_CAP, CAMPAIGN_LIFETIME_SPEND_CAP, SPEND_IN_DOLLAR Steps: 1. Flag ACTIVE campaigns with no spend. 2. Flag PAUSED campaigns that still spent in the range. 3. Flag campaigns with no spend cap set. Output: three short lists. Do not change anything.

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.

SKILL.md
--- name: pinterest-pause-underperformers description: Pauses Pinterest Ads campaigns the user confirms. Use after the campaign efficiency review. --- # Pinterest pause underperformers 1. Pull campaign analytics for the last 28 days: CAMPAIGN_ID, CAMPAIGN_NAME, CAMPAIGN_ENTITY_STATUS, SPEND_IN_DOLLAR, TOTAL_CHECKOUT, CHECKOUT_ROAS 2. List ACTIVE campaigns with spend and no checkouts. 3. Ask the user which of them to pause. Wait for the answer. 4. Use the Pinterest Ads write tool to set only those campaigns to PAUSED. Never archive and never use the delete tool. Output: the campaigns paused, by name.

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:

  1. pinterest_ads__listAccounts

    What it does
    Lists the ad accounts the connected Pinterest login can access
    Used by
    All skills
  2. 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
  3. 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
  4. pinterest_ads__delete

    What it does
    Deletes edge resources such as boards, Pins and audiences; irreversible
    Used by
    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.

Frequently asked questions

What are Claude skills for Pinterest Ads?
SKILL.md files that tell Claude which Pinterest Ads report to run, with exact columns, date ranges and how to present the result. Claude loads one when a request matches its description, so each check runs the same way every time.
Do I need a Pinterest connection to use these skills?
No. Each skill also works on a Pinterest Ads Manager export you attach, if it has the columns the skill names. A connection removes the export step.
Which Claude plan do I need?
Anthropic lists custom skill uploads on claude.ai for Pro, Max, Ultra, Team and Enterprise with code execution enabled. In Claude Code, skills are folders on your computer. Anthropic lists custom connectors on Free, Pro, Max, Ultra, Team and Enterprise, with Free limited to one.
Can Claude change my Pinterest campaigns through these skills?
Yes, through the Ryze AI write tool, which can create or update campaigns, ad groups and ads and pause or archive them. Only skill 09 writes, and it waits for your reply first. In Claude you can set write and delete tools to Needs approval.
Show 6 more questions
Does Claude ask before it changes something?
Not by default in the Ryze AI chat, which starts on Skip all approvals. Switch the chat to Approve write and delete, or in Claude set write and delete tools to Needs approval under Customize > Connectors > Ryze AI.
How far back can the skills look?
Pinterest's standard analytics reach back 90 days with a 90-day range at most. Hourly data reaches back 8 days. The skills here use 7 to 90 days.
Why do the skills use IN_DOLLAR columns?
Pinterest returns MICRO_DOLLAR columns in millionths of the account currency. IN_DOLLAR columns, such as SPEND_IN_DOLLAR, are already in whole units.
Which connector should I use for Pinterest Ads in Claude?
For running these skills on live data, use the Ryze AI connector: one URL gives Claude 4 Pinterest Ads tools with OAuth sign-in. It has no report tool, so analytics come through the read tool.
Can these skills run on a schedule?
Yes, in the Ryze AI app. A scheduled task runs the same instructions every day, week or month. Runs use Ryze AI credits. See the Ryze AI help center page on scheduled tasks.
Does it work with several Pinterest ad accounts?
Yes. Several Pinterest logins can be connected to one workspace, and Agent default accounts sets which ad accounts the agent works with first. Name an account in the prompt to reach the others.

Related guides

Ryze AI: Pinterest Ads skills

7-day free trial, then $89 a month

Start free trial