Pinterest Ads

Organization

hyperfx-ai

pinterest-ads

Plan and create Pinterest Ads campaigns through the Hyper MCP — Awareness, Consideration, Video View, Web Conversion, Catalog Sales, and Web Sessions objectives — with strict microcurrency budgeting, CBO rules, audience and customer-list management, conversion tag handling, keyword targeting, and campaign analytics. Use when the user mentions Pinterest ads, Pinterest campaign, Pinterest ad group, Pinterest audience, Pinterest conversion tracking, Pinterest tag, or Pinterest customer list.

Overview

Publisher	hyperfx-ai
Repository	`marketing-skills`
Skill name	`pinterest-ads`
Stars	107
Forks	21
Bundled files	4
License	MIT
Links	Skill source Repository Homepage

Markdown instructions
A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.
Works with any LLM
AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.
4 bundled files
Scripts, templates, and references the model can read while it works. Files are read-only and never executed.
Open source
Published by hyperfx-ai on GitHub. Read the source before you install it.

Installation

Install the Pinterest Ads AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

Open the app and go to Plugins → Skills.
Choose "Install from GitHub".
Paste the skill folder URL below and confirm.
https://github.com/hyperfx-ai/marketing-skills/tree/main/skills/pinterest-ads
Enable the skill in any chat where you want it available.

Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills

git clone --depth 1 https://github.com/hyperfx-ai/marketing-skills.git /tmp/marketing-skills
mkdir -p .claude/skills
cp -r /tmp/marketing-skills/skills/pinterest-ads .claude/skills/pinterest-ads

Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Pinterest Ads in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Pinterest Ads on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Pinterest Ads is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

Loaded only when it is needed
The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.
Switch models mid-chat
Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

Pinterest Ads

Strategic skill for managing Pinterest Ads campaigns via the Pinterest Ads API v5 surface exposed by the Hyper MCP. Ad-group creation goes through a direct REST call (bypassing SDK model conversion) so parameter types must be sent exactly as documented — strings as strings, integers as integers.

Out of scope — defer to other skills

Request	Send them to
Google Ads campaign	`google-ads`
Meta (Facebook / Instagram) ad campaign	`meta-ads`
Amazon Sponsored Products	`amazon-ads`
TikTok ad campaign	`tiktok-ads`
Competitor ad research from the Meta Ads Library	`meta-ads-library`
Organic Pinterest pinning	not currently shipped — use the Pinterest app

Requirements

Hyper MCP installed and connected. https://app.hyperfx.ai/mcp
Pinterest Ads integration connected at https://app.hyperfx.ai/apps (Pinterest Business account with ad account access).

If pinterest_ads_ad_accounts_list is not found, the integration to connect is Pinterest Ads.

How to run the tools in this skill

Every tool in this skill is named by its canonical tool name. Run it with the call your surface gives you:

Surface	Find a tool	Run it
Hyper chat	Call the tool by its name; `search_tools(queries=["<provider> <action>"])` shows its parameters	`<name>(...)`
MCP client (Claude, Cursor, Codex, ChatGPT)	`search("<what you want to do>")`, then `describe("<name>")`	`call_read("<name>", {...})`, `call_write` or `call_destructive`: the one that `describe` names in `call_with`
Hyper CLI	`hyperai search "<what you want to do>"`, then `hyperai describe <name>`	`hyperai call <name> --json '{...}'`

If a tool is not found: in Hyper chat, find its toolkit id with discover_toolkits and pass it to enable_toolkit. On an MCP client or the CLI, tell the user which integration to connect in Hyper.

Tool surface

Tool group	Tools
Accounts	`pinterest_ads_ad_accounts_list`, `pinterest_ads_ad_accounts_get`
Campaigns	`pinterest_ads_campaigns_list`, `pinterest_ads_campaigns_get`, `pinterest_ads_campaigns_create`, `pinterest_ads_campaigns_update`
Ad groups	`pinterest_ads_ad_groups_list`, `pinterest_ads_ad_groups_get`, `pinterest_ads_ad_groups_create`, `pinterest_ads_ad_groups_update`
Ads	`pinterest_ads_list`, `pinterest_ads_get`, `pinterest_ads_create`, `pinterest_ads_update`
Audiences	`pinterest_ads_audiences_list`, `pinterest_ads_audiences_create`, `pinterest_ads_customer_lists_create`
Conversion	`pinterest_ads_conversion_tags_list`, `pinterest_ads_conversion_tags_create`, `pinterest_ads_conversion_events_send`
Keywords	`pinterest_ads_keywords_create`
Analytics	`pinterest_ads_campaign_analytics_get`

Critical Rules

CRITICAL: All budgets and bids are in microcurrency. $1.00 = 1,000,000 microdollars. $50/day = 50,000,000. Never pass dollar amounts directly.

CRITICAL: When using is_flexible_daily_budgets: true, you MUST also set is_campaign_budget_optimization: true. FDB requires CBO.

CRITICAL: Lifetime CBO campaigns MUST include end_time (Unix timestamp).

CRITICAL: Create campaigns with status PAUSED initially. Never launch live without user review.

CRITICAL: WEB_CONVERSION ad groups MUST use billable_event="IMPRESSION" (NOT CLICKTHROUGH) and MUST include optimization_goal_metadata with attribution_windows, conversion_event, conversion_tag_id, and cpa_goal_value_in_micro_currency.

CRITICAL: Keyword creation REQUIRES match_type. Without it, the API returns 500 errors.

CRITICAL: CBO campaigns manage budget at the campaign level. Do NOT set budget_in_micro_currency on ad groups under CBO campaigns.

IMPORTANT: retention_days is deprecated for ENGAGEMENT audiences. Omit it from audience rules.

Core process

Discovery → audit account → research (objectives, audience, assets) → confirm strategy → create campaign (PAUSED) → create ad groups → create ads → review → activate only with user approval.

All reference files live in references/. Read them at references/<file> (e.g. references/discovery.md).

Routing table

The user wants to…	Read these files first
Create a campaign (any objective)	references/discovery.md → references/campaigns.md
Build a WEB_CONVERSION campaign	references/discovery.md → references/campaigns.md (use the WEB_CONVERSION template exactly) + references/audiences-and-conversions.md for the conversion tag
Create or manage audiences / customer lists	references/audiences-and-conversions.md
Set up conversion tracking / send conversion events	references/audiences-and-conversions.md
Add keywords to an ad group	references/keywords-and-analytics.md
Pull campaign analytics	references/keywords-and-analytics.md
Update or pause existing campaigns / ad groups / ads	references/keywords-and-analytics.md
Goal not yet clear	references/discovery.md — discovery clarifies the goal

Known Limitations

Issue	Workaround
Keyword creation returns 500 without `match_type`	Always specify `match_type` (`BROAD`, `PHRASE`, `EXACT`).
`retention_days` deprecated for ENGAGEMENT audiences	Omit from rule dict.
WEB_CONVERSION ad groups require many parameters	Use the WEB_CONVERSION template exactly — include full `optimization_goal_metadata`.
WEB_CONVERSION ad groups must use `IMPRESSION` `billable_event`	Do NOT use `CLICKTHROUGH` for WEB_CONVERSION.
CBO campaigns reject ad group budgets	Do NOT set `budget_in_micro_currency` when parent campaign has CBO enabled.
`cpa_goal_value_in_micro_currency` must be a string	Pass as `"5000000"`, not `5000000`.
`conversion_tag_id` must be a real tag from the account	List conversion tags first, then use an existing tag ID.

Safety Rules

Never:

Assume Pin IDs or ad account IDs — always ask or look up.
Skip the account audit phase.
Create campaigns without explicit approval.
Set campaigns to ACTIVE without user consent.
Pass dollar amounts instead of microcurrency.
Use retention_days for ENGAGEMENT audiences.
Create WEB_CONVERSION ad groups without optimization_goal_metadata.
Use CLICKTHROUGH billable_event for WEB_CONVERSION campaigns (use IMPRESSION).
Set ad group budgets on CBO campaigns.
Create keywords without specifying match_type.
Pass cpa_goal_value_in_micro_currency as an integer (must be a string like "5000000").
Omit conversion_tag_id from WEB_CONVERSION optimization metadata (list tags first, use a real ID).

Bundled files

The model reads these on demand while the skill is loaded. They are exposed as readable files and are never executed.

Frequently asked questions

What does the Pinterest Ads AI skill do?

Why use Pinterest Ads on TypingMind?

Because you install it once and use it with any model. Pinterest Ads is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Pinterest Ads in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/hyperfx-ai/marketing-skills/tree/main/skills/pinterest-ads. TypingMind reads its SKILL.md and bundles its files and installs it as a skill you can enable per chat.

Which AI models can use Pinterest Ads?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Pinterest Ads?

As many as you like. As long as a model supports skills, you can use Pinterest Ads with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Pinterest Ads AI skill free?

Yes. It is published on GitHub by hyperfx-ai under the MIT license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Deslop

openclaw

OrganizationPopular

Diff-scoped AI-slop cleanup pass: strip comment slop, defensive-check slop, type-laundering, and style drift from the current branch diff before autoreview.

Discord Clawd

Use to talk to the Discord-backed OpenClaw agent/session; not for archive search.

Discrawl

Discord archive: search, sync freshness, DMs, summaries, TUI, repo/release work.

Gitcrawl

GitHub archive: issue/PR search, sync freshness, duplicate clusters, current GitHub handoff, and Gitcrawl repo work.

Overview

Installation

Install in TypingMind

Install in another agent

Use it in TypingMind

Works with any AI model

Skill instructions

Pinterest Ads

Out of scope — defer to other skills

Requirements

How to run the tools in this skill

Tool surface

Critical Rules

Core process

Routing table

Known Limitations

Safety Rules

Bundled files

Frequently asked questions

Related AI Skills

Set up your own AI workspace now