hyper-marketing — Claude Code plugin: marketing via Hyper MCP

# 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](https://www.hyperfx.ai/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](assets/hyper-mcp.png)

Create, customize, and connect your MCP at [app.hyperfx.ai/mcp](https://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 (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.](https://www.youtube.com/watch?v=NZLAdOL9fP8)

---

### Running the tools a skill names

Every tool in a skill is named by its canonical tool name, and that one name works on every surface:

| Surface | Find a tool | Run it |
| --- | --- | --- |
| MCP client | `search("<what you want to do>")`, `describe("<name>")` | `call("<name>", {...})` |
| Hyper CLI | `hyperai search "..."`, `hyperai describe <name>` | `hyperai call <name> --json '{...}'` |

The Hyper MCP lists six tools (`search`, `describe`, `call`, `connections_list`, `connections_use`, `info`); every other tool runs through `call`. A client that sends a tool name directly still works.

## Install

```bash
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](http://example.com)."*

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

# install all 24
npx skills add hyperfx-ai/marketing-skills --all
```

[Other install options below.](#other-install-options)

---

## What it looks like

> **You:** Run a viral paid and organic campaign for [acmebakes.com](http://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](http://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](https://adsmanager.facebook.com)** — $100/day, Advantage+ targeting, optimized for the Purchase event on your pixel, US 25–54.
> - **[TikTok Ads](https://ads.tiktok.com)** — $100/day, Traffic objective on the same audience, video creatives.
> - **[Google Ads Search](https://ads.google.com)** — $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

| Skill | What it does | Required integrations |
|---|---|---|
| **Foundation** | | |
| [`brand-context`](skills/brand-context) | Build one `brand-context.md` per brand — positioning, ICP, personas, verbatim customer language, voice, proof points — that every other skill reads before asking brand questions. | Firecrawl recommended for auto-draft; works standalone via interview |
| **Paid ads** | | |
| [`google-ads`](skills/google-ads) | Plan and launch Google Ads campaigns — Search, Display, and Performance Max — and build GAQL-backed reports and dashboards. | Google Ads |
| [`meta-ads`](skills/meta-ads) | Plan and launch Meta ad campaigns across Facebook and Instagram; audit existing accounts. | Meta Business, Firecrawl |
| [`meta-ads-library`](skills/meta-ads-library) | Research competitor ads in the Meta Ads Library. | Apify |
| [`amazon-ads`](skills/amazon-ads) | Plan and launch Amazon Sponsored Products campaigns. | Amazon Ads |
| [`tiktok-ads`](skills/tiktok-ads) | Plan and launch TikTok ad campaigns across all objectives. | TikTok Marketing |
| [`pinterest-ads`](skills/pinterest-ads) | Plan and launch Pinterest ad campaigns across all objectives. | Pinterest Ads |
| [`reddit-ads`](skills/reddit-ads) | Plan and launch Reddit ad campaigns — promoted posts, subreddit targeting, pixels, reporting. | Reddit Ads |
| [`snapchat-ads`](skills/snapchat-ads) | Plan and launch Snapchat ad campaigns — ad squads, creatives, Snap Pixel, reporting. | Snapchat Ads |
| [`openai-ads`](skills/openai-ads) | Plan and launch OpenAI Ads (ChatGPT ads) — chat card and product-feed creatives, audiences, insights. | OpenAI Ads (API key) |
| **Social media** | | |
| [`tiktok`](skills/tiktok) | Publish videos, photos, and carousels to TikTok. | TikTok (Login Kit) |
| [`instagram`](skills/instagram) | Publish posts, Reels, Stories, and carousels. Moderate comments, send DMs, pull insights. | Instagram (Business Login) |
| [`linkedin`](skills/linkedin) | Publish text, articles, documents, and AI-generated carousels — personal profiles and company pages. | LinkedIn |
| **Research** | | |
| [`seo-research`](skills/seo-research) | Keyword research, SERP and AI Overview analysis, competitor benchmarks, AI search visibility, backlinks, site audits. | HyperSEO toolkit |
| [`competitor-intel`](skills/competitor-intel) | Research 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-research`](skills/customer-research) | Mine 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) |
| [`reddit`](skills/reddit) | Research subreddits, threads, and sentiment — mine questions, pain points, and voice-of-customer. | Reddit scraper |
| [`youtube`](skills/youtube) | Fetch YouTube transcripts, repurpose video content into posts/summaries/chapters, and create thumbnails from proven composition patterns. | YouTube toolkit |
| **Creative** | | |
| [`ad-creative-generation`](skills/ad-creative-generation) | Generate ad copy and on-brand images for Google and Meta placements. | Firecrawl + image gen toolkit |
| [`image-generation`](skills/image-generation) | Generate and edit images — picks the right model for text-heavy creatives, photoreal product shots, or high-res output. | Image gen toolkit |
| [`video-generation`](skills/video-generation) | Generate AI video and prep it for distribution — text/image-to-video, captions, voiceover, stitching, overlays. | Video gen toolkit |
| [`blog-generation`](skills/blog-generation) | Generate one excellent, on-brand blog post per run — a stateful engine that never repeats a topic, built for SEO and AI-search citations. | Firecrawl, HyperSEO, and Google Search Console recommended |
| **Outbound & lifecycle** | | |
| [`cold-email-outreach`](skills/cold-email-outreach) | Run end-to-end B2B cold outreach — prospect, enrich, personalize, send, follow up, route replies. | Gmail + Apollo (Firecrawl + LinkedIn scraper bundled) |
| [`email-lifecycle`](skills/email-lifecycle) | Build welcome, nurture, re-engagement, win-back, and abandoned-cart email programs. | At least one of Klaviyo, Resend, Beehiiv, or Gmail |
| **Analytics** | | |
| [`analytics-insights`](skills/analytics-insights) | Drive 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-cli`](skills/hyper-cli) | Run 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

```bash
# 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

| Tool | Description |
|---|---|
| E-commerce Scraper | Scrape product listings, prices, and reviews |
| Firecrawl | Web scraping and crawling |
| Google Search Scraper | Pull Google SERP data |
| Google Trends Scraper | Pull Google Trends data |
| HyperSEO | Keyword research, SERP analysis, AI search visibility |
| Image Generation | Generate images (OpenAI, Nano Banana, Seedream) |
| Instagram Scraper | Scrape Instagram posts, profiles, and engagement |
| Knowledge Base | Query and manage the agent's knowledge base |
| Location Search | Geo and location lookup |
| Meeting Bot | Join, transcribe, and summarize meetings |
| Meta Ads Library | Search, scrape, and download live and historical Meta ads |
| Reddit Scraper | Scrape Reddit posts, threads, and comments |
| TikTok Scraper | Scrape TikTok videos, profiles, and engagement |
| Twitter Scraper | Scrape tweets, profiles, and threads |
| Video Generation | Generate AI video (Veo, Seedance) |
| Web Scraper | Search and scrape web pages |
| Website Analyzer | Analyze a website's tech stack, pixels, and more |
| YouTube | Search YouTube and fetch transcripts |

## Native Hyper platform tools

| Tool | Description |
|---|---|
| Database | Query and store data |
| Code Execution | Run Python or JavaScript in a sandbox |
| Toolkit Manager | Manage MCP toolkits and connections |
| Skills | Manage and invoke skills |
| Files | Built-in file system — read and write files |
| Planning | Multi-step task planning |
| Todo | Track tasks and progress |
| Web Search | General-purpose web search |
| Browser | Headless browser automation |
| Agents | Create and manage agents (instructions, tasks, skills, context files, Slack channels) |
| Hyper | Workspace, account, and platform-level actions |

---

## Roadmap

Near-term skills and surfaces:

- [x] `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](CONTRIBUTING.md) to contribute a skill.

---

### Apps & channels

| Skill | What it does | Needs |
| --- | --- | --- |
| [`gmail`](skills/gmail) | Read, draft, send, and organize Gmail — labels, threads, drafts, attachments. | Gmail |
| [`google-sheets`](skills/google-sheets) | Write structured data to Google Sheets and keep spreadsheets up to date. | Google Sheets |
| [`slack`](skills/slack) | Send Slack messages, share files and images, and work with channels and threads. | Slack |
| [`twilio`](skills/twilio) | Send SMS and WhatsApp messages and manage Twilio messaging workflows. | Twilio |

## Contributing

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

## License

MIT — see [LICENSE](LICENSE).