Skip to content

Open-source SEO, GEO, and marketing skills for AI agents.

chore: register meta-ads skills, add Meta MCP server, bump to v0.17.0

Yuting Zhong885c5c80e7c8
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
index 7aa4649c..629d463c 100644
--- a/.claude-plugin/marketplace.json
+++ b/.claude-plugin/marketplace.json
@@ -4,15 +4,15 @@
"name": "nowork-studio"
},
"metadata": {
- "description": "The official Google Ads + SEO + GEO plugin from NotFair. SEO, GEO, and Google Ads skills for Claude Code.",
- "version": "0.16.0"
+ "description": "The official Google Ads + Meta Ads + SEO + GEO plugin from NotFair. SEO, GEO, Google Ads, and Meta Ads skills for Claude Code.",
+ "version": "0.17.0"
},
"plugins": [
{
"name": "toprank",
"source": "./",
- "description": "The official Google Ads + SEO + GEO plugin from NotFair. SEO analysis, Google Ads management, keyword research, content optimization, schema markup, meta tags optimization, broken link checker, single-page deep audit, and Generative Engine Optimization for AI search.",
- "version": "0.16.0",
+ "description": "The official Google Ads + Meta Ads + SEO + GEO plugin from NotFair. SEO analysis, Google Ads management, Meta (Facebook + Instagram) Ads management, keyword research, content optimization, schema markup, meta tags optimization, broken link checker, single-page deep audit, and Generative Engine Optimization for AI search.",
+ "version": "0.17.0",
"author": {
"name": "NotFair",
"url": "https://notfair.co"
diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
index eb3c2b2d..dd71030c 100644
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
{
"name": "toprank",
- "version": "0.16.0",
- "description": "The official Google Ads + SEO + GEO plugin from NotFair. SEO analysis, Google Ads management, keyword research, content optimization, schema markup tools, broken link checker, single-page deep audit, and Generative Engine Optimization (GEO) for AI search engines — powered by Google Search Console and Google Ads APIs.",
+ "version": "0.17.0",
+ "description": "The official Google Ads + Meta Ads + SEO + GEO plugin from NotFair. SEO analysis, Google Ads management, Meta (Facebook + Instagram) Ads management, keyword research, content optimization, schema markup tools, broken link checker, single-page deep audit, and Generative Engine Optimization (GEO) for AI search engines — powered by Google Search Console, Google Ads, and Meta Marketing APIs.",
"author": {
"name": "NotFair",
"url": "https://notfair.co"
@@ -11,6 +11,8 @@
"./google-ads/audit",
"./google-ads/copy",
"./google-ads/landing",
+ "./meta-ads/manage",
+ "./meta-ads/audit",
"./seo/seo-analysis",
"./seo/content-writer",
"./seo/keyword-research",
diff --git a/.mcp.json b/.mcp.json
index e2d44c01..a68573df 100644
--- a/.mcp.json
+++ b/.mcp.json
@@ -3,6 +3,10 @@
"NotFair-GoogleAds": {
"type": "http",
"url": "https://notfair.co/api/mcp/google_ads"
+ },
+ "NotFair-MetaAds": {
+ "type": "http",
+ "url": "https://notfair.co/api/mcp/meta_ads"
}
}
-}
\ No newline at end of file
+}
diff --git a/CHANGELOG.md b/CHANGELOG.md
index b77d6d88..c61e986f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -10,6 +10,9 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
## [Unreleased]
### Added
+- **New skills: `/meta-ads` and `/meta-ads-audit`** — Meta Ads (Facebook + Instagram) operate / diagnose / audit skills. `/meta-ads` is the analytical brain layered on top of the NotFair-MetaAds MCP server: it covers performance and ROAS analysis, creative fatigue diagnosis, Learning Phase / Learning Limited triage, audience overlap and lookalike strategy, CBO/ABO/Advantage+ Shopping campaign structure, and the dedicated mutations the Meta MCP exposes (`pauseCampaign`/`pauseAdSet`/`pauseAd`, `enable*`, `updateCampaignBudget`, `updateAdSetBudget`, `renameCampaign`). `/meta-ads-audit` is the read-only health check — 7 dimensions scored 0–5 (Pixel + CAPI Health, Attribution & Measurement, Campaign Structure, Creative Health, Audience Strategy, Spend Efficiency, Scaling Readiness) — and persists `meta/business-context.json` + `meta/personas/{accountId}.json` for downstream skills. Skills follow the existing `google-ads/` template (`manage/`, `audit/`, `shared/`) and reuse the same `.notfair.json` config file via a new `metaAccountId` field. **Intentionally scoped:** `/meta-ads-copy` and `/meta-ads-landing` are not shipped in this release — Meta's creative-led, no-Quality-Score reality means those skills warrant Meta-native designs rather than literal mirrors of the Google Ads versions.
+- **MCP server: `NotFair-MetaAds`** — added to `.mcp.json` (`https://notfair.co/api/mcp/meta_ads`). Same OAuth 2.1 / native HTTP transport as `NotFair-GoogleAds`. Existing OAuth tokens for NotFair apply; restart Claude Code after upgrading to pick up the new server.
+- **`meta-ads/shared/`** — preamble (MCP detection + onboarding for `metaAccountId`), `policy-registry.json` (Meta-specific assumptions: CBO/ABO, Learning Phase 50-in-7, attribution defaults, frequency thresholds, ASC, AEM/CAPI), and `meta-math.md` (CPM, link CTR, hook rate, frequency, Break-Even ROAS, MER, budget-forecasting respecting the 20% rule that resets Meta Learning Phase).
- **OpenClaw adaptive layer (working MVP).** Added a new `openclaw/` repo surface that wraps the existing Toprank SEO skills for OpenClaw without duplicating them. The MVP includes multi-site portfolio docs, per-site work-folder conventions, wrapper skills (`toprank-site-onboard`, `toprank-portfolio-review`, `toprank-weekly-review`, `toprank-improve-page`, `toprank-investigate-drop`), JSON artifact schemas, helper scripts to bootstrap a portfolio and per-site workspace, onboarding persistence, weekly-review run persistence, portfolio review ranking, page-improvement persistence, drop-investigation persistence, follow-up discovery, a simple scheduler runner that processes due `feedback_check` items and surfaces manual-attention work, automatic baseline snapshot inheritance for feedback queue items, a first-pass feedback scorer that classifies follow-ups as `win`, `neutral`, `loss`, or `inconclusive` from before/after metric snapshots, learned-prior updates in `learned-patterns.json`, and a helper to hydrate observed metrics from real Google Search Console data.
---
diff --git a/VERSION b/VERSION
index 04a373ef..c5523bd0 100644
--- a/VERSION
+++ b/VERSION
@@ -1 +1 @@
-0.16.0
+0.17.0