hyperfx-ai/marketing-skills

meta-ads

Plan and create Meta (Facebook + Instagram) advertising campaigns end-to-end via the Hyper MCP, defaulting to Advantage+ automation.

Vedi sorgente

Come usare

  1. Copia il comando e controlla il pacchetto prima di installarlo nel tuo ambiente agente.
  2. Controlla strumenti, credenziali e ambienti richiesti nel documento originale.
  3. Descrivi input e risultato desiderato; confronta l’output con le fonti.
npx skills add https://github.com/hyperfx-ai/marketing-skills --skill meta-ads

Prima di iniziare

  • L’installazione non include abbonamenti, quote API o accesso ai file.
  • Stelle e installazioni indicano attività, non un test indipendente di qualità o sicurezza.
Documento Skill originale

Contenuto dal repository con titoli, esempi, codice, tabelle, link e immagini preservati.

Meta Ads

Strategic guide for creating and managing Meta advertising campaigns, analyzing performance, and building dashboards from cached data. Default to Advantage+ unless the user explicitly requests manual control.

Out of scope — defer to other skills

RequestSend them to
Competitor or public ad research (Meta Ads Library)meta-ads-library
Ad creative generation (images, copy variants)ad-creative-generation
Google Ads campaignsgoogle-ads
Pinterest / TikTok / Amazon paid campaignspinterest-ads, tiktok-ads, amazon-ads

Requirements

  • Hyper MCP installed and connected. https://app.hyperfx.ai/mcp
  • Meta Business integration connected (Facebook + Instagram, with at least one ad account and one Page) at https://app.hyperfx.ai/apps.
  • Firecrawl integration connected for site research and screenshot grounding (discovery phase).

If meta_ads_adaccount_list is not in the tool list, stop and tell the user to enable Hyper MCP and connect Meta Business.

If you suspect a connection issue (missing ad accounts, page publishing failures, or permission errors), call meta_ads_health_check() and report the diagnostics before proceeding.

Tool names

Use the exact tool name from your connected tool list. Canonical names are meta_ads_* (listed below). On Hyper platform chat, legacy meta_business_* names (e.g. meta_business_list_ad_accounts) and the retired plural names (e.g. meta_ads_campaigns_create) resolve to the same tools via aliases — if a call fails with "tool not found", search the live catalog for the canonical name.

GroupTools
Discoverymeta_ads_adaccount_list, meta_ads_owned_pages_list, meta_ads_pages_search, meta_accounts_list, meta_ads_instagram_accounts_list
Health & syncmeta_ads_health_check, meta_ads_health_get
Tracking assetsmeta_ads_ad_pixels_list, meta_ads_ad_pixels_get, meta_ads_custom_audiences_list, meta_ads_lookalike_audiences_list, meta_ads_targeting_search
Step-by-step creation (preferred)meta_ads_campaign_create, meta_ads_adset_create, meta_ads_ad_create, meta_ads_ad_images_upload, meta_ads_creative_create
Read & previewmeta_ads_campaign_get, meta_ads_campaigns_search, meta_ads_adset_list, meta_ads_ad_list, meta_ads_ad_get, meta_ads_ad_previews_get
Insights & dashboardsmeta_ads_insights_get, hyper_data_build_dashboard, database_query
Launch & editsmeta_ads_campaigns_activate, meta_ads_campaign_update, meta_ads_adset_update, meta_ads_ad_update
Automated rulesmeta_ads_adrule_create, meta_ads_adrule_list, meta_ads_adrule_get, meta_ads_adrule_update, meta_ads_adrule_delete, meta_ads_adrule_history_list
Site researchfirecrawl_branding_extract, firecrawl_screenshots_create

CLI users: translate tool names with the hyper-cli skill (hyperai search "<tool name>").


Rules that must never be forgotten

BUDGETS IN CENTS: $20.00 = 2000. $5.50 = 550. $100 = 10000. Never pass dollar amounts directly.
ACTIVATE, DON'T UPDATE: Use meta_ads_campaigns_activate(campaign_id) to go live. Never meta_ads_campaign_update(status="ACTIVE") — that silently leaves ad sets and ads PAUSED so nothing serves.
ALWAYS START PAUSED: Create campaigns with status="PAUSED". Never launch live without user review.
BUILD STEP BY STEP: Create campaigns with the individual tools — meta_ads_campaign_create → meta_ads_adset_create → meta_ads_creative_create → meta_ads_ad_create, capturing each id from the previous response. (The old blueprint tools were removed.) The tools validate requests before sending — campaign objective rules, bid-strategy/bid-amount pairing, billing-event/optimization-goal compatibility, budget coherence — but objective-specific ad-set fields (optimization_goal, promoted_object) are YOUR responsibility: match them to the campaign objective using the reference file for the campaign type.
REGULATED ADVERTISERS NEED `special_ad_categories`: For gambling, financial, housing, employment, credit, or political advertisers, declare the category on meta_ads_campaign_create (e.g. special_ad_categories=["ONLINE_GAMBLING_AND_GAMING"]).
FIXED RUN WINDOWS GO ON THE AD SET: When the user gives a run duration or dates ("run it for 7 days", "through end of month"), set start_time AND end_time (ISO 8601) on meta_ads_ad_sets_create. A daily-budget ad set with no end_time runs continuously until manually paused — the requested window is silently lost.
GROUND COPY IN THE DESTINATION PAGE (RESEARCH FIRST): When the brief centers on a URL ("build a campaign for https://..."), fetch that page FIRST (web_pages_fetch) — before discovery and before writing any copy — and ground ad copy in what the page actually says (product name, value props, offer). Never invent copy for a page you have not read; even when the user supplies exact copy or headlines, fetch the page to verify the destination matches the offer.
EU-TARGETED AD SETS NEED DSA FIELDS: If an ad set targets the EU, set dsa_beneficiary and dsa_payor on meta_ads_ad_sets_create (who benefits from / pays for the ad) — required under the EU Digital Services Act, or delivery is restricted.
UTMs ON EVERY DESTINATION AD (`url_tags`): Set url_tags (UTM params, e.g. utm_source=meta&utm_medium=paid&utm_campaign=...) on every creative that drives to a destination — downstream measurement (e.g. AppsFlyer + a data warehouse) stitches on these, so an ad without UTMs is effectively unmeasurable. Use the advertiser's canonical template; if you don't have one, ask rather than ship untracked.

See references/constraints.md for the full constraint set.

All reference files live in `references/`. Read them at references/<file> (e.g. references/discovery.md). They are not in the same directory as this SKILL.md.

Core process

Every task follows this sequence. Do not skip steps.

  1. Identify the goal — creation, analysis, or both?
  2. Check the routing table and read the referenced files before calling any tools
  3. Make a written plan — state campaign type, budget in cents, optimization goal, and sequence of steps; show it before acting
  4. Execute step by step, re-checking references/constraints.md at each creation step
  5. Show ad previews before activation
  6. Activate only when the user approves using meta_ads_campaigns_activate()

Automated / scheduled runs: If there is no user present to interact with (e.g. a scheduled task), skip steps 3 and 6. Do not write a plan and wait for confirmation — proceed directly. Do not activate unless activation was explicitly included in the task instructions.


Routing table

The user wants to…Read these files first
Create a sales / conversion campaignreferences/discovery.md → references/campaigns/sales.md
Create a leads campaignreferences/discovery.md → references/campaigns/leads.md
Create a traffic campaignreferences/discovery.md → references/campaigns/traffic.md
Create an awareness or engagement campaignreferences/discovery.md → references/campaigns/awareness-engagement.md
Create an app promotion campaignreferences/discovery.md → references/campaigns/app-promotion.md
Create a campaign (any objective)references/discovery.md → the matching references/campaigns/*.md above, then build step by step
Analyze performance / query insightsreferences/analytics.md
Audit an account / find optimization opportunitiesreferences/account-audit.md
Set up automated rules (auto-pause, budget guards, alerts)references/automated-rules.md
Build a Meta dashboard or data appreferences/analytics.md → references/dashboards.md
Analyze performance, then create a campaignreferences/analytics.md → references/discovery.md → relevant campaign file
Build a funnel / multiple campaigns at once (TOF/MOF/BOF)references/multi-campaign-funnel.md → references/discovery.md → per-tier campaign files
Objective not yet knownreferences/discovery.md — discovery clarifies the goal

Worked examples

Correlati per attività

dallo stesso repository

Altri Skills

Tutti gli Skills
hyperfx-ai
Community

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.

Installazioni / 1h
1
GitHub Stars
116
Aggiornato
21 nov
hyperfx-ai
Community

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.

Installazioni / 1h
1
GitHub Stars
91
Aggiornato
26 set
hyperfx-ai
Community

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.

Installazioni / 1h
1
GitHub Stars
91
Aggiornato
26 set
hyperfx-ai
Community

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.

Installazioni / 1h
1
GitHub Stars
83
Aggiornato
25 ago