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.jsonindex 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.jsonindex 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.jsonindex 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.mdindex 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/VERSIONindex 04a373ef..c5523bd0 100644--- a/VERSION+++ b/VERSION@@ -1 +1 @@-0.16.0+0.17.0