Open-source SEO, GEO, and marketing skills for AI agents.
feat: open-source notfair-cmo + add /notfair:cmo skill (0.25.0)
Yuting Zhong0403dcb89375
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.jsonindex 9995fb0a..5f6c2050 100644--- a/.claude-plugin/marketplace.json+++ b/.claude-plugin/marketplace.json@@ -5,14 +5,14 @@},"metadata": {"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.24.0"+ "version": "0.25.0"},"plugins": [{"name": "notfair","source": "./","description": "The official Google Ads + Meta Ads + SEO + GEO plugin from NotFair. SEO analysis, Google Ads management, Meta (Facebook + Instagram) Ads management, GSC-driven content planning + local calendar viewer, opt-in OpenClaw cron publisher to a NotFair webhook, 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.24.0",+ "version": "0.25.0","author": {"name": "NotFair","url": "https://notfair.co"diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.jsonindex b7f42f07..b8055284 100644--- a/.claude-plugin/plugin.json+++ b/.claude-plugin/plugin.json@@ -1,6 +1,6 @@{"name": "notfair",- "version": "0.24.0",+ "version": "0.25.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",@@ -24,6 +24,7 @@"./seo/broken-link-checker","./seo/geo-optimizer","./notfair-upgrade-skill",+ "./notfair-cmo-skill","./gemini"]}diff --git a/AGENTS.md b/AGENTS.mdindex 79966948..e5bd0b6d 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -58,6 +58,7 @@ Skills under `seo/`, `google-ads/`, `meta-ads/`, `gemini/`, and `notfair-upgrade| Intent | Skill | Path ||---|---|---|| Upgrade NotFair to the latest version | `upgrade` | `notfair-upgrade-skill/SKILL.md` |+| Open the local NotFair CMO portal (browser UI for marketing agents) | `cmo` | `notfair-cmo-skill/SKILL.md` |---diff --git a/CHANGELOG.md b/CHANGELOG.mdindex b47e5876..7348ce28 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -11,6 +11,17 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).---+## [0.25.0] — 2026-05-24++### Added++- **`notfair-cmo/`** — open-sourced the local CMO portal as a sibling project in this repo. Node app (Next.js) that runs on `http://127.0.0.1:3000`, orchestrates specialist marketing agents (CMO, Google Ads, SEO) per project, exposes chat + cron + activity log + MCP connections. Distributed via npm as `notfair-cmo`. Each project gets its own OpenClaw workspace under `~/.notfair-cmo/agents/`. Source: [`notfair-cmo/README.md`](notfair-cmo/README.md).+- **`/notfair:cmo`** — new slash command. Probes `http://127.0.0.1:3000`; if not running, runs `notfair-cmo doctor`, then `npx notfair-cmo@latest start` detached, then opens the browser. Supports a custom port (`/notfair:cmo --port 4001`). Source: [`notfair-cmo-skill/SKILL.md`](notfair-cmo-skill/SKILL.md).++The plugin and the CMO portal share the same skills engine but ship through different channels (Claude Code marketplace vs npm) and on independent release cadences. The plugin's `VERSION` and `notfair-cmo/package.json` version are intentionally decoupled.++---+## [0.24.0] — 2026-05-24### ⚠️ Breaking — plugin renamed `toprank` → `notfair`diff --git a/README.md b/README.mdindex b9bd8f20..efb005b0 100644--- a/README.md+++ b/README.md@@ -1,4 +1,4 @@-# NotFair+# NotFair (formerly Toprank)[](https://discord.gg/gVJCRczpps)@@ -16,6 +16,48 @@ The NotFair plugin is the CLI side — the skills that run inside Claude Code (aFree, open-source. Install in 30 seconds.+### Or run it as a local app — [`notfair-cmo/`](notfair-cmo/)++Prefer a local UI over the CLI? **[notfair-cmo](notfair-cmo/)** is a Node app that runs entirely on your machine and orchestrates the same NotFair skills as specialist agents (CMO, Google Ads, SEO) per project. Chat with them, schedule their recurring work, watch tool calls stream inline. Bring your own LLM credentials and your own ad-platform OAuth — nothing leaves your machine.++#### Prerequisites++- **[OpenClaw](https://docs.openclaw.ai/install)** installed and the gateway running on this machine (`openclaw gateway`).+- **Node 20+** (Node 24 recommended).+- An LLM provider configured in your OpenClaw config (e.g. an `OPENAI_API_KEY` env var or `agents.defaults.model` entry).++#### Run it++From inside Claude Code, if you have the plugin installed:++```+/notfair:cmo+```++The skill probes whether the portal is already running, runs `notfair-cmo doctor` to verify your environment, then launches the server in the background and opens `http://127.0.0.1:3000/` in your browser.++Or from your shell directly:++```bash+# One-shot, no install:+npx notfair-cmo@latest doctor # verify env (Node, OpenClaw, LLM, data dir, port)+npx notfair-cmo@latest # launch UI on http://127.0.0.1:3000++# Or install globally:+npm install -g notfair-cmo+notfair-cmo+```++#### What you get++- Per-project specialist agents (CMO, Google Ads, SEO) auto-provisioned in isolated OpenClaw workspaces.+- A chat UI scoped to each project with inline streaming of tool calls and MCP invocations.+- A **Crons** tab (calendar + list) that groups OpenClaw's scheduled jobs by project + agent.+- **Connections** — one-click PKCE OAuth to bring Google Ads (and other NotFair MCP servers) into the agents' toolbox.+- An append-only **Activity log** of every autonomous decision and scheduled run.++See [`notfair-cmo/README.md`](notfair-cmo/README.md) for full docs.+---## See It Workdiff --git a/VERSION b/VERSIONindex 2094a100..d21d277b 100644--- a/VERSION+++ b/VERSION@@ -1 +1 @@-0.24.0+0.25.0diff --git a/notfair-cmo-skill/SKILL.md b/notfair-cmo-skill/SKILL.mdnew file mode 100644index 00000000..d6c7a738--- /dev/null+++ b/notfair-cmo-skill/SKILL.md@@ -0,0 +1,119 @@+---+name: cmo+argument-hint: "<or just run '/notfair:cmo'>"+description: >+ Launch the local NotFair CMO portal (a browser UI for specialist marketing agents)+ on this machine and open it in the browser. Use when the user asks to "open notfair-cmo",+ "launch the CMO", "open the marketing portal", "start the local CMO", or any phrasing+ that implies they want the local web UI for NotFair's marketing agents instead of the+ Claude Code CLI flow. The portal source lives at `notfair-cmo/` in this repo and is+ published to npm as `notfair-cmo`.+allowed-tools:+ - Bash+ - Read+---++# /notfair:cmo++Open the local NotFair CMO portal in the user's browser.++The portal is a Node app (`notfair-cmo`) that runs on `http://127.0.0.1:3000` and lets the user chat with specialist marketing agents (CMO, Google Ads, SEO), schedule recurring work, and watch tool calls stream inline. Source: [`notfair-cmo/`](../notfair-cmo/). Distributed via `npx notfair-cmo@latest`.++This skill **does not implement the portal** — it only launches it. If you need to change portal behavior, edit `notfair-cmo/` and ship via its own npm release.++---++## Default port++`3000` unless the user specifies otherwise (`--port`). If 3000 is busy, the portal's CLI auto-probes the next 5 ports.++---++## Step 1: Probe — is it already running?++```bash+PORT=3000+if curl -fsS --max-time 1 -o /dev/null "http://127.0.0.1:$PORT/" 2>/dev/null; then+ echo "RUNNING"+else+ echo "NOT_RUNNING"+fi+```++- If `RUNNING` → skip to **Step 4 (open browser)**.+- If `NOT_RUNNING` → continue to Step 2.++---++## Step 2: Preflight — run `notfair-cmo doctor`++The portal ships a `doctor` command that checks Node ≥ 20, `openclaw` on PATH, OpenClaw gateway reachable, an LLM provider configured, writable data dir, and a free port. It exits non-zero with `Fix:` lines on failure.++```bash+npx -y notfair-cmo@latest doctor 2>&1+```++- Exit 0 → continue to Step 3.+- Exit non-zero → **stop**. Surface the doctor output verbatim (it contains the `Fix:` instructions). Do not attempt to launch.++If `npx` itself is missing (no Node installed), surface: *"Node 20+ is required. Install from https://nodejs.org or via `nvm install 20`, then re-run `/notfair:cmo`."*++---++## Step 3: Launch the portal (detached)++Background it so the skill returns control. The portal opens the browser itself via its `open` dependency, but we double-tap in Step 4 in case it's already running headlessly.++```bash+LOG=$(mktemp -t notfair-cmo.XXXXXX.log)+nohup npx -y notfair-cmo@latest start --no-open > "$LOG" 2>&1 &+echo "Launched notfair-cmo (PID $!), log: $LOG"+```++Wait for the port to respond (up to 30s):++```bash+for i in $(seq 1 30); do+ if curl -fsS --max-time 1 -o /dev/null "http://127.0.0.1:$PORT/" 2>/dev/null; then+ echo "READY"+ break+ fi+ sleep 1+done+```++If after 30s the port still doesn't respond, surface the last 40 lines of `$LOG` and stop.++---++## Step 4: Open the browser++```bash+URL="http://127.0.0.1:$PORT/"+if command -v open >/dev/null 2>&1; then+ open "$URL"+elif command -v xdg-open >/dev/null 2>&1; then+ xdg-open "$URL"+elif command -v wslview >/dev/null 2>&1; then+ wslview "$URL"+else+ echo "Could not auto-open a browser. Visit: $URL"+fi+echo "NotFair CMO is open at $URL"+```++---++## Arguments++If the user passes a port (`/notfair:cmo --port 4001` or just `/notfair:cmo 4001`), substitute it for `PORT` above and pass `--port <n>` to `notfair-cmo start`.++---++## What this skill does *not* do++- It does not configure LLM providers — that's OpenClaw's `agents.defaults.model`. The doctor surfaces the right error if missing.+- It does not install OpenClaw. If `openclaw` isn't on PATH, the doctor's `Fix:` line names the install command.+- It does not create projects or run agents — the user does that from the browser UI.++If the user wants to see project source / open issues, point them at `notfair-cmo/` in this repo.