hyperfx-ai/marketing-skills

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, convers…

Zobacz źródło

Jak używać

  1. Skopiuj polecenie instalacji i sprawdź źródła przed instalacją we własnym środowisku agenta.
  2. W oryginale sprawdź wymagane narzędzia, dane dostępowe i obsługiwane środowiska.
  3. Opisz dane wejściowe i oczekiwany rezultat; porównaj wynik ze źródłami.
npx skills add https://github.com/hyperfx-ai/marketing-skills --skill pinterest-ads

Przed rozpoczęciem

  • Instalacja nie obejmuje subskrypcji modelu, limitu API ani uprawnień do plików.
  • Gwiazdki i instalacje pokazują aktywność, a nie niezależny test jakości lub bezpieczeństwa.
Oryginalny dokument Skill

Treść z repozytorium z zachowaniem nagłówków, przykładów, kodu, tabel, linków i obrazów.

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

RequestSend them to
Google Ads campaigngoogle-ads
Meta (Facebook / Instagram) ad campaignmeta-ads
Amazon Sponsored Productsamazon-ads
TikTok ad campaigntiktok-ads
Competitor ad research from the Meta Ads Librarymeta-ads-library
Organic Pinterest pinningnot currently shipped — use the Pinterest app

Requirements

If pinterest_ads_list_ad_accounts is not in the tool list, stop and tell the user to enable the Hyper MCP and connect Pinterest Ads.

Tool surface

Tool groupTools
Accountspinterest_ads_list_ad_accounts, pinterest_ads_get_ad_account
Campaignspinterest_ads_list_campaigns, pinterest_ads_get_campaign, pinterest_ads_create_campaign, pinterest_ads_update_campaign
Ad groupspinterest_ads_list_ad_groups, pinterest_ads_get_ad_group, pinterest_ads_create_ad_group, pinterest_ads_update_ad_group
Adspinterest_ads_list_ads, pinterest_ads_get_ad, pinterest_ads_create_ad, pinterest_ads_update_ad
Audiencespinterest_ads_list_audiences, pinterest_ads_create_audience, pinterest_ads_create_customer_list
Conversionpinterest_ads_list_conversion_tags, pinterest_ads_create_conversion_tag, pinterest_ads_send_conversion_event
Keywordspinterest_ads_create_keyword
Analyticspinterest_ads_get_campaign_analytics

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: WEBCONVERSION ad groups MUST use `billableevent="IMPRESSION" (NOT CLICKTHROUGH) and MUST include optimizationgoalmetadata with attributionwindows`, `conversionevent, conversiontagid, and cpagoalvalueinmicro_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 campaignreferences/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 listsreferences/audiences-and-conversions.md
Set up conversion tracking / send conversion eventsreferences/audiences-and-conversions.md
Add keywords to an ad groupreferences/keywords-and-analytics.md
Pull campaign analyticsreferences/keywords-and-analytics.md
Update or pause existing campaigns / ad groups / adsreferences/keywords-and-analytics.md
Goal not yet clearreferences/discovery.md — discovery clarifies the goal

Known Limitations

IssueWorkaround
Keyword creation returns 500 without match_typeAlways specify match_type (BROAD, PHRASE, EXACT).
retention_days deprecated for ENGAGEMENT audiencesOmit from rule dict.
WEB_CONVERSION ad groups require many parametersUse the WEBCONVERSION template exactly — include full `optimizationgoal_metadata`.
WEBCONVERSION ad groups must use `IMPRESSION` `billableevent`Do NOT use CLICKTHROUGH for WEB_CONVERSION.
CBO campaigns reject ad group budgetsDo NOT set budget_in_micro_currency when parent campaign has CBO enabled.
cpa_goal_value_in_micro_currency must be a stringPass as "5000000", not 5000000.
conversion_tag_id must be a real tag from the accountList 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 WEBCONVERSION ad groups without `optimizationgoal_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).

Powiązane zadania

z tego samego repozytorium

Więcej Skills

Wszystkie Skills
hyperfx-ai
Społeczność

meta-ads-library

Research competitor Facebook and Instagram ads from the Meta Ads Library via the Hyper MCP — search by keyword, pull full ad creative and metadata, enrich with page contact info for lead generation, and surface structured ad-intelligence summaries in chat. Use when the user wants to scrape the Meta Ads Library, spy on competitor ads, monitor new ads in a category, build a lead list from advertisers, or surface creative trends across an industry.

Instalacje / 1h
1
GitHub Stars
116
Aktualizacja
21 lis
hyperfx-ai
Społeczność

blog-generation

Generate one excellent, on-brand blog post per run for any business, built to rank on Google and get cited by AI search (ChatGPT, Claude, Perplexity, AI Overviews). A stateful engine: reads a brand strategy doc, picks a fresh topic (never repeats), researches, writes in the brand's voice, and logs the post back. Use when the user wants to write a blog post, run a daily or recurring blog task, or generate SEO / AEO / blog content. For keyword data and audits, defer to seo-research.

Instalacje / 1h
1
GitHub Stars
91
Aktualizacja
26 wrz
hyperfx-ai
Społeczność

reddit-ads

Plan and create Reddit Ads campaigns end-to-end via the Hyper MCP — campaign, ad group, ad build order with subreddit / interest / geo targeting, promoted posts, custom and saved audiences, Reddit pixel conversion tracking, and reporting, with micro-currency budgets. Use when the user wants to launch Reddit ads, promote a Reddit post, target subreddits, set up a Reddit pixel, or pull Reddit ad reports. Also triggers on reddit campaign, reddit ppc, or reddit ads manager.

Instalacje / 1h
1
GitHub Stars
91
Aktualizacja
26 wrz
hyperfx-ai
Społeczność

ad-creative-generation

Generate on-brand ad creatives — visuals + copy — for Google, Meta (Facebook / Instagram), and other paid platforms via the Hyper MCP. Extracts brand identity from a website, writes ad copy variants, and produces brand-consistent images using reference-based image generation. Use when the user asks for ad creative, ad copy variants, RSA headlines, Meta ad creative, display ads, carousel ads, or A/B test variants.

Instalacje / 1h
1
GitHub Stars
83
Aktualizacja
25 sie