convez.ai
MCP Server
hyperfx-ai

marketing-skills

hyperfx-ai/marketing-skills

Ver no GitHub
BomPluginScore · de 0 a 100

Marketing skills for AI agents — paid ads, social media, SEO, competitor research, creative generation, email, analytics, and more. Powered by Hyper MCP.

Instalação

$npx convez-ai hyperfx-ai/marketing-skills

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
115
Forks
21
Acompanhando
2
Saúde
50%
Último commit
há 1 semana
Versão
v1.2.7
Issues abertas
8
Contribuidores
2

README

A tradução para o português deste README ainda está na fila.

Marketing Skills for AI Agents

Agent Skills for marketing — paid ads, social media, SEO, AI search, competitor research, ad creative generation, email lifecycle, analytics, operations, and more.

These skills run on the Hyper MCP, which gives your agent 100+ direct integrations and built-in marketing tools through one endpoint — a backpack of tools that travels with your agent across Claude Code, Cursor, Codex, OpenCode, GitHub Copilot, Gemini CLI, and 50+ other agents that support the Agent Skills spec.


What is a skill?

A skill is a markdown file (SKILL.md) with the workflows, decision rules, and example tool calls your agent needs to run specific marketing functions end-to-end. The tools themselves come from the Hyper MCP. The skill teaches the agent how to think like an expert and ship correct work.


The Hyper MCP

Hyper MCP — 200+ integrations and built-in tools

Create, customize, and connect your MCP at app.hyperfx.ai/mcp. Choose which integrations and built-in tools to include, and configure approval rules action-by-action across every one of them.

What's in it:

  • 100+ direct integrations — ad platforms (Google Ads, Meta, TikTok, LinkedIn, Amazon, Pinterest), social (Instagram, Reddit, Twitter, YouTube), email (Gmail, Klaviyo, Resend, Beehiiv), analytics (GA4, Search Console, BigQuery), CRM (HubSpot, Apollo), commerce (Shopify), and more.
  • Built-in tools — Meta Ads Library scraper, Reddit and Twitter scrapers, image generation (OpenAI, Nano Banana, Seedream), video generation (Sora, Veo, Seedance), browser automation, transcription.
  • Guardrails and permissions — every action can require approval before it runs, so your agent can't delete a campaign or send a DM without your green light.
  • The Hyper platform — build and manage Hyper agents, tasks, and skills directly.

Walkthrough video.


Install

npx skills add hyperfx-ai/marketing-skills

Auto-detects your agent and drops the skills in the right directory. Then ask your agent something a skill knows about:

"Plan a Google Ads search campaign for example.com."

# install one
npx skills add hyperfx-ai/marketing-skills --skill google-ads

# install all 20
npx skills add hyperfx-ai/marketing-skills --all

Other install options below.


What it looks like

You: Run a viral paid and organic campaign for acmebakes.com. Find what's trending in our space on social, generate image and video creatives, and set up and launch ads + organic posts on Meta, Google, and TikTok. $100/day per ad platform.

Agent: Learned your brand from acmebakes.com (logo, palette, voice). Scraped 412 Instagram posts, 287 TikToks, and 54 Reddit threads to see what people in artisan baking are talking about. Three trends stand out: sourdough rescue, Dubai-chocolate copycats, school-lunch baking. Two have low keyword competition and rising search volume — targeting those.

Generated 6 image creatives + 2 short videos in your brand style. Everything's set up and paused — view each one before setting it live:

  • Meta — $100/day, Advantage+ targeting, optimized for the Purchase event on your pixel, US 25–54.
  • TikTok Ads — $100/day, Traffic objective on the same audience, video creatives.
  • Google Ads Search — $100/day, phrase + exact match on the two trending opportunities, negative keywords, sitelinks.
  • TikTok + Instagram organic — 3 posts queued (also paused), captions matched to trending sounds and hashtags.

Total ad spend: $300/day ($100 each on Meta, Google, TikTok).

Tell me when to set them live, and I'll set up a task to monitor them every hour.

That's meta-ads + google-ads + tiktok-ads + ad-creative-generation + video-generation + tiktok + instagram composing into one job. Skills can compose like this because they all run against the same MCP — the agent picks the right one per step.


Skills

SkillWhat it doesRequired integrations
Paid ads
google-adsPlan and launch Google Ads campaigns — Search, Display, and Performance Max.Google Ads
meta-adsPlan and launch Meta ad campaigns across Facebook and Instagram.Meta Business, Firecrawl
meta-ads-libraryResearch competitor ads in the Meta Ads Library.Apify
amazon-adsPlan and launch Amazon Sponsored Products campaigns.Amazon Ads
tiktok-adsPlan and launch TikTok ad campaigns across all objectives.TikTok Marketing
pinterest-adsPlan and launch Pinterest ad campaigns across all objectives.Pinterest Ads
Social media
tiktokPublish videos, photos, and carousels to TikTok.TikTok (Login Kit)
instagramPublish posts, Reels, Stories, and carousels. Moderate comments, send DMs, pull insights.Instagram (Business Login)
linkedinPublish text, articles, documents, and AI-generated carousels — personal profiles and company pages.LinkedIn
Research
seo-researchKeyword research, SERP and AI Overview analysis, competitor benchmarks, AI search visibility, backlinks, site audits.HyperSEO toolkit
competitor-intelResearch competitors end-to-end — site, social, search rank, AI-search citations, mentions — and produce battle cards, weekly digests, or board-prep updates.Firecrawl + at least one of HyperSEO or Apify scrapers
customer-researchMine Reddit, YouTube comments, G2/Capterra, Twitter, and TikTok to surface what customers actually say — build personas, VOC quote banks, JTBD maps, and synthesis reports.Apify scrapers toolkit (Reddit, Twitter, YouTube, TikTok, Instagram)
youtube-transcriptFetch the transcript of any YouTube video and turn it into blog posts, social content, summaries, show notes, quote extractions, or timestamped chapters.YouTube toolkit
Creative
ad-creative-generationGenerate ad copy and on-brand images for Google and Meta placements.Firecrawl + image gen toolkit
image-generationGenerate and edit images — picks the right model for text-heavy creatives, photoreal product shots, or high-res output.Image gen toolkit
video-generationGenerate AI video and prep it for distribution — text/image-to-video, captions, voiceover, stitching, overlays.Video gen toolkit
Outbound & lifecycle
cold-email-outreachRun end-to-end B2B cold outreach — prospect, enrich, personalize, send, follow up, route replies.Gmail + Apollo (Firecrawl + LinkedIn scraper bundled)
email-lifecycleBuild welcome, nurture, re-engagement, win-back, and abandoned-cart email programs.At least one of Klaviyo, Resend, Beehiiv, or Gmail
Analytics
analytics-insightsDrive GA4, Google Tag Manager, Search Console, and BigQuery from chat — tracking plans, reports, conversions, container audits, BigQuery export queries.At least one of GA4, GTM, GSC, or BigQuery
Execution
hyper-cliRun these marketing skills through the Hyper CLI (beta), translating raw MCP tool names into CLI aliases or raw toolkit calls.Hyper CLI + the integrations required by the sibling skill

Invoke explicitly with /google-ads, /cold-email-outreach, /seo-research, etc. — the slash name matches the folder under skills/.


Usage

Skill discovery is automatic. The transcript above shows multi-skill composition; smaller asks route to one skill at a time:

"Pull all the active Facebook ads for 'meal kit delivery' into a database." → meta-ads-library

"Run a 50-prospect cold-email campaign to Heads of Growth at US Series A SaaS companies." → cold-email-outreach

"Pull last month's GA4 traffic by channel and flag any conversion event that dropped >20%." → analytics-insights

"Build a weekly competitor digest for [comp-a, comp-b, comp-c] — site changes, social, search rank, mentions." → competitor-intel


Other install options

# install globally (available across every project)
npx skills add hyperfx-ai/marketing-skills -s seo-research -g

# Claude Code plugin marketplace
/plugin marketplace add hyperfx-ai/marketing-skills
/plugin install hyper-marketing@hyperfx-marketing-skills

# manual copy
cp -r skills/google-ads ~/.claude/skills/         # Claude Code
cp -r skills/google-ads ~/.agents/skills/         # Cursor / Codex / generic

# git submodule
git submodule add https://github.com/hyperfx-ai/marketing-skills.git .agents/marketing-skills

Repo layout

marketing-skills/
├── .claude-plugin/plugin.json          # Claude Code plugin manifest
├── .claude-plugin/marketplace.json    # Claude Code plugin marketplace catalog
├── .mcp.json                          # Hyper MCP server config (bundled with plugin)
├── .github/workflows/validate.yml     # CI: validate-skills.sh on PRs
├── skills/                             # one folder per skill
│   ├── <skill>/SKILL.md
│   └── <skill>/references/*.md         # progressive disclosure on larger skills
├── AGENTS.md                           # generic-agent entrypoint
├── CLAUDE.md                           # Claude Code entrypoint
├── CONTRIBUTING.md
└── validate-skills.sh                  # frontmatter + MCP-call lints

Built-in tools

ToolDescription
E-commerce ScraperScrape product listings, prices, and reviews
FirecrawlWeb scraping and crawling
Google Search ScraperPull Google SERP data
Google Trends ScraperPull Google Trends data
HyperSEOKeyword research, SERP analysis, AI search visibility
Image GenerationGenerate images (OpenAI, Nano Banana, Seedream)
Instagram ScraperScrape Instagram posts, profiles, and engagement
Knowledge BaseQuery and manage the agent's knowledge base
Location SearchGeo and location lookup
Meeting BotJoin, transcribe, and summarize meetings
Meta Ads LibrarySearch, scrape, and download live and historical Meta ads
Reddit ScraperScrape Reddit posts, threads, and comments
TikTok ScraperScrape TikTok videos, profiles, and engagement
Twitter ScraperScrape tweets, profiles, and threads
Video GenerationGenerate AI video (Sora, Veo, Seedance)
Web ScraperSearch and scrape web pages
Website AnalyzerAnalyze a website's tech stack, pixels, and more
YouTubeSearch YouTube and fetch transcripts

Native Hyper platform tools

ToolDescription
DatabaseQuery and store data
Code ExecutionRun Python or JavaScript in a sandbox
Toolkit ManagerManage MCP toolkits and connections
SkillsManage and invoke skills
FilesBuilt-in file system — read and write files
PlanningMulti-step task planning
TodoTrack tasks and progress
Web SearchGeneral-purpose web search
BrowserHeadless browser automation
AgentsCreate and manage agents (instructions, tasks, skills, context files, Slack channels)
HyperWorkspace, account, and platform-level actions

Roadmap

Near-term skills and surfaces:

  • hyper-cli (beta) — run these skills through the Hyper CLI from a terminal, cron job, or shell pipeline.
  • google-ads-operator — production Google Ads account operation and optimization.
  • meta-account-audit — Meta account diagnostics, spend checks, and performance recommendations.
  • social-carousel — carousel planning, copy, and export for social channels.
  • cmo — executive marketing reporting and cross-channel performance summaries.
  • reddit-research — focused Reddit research workflows for VOC, market maps, and positioning.
  • slide-generation — turn research, reports, and campaign plans into presentation decks.
  • pdf-generation — generate polished marketing reports and briefs.
  • copywriting — general-purpose marketing copy workflows.
  • lead-generation — prospect sourcing, enrichment, scoring, and handoff.
  • crm-revops — CRM hygiene, routing, attribution, and pipeline operations.
  • google-sheets-writing — structured spreadsheet creation and reporting.
  • gmail-email-management — inbox triage, labeling, reply drafting, and operational email workflows.
  • figma — design workflow support for ad creative, landing pages, and campaign assets.

See CONTRIBUTING.md to contribute a skill.


Contributing

PRs welcome. Every skill must pass ./validate-skills.sh (frontmatter + MCP-call lint). See CONTRIBUTING.md.

License

MIT — see LICENSE.

Ver o original no GitHub

Bom para

Relacionados