Open-source SEO, GEO, and marketing skills for AI agents.
v0.24.0 breaking: rename plugin toprank -> notfair
Yuting Zhongb2d7e28533d9
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.jsonindex d1c4191a..9995fb0a 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.23.0"+ "version": "0.24.0"},"plugins": [{- "name": "toprank",+ "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.23.0",+ "version": "0.24.0","author": {"name": "NotFair","url": "https://notfair.co"@@ -20,4 +20,4 @@"category": "productivity"}]-}\ No newline at end of file+}diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.jsonindex b595cf49..b7f42f07 100644--- a/.claude-plugin/plugin.json+++ b/.claude-plugin/plugin.json@@ -1,6 +1,6 @@{- "name": "toprank",- "version": "0.23.0",+ "name": "notfair",+ "version": "0.24.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",@@ -23,7 +23,7 @@"./seo/seo-page","./seo/broken-link-checker","./seo/geo-optimizer",- "./toprank-upgrade-skill",+ "./notfair-upgrade-skill","./gemini"]-}\ No newline at end of file+}diff --git a/AGENTS.md b/AGENTS.mdindex 8e84324a..79966948 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -1,6 +1,6 @@-# Toprank — Skill Resolver for AI Agents+# NotFair — Skill Resolver for AI Agents-**This file is the universal entry point.** Any AI coding agent (Claude Code, OpenClaw, Codex, Hermes, Cursor, etc.) reads this to know which Toprank skill to run for which user intent.+**This file is the universal entry point.** Any AI coding agent (Claude Code, OpenClaw, Codex, Hermes, Cursor, etc.) reads this to know which NotFair skill to run for which user intent.If you are an agent and a user mentions Google Ads, Meta Ads, SEO, GEO, or anything in the tables below, route to the named skill.@@ -12,7 +12,7 @@ If you are an agent and a user mentions Google Ads, Meta Ads, SEO, GEO, or anyth2. **Read the named skill's `SKILL.md`** from the path shown.3. **Follow the procedure** in that SKILL.md exactly.-Skills under `seo/`, `google-ads/`, `meta-ads/`, `gemini/`, and `toprank-upgrade-skill/` are **host-agnostic** — they work the same on every agent host. The skills under `openclaw/skills/` are **OpenClaw-only orchestrators** that compose the host-agnostic skills into multi-site adaptive workflows; only invoke them inside an OpenClaw workspace.+Skills under `seo/`, `google-ads/`, `meta-ads/`, `gemini/`, and `notfair-upgrade-skill/` are **host-agnostic** — they work the same on every agent host. The skills under `openclaw/skills/` are **OpenClaw-only orchestrators** that compose the host-agnostic skills into multi-site adaptive workflows; only invoke them inside an OpenClaw workspace.---@@ -57,21 +57,21 @@ Skills under `seo/`, `google-ads/`, `meta-ads/`, `gemini/`, and `toprank-upgrade| Intent | Skill | Path ||---|---|---|-| Upgrade Toprank to the latest version | `toprank-upgrade` | `toprank-upgrade-skill/SKILL.md` |+| Upgrade NotFair to the latest version | `upgrade` | `notfair-upgrade-skill/SKILL.md` |---## OpenClaw multi-site orchestrators-These skills only apply inside an OpenClaw workspace that has been initialized via `./openclaw/install/install.sh`. They compose the host-agnostic SEO skills above into closed-loop, multi-site workflows with persisted artifacts under `~/.toprank/openclaw/`.+These skills only apply inside an OpenClaw workspace that has been initialized via `./openclaw/install/install.sh`. They compose the host-agnostic SEO skills above into closed-loop, multi-site workflows with persisted artifacts under `~/.toprank/openclaw/` (path retained from the toprank → notfair rename to preserve existing portfolio state; see CHANGELOG 0.24.0).| Intent | Skill | Path ||---|---|---|-| Register a new site in the portfolio | `toprank-site-onboard` | `openclaw/skills/toprank-site-onboard/SKILL.md` |-| Pick which site in the portfolio deserves attention next | `toprank-portfolio-review` | `openclaw/skills/toprank-portfolio-review/SKILL.md` |-| Weekly SEO review for one registered site | `toprank-weekly-review` | `openclaw/skills/toprank-weekly-review/SKILL.md` |-| Improve one URL inside a registered site | `toprank-improve-page` | `openclaw/skills/toprank-improve-page/SKILL.md` |-| Investigate an organic traffic drop on a registered site | `toprank-investigate-drop` | `openclaw/skills/toprank-investigate-drop/SKILL.md` |+| Register a new site in the portfolio | `notfair-site-onboard` | `openclaw/skills/notfair-site-onboard/SKILL.md` |+| Pick which site in the portfolio deserves attention next | `notfair-portfolio-review` | `openclaw/skills/notfair-portfolio-review/SKILL.md` |+| Weekly SEO review for one registered site | `notfair-weekly-review` | `openclaw/skills/notfair-weekly-review/SKILL.md` |+| Improve one URL inside a registered site | `notfair-improve-page` | `openclaw/skills/notfair-improve-page/SKILL.md` |+| Investigate an organic traffic drop on a registered site | `notfair-investigate-drop` | `openclaw/skills/notfair-investigate-drop/SKILL.md` |If the user mentions multi-site work, portfolio, scheduled follow-ups, or "the next best action across my sites," prefer an OpenClaw orchestrator. For single ad-hoc requests on one site, use the canonical SEO skill directly.@@ -93,9 +93,9 @@ Skills check for missing credentials at startup and walk the user through setup.Any installer that writes into a file the user also edits (e.g., a user's workspace `AGENTS.md`, `CLAUDE.md`, or `~/.openclaw/AGENTS.md`) MUST wrap its inserted content in a fence:```-<!-- toprank:managed -->+<!-- notfair:managed -->... auto-generated rows ...-<!-- /toprank:managed -->+<!-- /notfair:managed -->```Re-running the installer rewrites only inside the fence. Anything outside is preserved.diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 4c8e82ac..b47e5876 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -1,6 +1,6 @@# Changelog-All notable changes to Toprank will be documented here.+All notable changes to the NotFair plugin (formerly `toprank`) will be documented here.The format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).@@ -11,6 +11,100 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).---+## [0.24.0] — 2026-05-24++### ⚠️ Breaking — plugin renamed `toprank` → `notfair`++The Claude Code plugin name, slash-command prefix, and several internal+directories and binaries have been renamed from `toprank` to `notfair` to+align with the user-facing NotFair brand. This is a breaking change for+every installed user.++**You must uninstall the old plugin and reinstall under the new name:**++```+/plugin uninstall toprank@nowork-studio+/plugin marketplace add nowork-studio/notfair+/plugin install notfair@nowork-studio+```++After reinstall, every slash command moves from `/toprank:foo` →+`/notfair:foo` (e.g. `/notfair:google-ads-audit`, `/notfair:seo-analysis`).+The upgrade skill is now `/notfair:upgrade` (previously+`/toprank:toprank-upgrade`).++### Renamed++- **Plugin** — `name` in `.claude-plugin/plugin.json` and+ `.claude-plugin/marketplace.json` is now `notfair` (previously `toprank`).+- **Skill directories** — `toprank-upgrade-skill/` →+ `notfair-upgrade-skill/`; `openclaw/skills/toprank-{site-onboard,+ portfolio-review,weekly-review,improve-page,investigate-drop}/` →+ `openclaw/skills/notfair-{...}/`.+- **Bin scripts** — `bin/toprank-{config,update-check,change-watch,+ content-calendar}` → `bin/notfair-{...}`. SessionStart hooks that ran the+ old path will need to be re-pointed.+- **Cron / launchd example** — `openclaw/install/toprank-openclaw.cron.example`+ → `notfair-openclaw.cron.example`.+- **Upgrade skill name** — frontmatter `name: toprank-upgrade` →+ `name: upgrade`; slash command consequently `/notfair:upgrade`.+- **Managed-block fence** — installers now write `<!-- notfair:managed -->`+ fences (previously `<!-- toprank:managed -->`). Re-running an installer+ against a file that has the old fence will create a second fence; users+ who want a fully clean state can delete the old block manually.+- **GitHub repository** — `nowork-studio/toprank` → `nowork-studio/notfair`+ (GitHub auto-redirects the old URL).++### Intentionally preserved (carve-outs)++The following paths and identifiers were **not** renamed in this release so+existing installs keep working without a migration step. A future release+may migrate them with proper backup logic.++- **`~/.toprank/` runtime state directory** — holds OpenClaw portfolio+ artifacts (`~/.toprank/openclaw/`), Google Ads change logs+ (`~/.toprank/ads/<account>/change-log.json`), SEO audit history+ (`~/.toprank/audit-log/<domain>.json`), business-context cache+ (`~/.toprank/business-context/<domain>.json`), and upgrade markers.+ Renaming this would orphan every existing user's accumulated data.+- **`TOPRANK_*` environment variables** — `TOPRANK_DIR`, `TOPRANK_STATE_DIR`,+ `TOPRANK_REMOTE_URL`, `TOPRANK_OPENCLAW_HOME`,+ `TOPRANK_VERCEL_PROTECTION_BYPASS`. These are internal testing /+ configuration overrides; renaming would silently break any user, cron job,+ or CI pipeline that sets them.+- **`com.noworkstudio.toprank.openclaw.scheduler` launchd label** —+ renaming would orphan the existing launchd job; the user would have to+ manually `launchctl unload` the old one.+- **`~/.toprank-evals/` test result store** — used only by the test suite.++### CHANGELOG history preserved verbatim++Past releases shipped under the `toprank` name and the historical record+reflects that. CHANGELOG entries below this one are unchanged.++### Out of scope (pre-existing)++- `meta-ads/manage/` and `meta-ads/audit/` do not ship `evals/evals.json`+ files. This gap predates 0.24.0 (introduced in 0.17.0). The renamed+ `test/install.test.sh` now enumerates all 18 skills correctly and surfaces+ the missing eval files as 2 failures; the prior test masked them by+ enumerating only 16 skills. A follow-up release should add the missing+ evals; this release does not change skill behavior.++### Migration footnotes++- **OpenClaw users** who ran `./openclaw/install/install-openclaw-cron.sh`+ on a prior release will have cron jobs named `Toprank OpenClaw Scheduler`+ and `Toprank Weekly Review — <site>`. After upgrading, re-running the+ install script will register new jobs named `NotFair ...` alongside the+ old `Toprank ...` ones. To clean up, run+ `openclaw cron remove "Toprank OpenClaw Scheduler"` and equivalent for+ each per-site weekly review job before re-installing.+- **Hooks pointing at `bin/toprank-change-watch`** in `~/.claude/settings.json`+ must be updated to `bin/notfair-change-watch` after reinstall.++---+## [0.23.0] — 2026-05-16### Changed — full removal of legacy AdsAgent branding from active codediff --git a/CLAUDE.md b/CLAUDE.mdindex de40de5b..17e79ac3 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -1,8 +1,8 @@-# Toprank — Public AI-Agent Plugin (Claude Code, OpenClaw, Codex, Hermes)+# NotFair — Public AI-Agent Plugin (Claude Code, OpenClaw, Codex, Hermes)**This is the public, open-source repository that ships to all customers and the community.**-Toprank is a host-agnostic plugin providing SEO, Google Ads, and Meta Ads skills for AI coding agents. It is distributed via the `nowork-studio` Claude Code marketplace and via direct agent install on OpenClaw, Codex, and Hermes. Every change here is user-facing.+NotFair is a host-agnostic plugin providing SEO, Google Ads, and Meta Ads skills for AI coding agents. It is distributed via the `nowork-studio` Claude Code marketplace and via direct agent install on OpenClaw, Codex, and Hermes. Every change here is user-facing.## Engineering Execution Standard@@ -34,8 +34,8 @@ This code ships to real users. Sycophancy and rubber-stamping cost us credibilit## Repository purpose-- Home of the `toprank` plugin — the public artifact customers install.-- Contains host-agnostic skills under `google-ads/`, `seo/`, `meta-ads/`, `gemini/`, and `toprank-upgrade-skill/`.+- Home of the `notfair` plugin — the public artifact customers install.+- Contains host-agnostic skills under `google-ads/`, `seo/`, `meta-ads/`, `gemini/`, and `notfair-upgrade-skill/`.- Contains OpenClaw-specific multi-site orchestrators under `openclaw/skills/` that compose the host-agnostic skills above.- Registered via `.claude-plugin/plugin.json` + `.claude-plugin/marketplace.json` (Claude Code) and `AGENTS.md` (every other host).- Paired with the NotFair-GoogleAds and NotFair-MetaAds MCP servers (OAuth at notfair.co) for ad-platform writes, and Google Search Console for SEO reads.@@ -60,7 +60,7 @@ The product is **NotFair**. All user-facing text, documentation, skill descripti- `.claude-plugin/marketplace.json` → both `metadata.version` and `plugins[0].version`- `VERSION` file at repo root5. Update `CHANGELOG.md` with a user-facing note.-6. Verify locally, then ship via `/ship`. Users pick up the new version through `toprank:toprank-upgrade`.+6. Verify locally, then ship via `/ship`. Users pick up the new version through `notfair:upgrade`.## Versioningdiff --git a/CONTRIBUTING.md b/CONTRIBUTING.mdindex c46aa378..a2b00508 100644--- a/CONTRIBUTING.md+++ b/CONTRIBUTING.md@@ -1,6 +1,6 @@-# Contributing to Toprank+# Contributing to NotFair-Thank you for your interest in contributing to Toprank! We welcome contributions from the community to help make this the best SEO and Google Ads plugin for Claude Code.+Thank you for your interest in contributing to NotFair! We welcome contributions from the community to help make this the best SEO and Google Ads plugin for Claude Code.## Code of Conduct@@ -47,7 +47,7 @@ The repo also ships an OpenClaw-specific surface under `openclaw/`.## Development Workflow1. **Fork the repository**.-2. **Clone your fork**: `git clone https://github.com/YOUR_USERNAME/toprank.git`+2. **Clone your fork**: `git clone https://github.com/YOUR_USERNAME/notfair.git`3. **Create a branch**: `git checkout -b feature/your-feature-name`4. **Make your changes**.5. **Run tests**: We use `pytest` for the main test suite, but `unittest` is also used for script-specific unit tests. Ensure your changes don't break existing functionality.diff --git a/INSTALL_FOR_AGENTS.md b/INSTALL_FOR_AGENTS.mdindex 9e48da54..546e1ecb 100644--- a/INSTALL_FOR_AGENTS.md+++ b/INSTALL_FOR_AGENTS.md@@ -1,12 +1,12 @@-# Install Toprank — for AI Agents+# Install NotFair — for AI Agents-You are an AI coding agent (Claude Code, OpenClaw, Codex, Hermes, Cursor, or similar). The user has asked you to install or set up Toprank. Follow this document end-to-end.+You are an AI coding agent (Claude Code, OpenClaw, Codex, Hermes, Cursor, or similar). The user has asked you to install or set up NotFair. Follow this document end-to-end.**Single paste line for users (give them this if they ask how to install):**```Retrieve and follow the instructions at:-https://raw.githubusercontent.com/nowork-studio/toprank/main/INSTALL_FOR_AGENTS.md+https://raw.githubusercontent.com/nowork-studio/notfair/main/INSTALL_FOR_AGENTS.md```---@@ -27,13 +27,13 @@ If you cannot determine the host, ask the user once and proceed.## Step 2 — Acquire the repo-If the Toprank repo is already on disk locally, use it; do not re-clone.+If the NotFair repo is already on disk locally, use it; do not re-clone.Otherwise:```bash-git clone https://github.com/nowork-studio/toprank.git-cd toprank+git clone https://github.com/nowork-studio/notfair.git+cd notfair```---@@ -42,11 +42,11 @@ cd toprank### host = `claude-code`-Toprank is published as a Claude Code plugin via the `nowork-studio` marketplace. The user should run inside Claude Code:+NotFair is published as a Claude Code plugin via the `nowork-studio` marketplace. The user should run inside Claude Code:```-/plugin marketplace add nowork-studio/toprank-/plugin install toprank@nowork-studio+/plugin marketplace add nowork-studio/notfair+/plugin install notfair@nowork-studio```Then verify by listing installed plugins. No further action required — Claude Code reads `.claude-plugin/plugin.json` directly.@@ -60,7 +60,7 @@ Run from the repo root:```This script:-1. Creates `~/.toprank/openclaw/` runtime state (or `$TOPRANK_OPENCLAW_HOME` if set).+1. Creates `~/.toprank/openclaw/` runtime state (or `$TOPRANK_OPENCLAW_HOME` if set). Path retained from the toprank → notfair rename to preserve existing portfolio state — see CHANGELOG 0.24.0.2. Bootstraps `portfolio.json` and `schedule.json`.3. Copies the OpenClaw orchestrator skills from `openclaw/skills/` into `~/.openclaw/skills/`.4. Symlinks `openclaw/shared`, `openclaw/bin`, and `seo/` to stable paths so wrappers resolve.@@ -68,7 +68,7 @@ This script:Verify:```bash-openclaw skills check | grep -i toprank+openclaw skills check | grep -i notfairpython3 -m pytest -q openclaw/tests```@@ -83,7 +83,7 @@ Codex reads `AGENTS.md` natively. From the repo root:codex --workspace .```-Toprank's skills live under `seo/`, `google-ads/`, `meta-ads/`, `gemini/`. Codex reads `AGENTS.md` and routes user intents to the named skills' `SKILL.md` files.+NotFair's skills live under `seo/`, `google-ads/`, `meta-ads/`, `gemini/`. Codex reads `AGENTS.md` and routes user intents to the named skills' `SKILL.md` files.> **Note:** A dedicated Codex install adapter (`install/codex/`) may be added in future versions to register skills into Codex's global skill directory. For now, workspace-local usage is the supported path.@@ -106,7 +106,7 @@ Read `AGENTS.md` at the repo root. It contains the full intent → skill routing## Step 4 — Connect external services-Toprank skills depend on external APIs. Walk the user through whichever they need:+NotFair skills depend on external APIs. Walk the user through whichever they need:- **Google Search Console** — required for any SEO skill that reads live ranking data. The skills will prompt for OAuth on first run.- **Google Ads** — connects via the NotFair MCP server at `https://notfair.co/api/mcp/google_ads` (OAuth). The user signs in once at notfair.co; the MCP handles the rest.@@ -121,8 +121,8 @@ Do **not** invent credentials. If a skill needs auth that isn't present, surface1. Confirm `AGENTS.md` is readable from the working directory.2. Confirm at least one canonical skill (e.g., `seo/seo-analysis/SKILL.md`) is readable.-3. For OpenClaw: confirm `openclaw skills check` lists at least one `toprank-*` skill.-4. Tell the user: "Toprank is installed. Try `/toprank:google-ads-audit` for ads or `/toprank:seo-analysis` for SEO."+3. For OpenClaw: confirm `openclaw skills check` lists at least one `notfair-*` skill.+4. Tell the user: "NotFair is installed. Try `/notfair:google-ads-audit` for ads or `/notfair:seo-analysis` for SEO."---@@ -130,5 +130,5 @@ Do **not** invent credentials. If a skill needs auth that isn't present, surface- **Read `AGENTS.md` first** for any user intent. It is the resolver.- **Skills are host-agnostic.** A `SKILL.md` under `seo/`, `google-ads/`, `meta-ads/`, `gemini/` works identically on every host. The `openclaw/skills/` orchestrators are the only host-specific layer.-- **If you write into a user-edited file** (e.g., their workspace `AGENTS.md`), wrap your insertions in `<!-- toprank:managed -->` ... `<!-- /toprank:managed -->` fences so re-runs are idempotent and hand-edits survive.+- **If you write into a user-edited file** (e.g., their workspace `AGENTS.md`), wrap your insertions in `<!-- notfair:managed -->` ... `<!-- /notfair:managed -->` fences so re-runs are idempotent and hand-edits survive.- **Do not duplicate skills** when adding new host adapters. Add a thin install adapter under `install/<host>/` that points the host at the existing skill files.diff --git a/README.md b/README.mdindex 173219c2..b9bd8f20 100644--- a/README.md+++ b/README.md@@ -1,14 +1,14 @@-# Toprank+# NotFair[](https://discord.gg/gVJCRczpps)**The official Google & Meta Ads + SEO plugin from [NotFair](https://notfair.co). Data-driven decisions, not dashboards.**-Toprank gives your AI agent direct access to Google Search Console, Google Ads, and Meta Ads (Facebook + Instagram). It analyzes your traffic, surfaces what's hurting your rankings, finds wasted ad spend, diagnoses creative fatigue and audience saturation, and tells you exactly what to fix. When you have access to the repo, it goes further: rewriting meta tags, fixing headings, adding structured data, and shipping the changes.+NotFair gives your AI agent direct access to Google Search Console, Google Ads, and Meta Ads (Facebook + Instagram). It analyzes your traffic, surfaces what's hurting your rankings, finds wasted ad spend, diagnoses creative fatigue and audience saturation, and tells you exactly what to fix. When you have access to the repo, it goes further: rewriting meta tags, fixing headings, adding structured data, and shipping the changes.-### Why NotFair?+### CLI + web — same engine-Toprank is the CLI side of NotFair — the skills that run inside Claude Code. [notfair.co](https://notfair.co) is the companion web app: sign in once, connect your Google Ads and Meta Ads accounts, and run audits through a browser UI. Both sides share the same engine, so an audit you run from the CLI uses the same tooling as the one on the web.+The NotFair plugin is the CLI side — the skills that run inside Claude Code (and other AI agent hosts). [notfair.co](https://notfair.co) is the companion web app: sign in once, connect your Google Ads and Meta Ads accounts, and run audits through a browser UI. Both sides share the same engine, so an audit you run from the CLI uses the same tooling as the one on the web.> *"Am I wasting money on ads right now?"*> *"Why did my traffic drop and how do I fix it?"*@@ -23,7 +23,7 @@ Free, open-source. Install in 30 seconds.### Google Ads```-You: /toprank:google-ads-audit+You: /notfair:google-ads-auditClaude: Connected to your Google Ads account (MyStore).@@ -45,7 +45,7 @@ Claude: Connected to your Google Ads account (MyStore).2. Add 12 negative keywords ($130/mo wasted on irrelevant terms)3. Increase bids 15% on 2 high-converting keywords losing IS- Business context saved — /toprank:google-ads-copy and /toprank:google-ads will use it.+ Business context saved — /notfair:google-ads-copy and /notfair:google-ads will use it.You: Do it all.@@ -59,7 +59,7 @@ You: Do it all.**Weekly review** — ask any time, or set it up as a recurring Coworker task:```-You: /toprank:google-ads — "review last week's changes"+You: /notfair:google-ads — "review last week's changes"Claude: 12 changes in the last 7 days. 9 matured enough to judge.@@ -82,7 +82,7 @@ Claude: 12 changes in the last 7 days. 9 matured enough to judge.### SEO```-You: /toprank:seo-analysis+You: /notfair:seo-analysisClaude: Found your site at mystore.com — pulling Search Console data now.@@ -107,21 +107,21 @@ Claude: Found your site at mystore.com — pulling Search Console data now.## Install-Toprank is a **Claude Code plugin**. One-time setup, automatic updates.+NotFair is a **Claude Code plugin**. One-time setup, automatic updates.### Claude Code (recommended)Run these two commands in Claude Code:```-/plugin marketplace add nowork-studio/toprank+/plugin marketplace add nowork-studio/notfair``````-/plugin install toprank@nowork-studio+/plugin install notfair@nowork-studio```-That's it. All skills are now available as `/toprank:*` commands.+That's it. All skills are now available as `/notfair:*` commands.**Google Ads + Meta Ads (optional):** The first time Claude Code connects to either NotFair MCP server (`NotFair-GoogleAds` or `NotFair-MetaAds`), it opens a browser tab and asks you to sign in to [notfair.co](https://notfair.co) — authorize once per platform and the token is stored in your OS keychain. No API key to copy, no `mcp-remote` bridge to install.@@ -138,24 +138,35 @@ Add the marketplace and enable the plugin in `~/.claude/settings.json`:"nowork-studio": {"source": {"source": "github",- "repo": "nowork-studio/toprank"+ "repo": "nowork-studio/notfair"}}},"enabledPlugins": {- "toprank@nowork-studio": true+ "notfair@nowork-studio": true}}```</details>+### Upgrading from `toprank@nowork-studio`++The plugin was renamed `toprank` → `notfair` in v0.24.0. If you previously installed it as `toprank@nowork-studio`, uninstall the old entry and install the new one:++```+/plugin uninstall toprank@nowork-studio+/plugin marketplace add nowork-studio/notfair+/plugin install notfair@nowork-studio+```++Your data is preserved — the runtime state directory (`~/.toprank/`, holding portfolio state, change logs, business-context cache, audit history) is intentionally retained under its original name for this release. See `CHANGELOG.md` for details.---## 🤖 The Fully-Automated SEO Agent (OpenClaw / Hermes)-Instead of manually running single SEO skills, the future of Toprank is the **Fully-Automated SEO Agent**.+Instead of manually running single SEO skills, the future of NotFair is the **Fully-Automated SEO Agent**.By leveraging the **OpenClaw adaptive layer** under [`openclaw/`](openclaw/), you can instruct OpenClaw or Hermes to automatically set up a persistent SEO agent for your project. This isn't just a set of tools—it's a background worker that configures cron jobs, continually monitors your site, runs SEO audits, and autonomously makes improvements over time.@@ -210,16 +221,16 @@ Start building your agent here:|-------|-------------|| [`gemini`](gemini/) | Second opinion from Google Gemini. Review (pass/fail gate), challenge (adversarial stress test), or consult (open Q&A). Especially strong on Google Ads and SEO decisions — Gemini has native Google ecosystem knowledge. |-All skills are namespaced: `/toprank:google-ads`, `/toprank:seo-analysis`, `/toprank:gemini`, etc.+All skills are namespaced: `/notfair:google-ads`, `/notfair:seo-analysis`, `/notfair:gemini`, etc.---## How It Works-Toprank is a Claude Code plugin. Each skill is a `SKILL.md` file with supporting reference documents, scripts, and eval tests.+NotFair is a Claude Code plugin. Each skill is a `SKILL.md` file with supporting reference documents, scripts, and eval tests.```-toprank/+notfair/├── .claude-plugin/│ ├── plugin.json <- plugin metadata (explicit skill paths)│ └── marketplace.json <- registry entry@@ -245,7 +256,7 @@ toprank/│ └── setup-cms/ <- CMS connector├── gemini/ <- cross-model review via Gemini CLI├── openclaw/ <- OpenClaw adaptive layer (multi-site wrappers, artifacts, installers)-├── toprank-upgrade-skill/ <- self-updater+├── notfair-upgrade-skill/ <- self-updater├── test/ <- unit + LLM-judge eval tests└── VERSION```@@ -254,7 +265,7 @@ toprank/## MCP Servers-The Google Ads and Meta Ads surfaces are available as standalone remote MCP servers — use either from any MCP client (Claude Desktop, Cursor, Inspector, your own agent) without installing the Toprank CLI plugin.+The Google Ads and Meta Ads surfaces are available as standalone remote MCP servers — use either from any MCP client (Claude Desktop, Cursor, Inspector, your own agent) without installing the NotFair CLI plugin.### NotFair-GoogleAds@@ -271,13 +282,13 @@ Exposes ~100 Google Ads tools across reads (performance, search terms, impressioExposes a focused set of Meta Marketing API tools: reads (campaign / ad set / ad listings, `getInsights` with breakdowns), writes (`pauseCampaign`, `pauseAdSet`, `pauseAd`, `enableCampaign`, `enableAdSet`, `enableAd`, `updateCampaignBudget`, `updateAdSetBudget`, `renameCampaign`), `suggestImprovement` for server-side heuristic recommendations, and a `runScript` sandbox with `ads.graph(path, params)`, `ads.graphParallel([calls])` (up to 20 Graph API calls in parallel), `ads.insights(...)`, and `ads.batch([requests])` for analytical fan-out.-The Meta server's mutation surface is intentionally narrow — there is no programmatic create-campaign, no audience editing, and no creative upload. The `/meta-ads` skill is explicit about this and routes those operations to Meta Ads Manager.+The Meta server's mutation surface is intentionally narrow — there is no programmatic create-campaign, no audience editing, and no creative upload. The `/notfair:meta-ads` skill is explicit about this and routes those operations to Meta Ads Manager.---## Connectors-Toprank skills reference external tools using the `~~category` placeholder pattern. This makes skills tool-agnostic — they work with any MCP server that provides the required capability.+NotFair skills reference external tools using the `~~category` placeholder pattern. This makes skills tool-agnostic — they work with any MCP server that provides the required capability.| Category | Placeholder | Default Server | Alternatives ||----------|-------------|---------------|--------------|@@ -292,7 +303,7 @@ Skills use conditional blocks based on available tools. If a connector is not av- **Google Ads:** See `google-ads/shared/preamble.md`. The `.mcp.json` registers `https://notfair.co/api/mcp/google_ads` as a native HTTP MCP server; on first connection Claude Code opens a browser for OAuth sign-in to [notfair.co](https://notfair.co) and stores the token in your OS keychain — no environment variable, no bridge subprocess.- **Meta Ads:** See `meta-ads/shared/preamble.md`. The `.mcp.json` registers `https://notfair.co/api/mcp/meta_ads` as a native HTTP MCP server; OAuth sign-in is independent from Google Ads (sign in once per platform). Skills resolve the ad account from a `metaAccountId` field in `.notfair.json` (alongside `accountId` for Google Ads — same config file, no double-prompting).- **Search Console:** See `seo/shared/preamble.md`. Requires Google Cloud SDK, Search Console API enabled, and OAuth login.-- **CMS:** Run `/toprank:setup-cms` to configure WordPress, Strapi, Contentful, or Ghost.+- **CMS:** Run `/notfair:setup-cms` to configure WordPress, Strapi, Contentful, or Ghost.---@@ -324,11 +335,11 @@ Questions? Open an issue.## Star History-<a href="https://www.star-history.com/?repos=nowork-studio%2Ftoprank&type=date&legend=top-left">+<a href="https://www.star-history.com/?repos=nowork-studio%2Fnotfair&type=date&legend=top-left"><picture>- <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=nowork-studio/toprank&type=date&theme=dark&legend=top-left" />- <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=nowork-studio/toprank&type=date&legend=top-left" />- <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=nowork-studio/toprank&type=date&legend=top-left" />+ <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=nowork-studio/notfair&type=date&theme=dark&legend=top-left" />+ <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=nowork-studio/notfair&type=date&legend=top-left" />+ <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=nowork-studio/notfair&type=date&legend=top-left" /></picture></a>diff --git a/VERSION b/VERSIONindex ca222b7c..2094a100 100644--- a/VERSION+++ b/VERSION@@ -1 +1 @@-0.23.0+0.24.0diff --git a/bin/toprank-change-watch b/bin/notfair-change-watchsimilarity index 81%rename from bin/toprank-change-watchrename to bin/notfair-change-watchindex 6d878a77..d5f3ce84 100755--- a/bin/toprank-change-watch+++ b/bin/notfair-change-watch@@ -1,11 +1,11 @@#!/usr/bin/env bash-# toprank-change-watch — surface pending Google Ads change-impact reviews+# notfair-change-watch — surface pending Google Ads change-impact reviews## Designed to be wired as a Claude Code SessionStart hook:# {# "hooks": {# "SessionStart": [-# { "hooks": [ { "type": "command", "command": "toprank-change-watch" } ] }+# { "hooks": [ { "type": "command", "command": "notfair-change-watch" } ] }# ]# }# }@@ -18,11 +18,11 @@# Also supports generating an .ics calendar file for a specific change so the user# gets a cross-platform reminder in their own calendar app:#-# toprank-change-watch ics <account> <change_id> > reminder.ics+# notfair-change-watch ics <account> <change_id> > reminder.ics#-# Change log schema (written by /ads when it executes a mutation):+# Change log schema (written by /notfair:google-ads when it executes a mutation):# {-# (see google-ads/ads/references/change-tracking.md for the authoritative schema)+# (see google-ads/manage/references/change-tracking.md for the authoritative schema)# "changes": [# {# "id": "chg_1729872000000",@@ -43,8 +43,8 @@ TODAY="$(date -u +%Y-%m-%d)"# Subcommand: ics <account> <change_id>if [ "${1:-}" = "ics" ]; then- ACCOUNT="${2:?Usage: toprank-change-watch ics <account> <change_id>}"- CHANGE_ID="${3:?Usage: toprank-change-watch ics <account> <change_id>}"+ ACCOUNT="${2:?Usage: notfair-change-watch ics <account> <change_id>}"+ CHANGE_ID="${3:?Usage: notfair-change-watch ics <account> <change_id>}"LOG="$ADS_DIR/$ACCOUNT/change-log.json"[ -f "$LOG" ] || { echo "No change log for account $ACCOUNT" >&2; exit 1; }@@ -59,18 +59,18 @@ if not change:sys.exit(f"change {change_id} not found")d = change["reviewAfter"].replace("-", "")summary = change["summary"].replace("\n", " ")-uid = f"{change_id}-{uuid.uuid4().hex[:8]}@toprank"+uid = f"{change_id}-{uuid.uuid4().hex[:8]}@notfair"now = datetime.datetime.utcnow().strftime("%Y%m%dT%H%M%SZ")ics = f"""BEGIN:VCALENDARVERSION:2.0-PRODID:-//toprank//change-watch//EN+PRODID:-//notfair//change-watch//ENBEGIN:VEVENTUID:{uid}DTSTAMP:{now}DTSTART;VALUE=DATE:{d}DTEND;VALUE=DATE:{d}SUMMARY:Review Google Ads change: {summary}-DESCRIPTION:Run /ads-audit to measure impact against baseline.\\nChange ID: {change_id}+DESCRIPTION:Run /notfair:google-ads-audit to measure impact against baseline.\\nChange ID: {change_id}BEGIN:VALARMTRIGGER:-PT9HACTION:DISPLAY@@ -99,8 +99,8 @@ for log in "$ADS_DIR"/*/change-log.json; doecho "## Pending Google Ads change-impact reviews"echo ""echo "The following changes have reached their review window. Offer to run"- echo "a scoped /ads-audit to measure impact against the baseline captured"- echo "when each change was made:"+ echo "a scoped /notfair:google-ads-audit to measure impact against the"+ echo "baseline captured when each change was made:"echo ""fipending=1diff --git a/bin/toprank-config b/bin/notfair-configsimilarity index 57%rename from bin/toprank-configrename to bin/notfair-configindex cc0d0a5e..b4e1d380 100755--- a/bin/toprank-config+++ b/bin/notfair-config@@ -1,12 +1,12 @@#!/usr/bin/env bash-# toprank-config — read/write ~/.toprank/config.yaml+# notfair-config — read/write ~/.toprank/config.yaml## Usage:-# toprank-config get <key> — read a config value-# toprank-config set <key> <value> — write a config value-# toprank-config list — show all config+# notfair-config get <key> — read a config value+# notfair-config set <key> <value> — write a config value+# notfair-config list — show all config#-# Env overrides (for testing):+# Env overrides (for testing; name retained from the toprank → notfair rename):# TOPRANK_STATE_DIR — override ~/.toprank state directoryset -euo pipefail@@ -15,12 +15,12 @@ CONFIG_FILE="$STATE_DIR/config.yaml"case "${1:-}" inget)- KEY="${2:?Usage: toprank-config get <key>}"+ KEY="${2:?Usage: notfair-config get <key>}"grep -E "^${KEY}:" "$CONFIG_FILE" 2>/dev/null | tail -1 | awk '{print $2}' | tr -d '[:space:]' || true;;set)- KEY="${2:?Usage: toprank-config set <key> <value>}"- VALUE="${3:?Usage: toprank-config set <key> <value>}"+ KEY="${2:?Usage: notfair-config set <key> <value>}"+ VALUE="${3:?Usage: notfair-config set <key> <value>}"mkdir -p "$STATE_DIR"if grep -qE "^${KEY}:" "$CONFIG_FILE" 2>/dev/null; then_tmpfile="$(mktemp "${CONFIG_FILE}.XXXXXX")"@@ -33,7 +33,7 @@ case "${1:-}" incat "$CONFIG_FILE" 2>/dev/null || true;;*)- echo "Usage: toprank-config {get|set|list} [key] [value]"+ echo "Usage: notfair-config {get|set|list} [key] [value]"exit 1;;esacdiff --git a/bin/toprank-content-calendar b/bin/notfair-content-calendarsimilarity index 94%rename from bin/toprank-content-calendarrename to bin/notfair-content-calendarindex 7bdd2964..ce33bd23 100755--- a/bin/toprank-content-calendar+++ b/bin/notfair-content-calendar@@ -1,14 +1,15 @@#!/usr/bin/env python3-"""toprank-content-calendar — local viewer for the NotFair content calendar.+"""notfair-content-calendar — local viewer for the NotFair content calendar.-Reads {data_dir}/content-calendar.json (produced by the /content-planner skill)-and serves a read-only HTML view on localhost. Stdlib only — no pip install.+Reads {data_dir}/content-calendar.json (produced by the /notfair:content-planner+skill) and serves a read-only HTML view on localhost. Stdlib only — no pip+install.Usage:- toprank-content-calendar # auto-resolve calendar, port 8323- toprank-content-calendar --port 9000 # custom port- toprank-content-calendar --calendar PATH # explicit calendar JSON- toprank-content-calendar --no-open # don't auto-open the browser+ notfair-content-calendar # auto-resolve calendar, port 8323+ notfair-content-calendar --port 9000 # custom port+ notfair-content-calendar --calendar PATH # explicit calendar JSON+ notfair-content-calendar --no-open # don't auto-open the browserStop with Ctrl+C."""@@ -68,8 +69,8 @@ def render_page(cal: dict) -> str:<div class="empty"><h1>No calendar yet</h1><p>Looked for <code>{html.escape(cal['_path'])}</code> and didn't find it.</p>- <p>Run the <code>/content-planner</code> skill in your agent to- generate one, then reload this page.</p>+ <p>Run the <code>/notfair:content-planner</code> skill in your+ agent to generate one, then reload this page.</p></div>""",)@@ -359,7 +360,7 @@ def _port_in_use(port: int, host: str = "127.0.0.1") -> bool:def main(argv=None) -> int:- parser = argparse.ArgumentParser(prog="toprank-content-calendar")+ parser = argparse.ArgumentParser(prog="notfair-content-calendar")parser.add_argument("--port", type=int, default=DEFAULT_PORT)parser.add_argument("--calendar", default=None,help="Path to content-calendar.json (default: ./.notfair/... → ~/.notfair/...)")diff --git a/bin/toprank-update-check b/bin/notfair-update-checksimilarity index 92%rename from bin/toprank-update-checkrename to bin/notfair-update-checkindex 04318b5e..4712444b 100755--- a/bin/toprank-update-check+++ b/bin/notfair-update-check@@ -1,13 +1,13 @@#!/usr/bin/env bash-# toprank-update-check — periodic version check for toprank skills.+# notfair-update-check — periodic version check for the NotFair plugin.## Output (one line, or nothing):# JUST_UPGRADED <old> <new> — marker found from recent upgrade# UPGRADE_AVAILABLE <old> <new> — remote VERSION differs from local# (nothing) — up to date, snoozed, disabled, or check skipped#-# Env overrides (for testing):-# TOPRANK_DIR — override auto-detected toprank root+# Env overrides (for testing; names retained from the toprank → notfair rename):+# TOPRANK_DIR — override auto-detected plugin root# TOPRANK_REMOTE_URL — override remote VERSION URL# TOPRANK_STATE_DIR — override ~/.toprank state directoryset -euo pipefail@@ -18,8 +18,8 @@ CACHE_FILE="$STATE_DIR/last-update-check"MARKER_FILE="$STATE_DIR/just-upgraded-from"SNOOZE_FILE="$STATE_DIR/update-snoozed"VERSION_FILE="$TOPRANK_DIR/VERSION"-REMOTE_URL="${TOPRANK_REMOTE_URL:-https://raw.githubusercontent.com/nowork-studio/toprank/main/VERSION}"-CONFIG_BIN="$TOPRANK_DIR/bin/toprank-config"+REMOTE_URL="${TOPRANK_REMOTE_URL:-https://raw.githubusercontent.com/nowork-studio/notfair/main/VERSION}"+CONFIG_BIN="$TOPRANK_DIR/bin/notfair-config"VERSION_RE='^[0-9]+(\.[0-9]+)+$'# State dir must exist early so any writes below succeed.@@ -28,12 +28,12 @@ mkdir -p "$STATE_DIR"# ─── Dev symlink: skip update checks entirely ────────────────# When installed via a dev symlink (cache dir named "dev"), the plugin# is managed by the developer — no remote upgrade checks needed.-CACHE_DIR_NAME="$(basename "$(ls -d ~/.claude/plugins/cache/nowork-studio/toprank/*/ 2>/dev/null | head -1)" 2>/dev/null || true)"+CACHE_DIR_NAME="$(basename "$(ls -d ~/.claude/plugins/cache/nowork-studio/notfair/*/ 2>/dev/null | head -1)" 2>/dev/null || true)"if [ "$CACHE_DIR_NAME" = "dev" ]; thenexit 0fi-# ─── Force flag (busts cache + snooze for standalone /toprank-upgrade) ──+# ─── Force flag (busts cache + snooze for standalone /notfair:upgrade) ──if [ "${1:-}" = "--force" ]; thenrm -f "$CACHE_FILE"rm -f "$SNOOZE_FILE"diff --git a/bin/preamble.md b/bin/preamble.mdindex 1eb43b72..0545997a 100755--- a/bin/preamble.md+++ b/bin/preamble.md@@ -1,14 +1,14 @@## Preamble (run first)```bash-_UPD_BIN=$(ls ~/.claude/plugins/cache/nowork-studio/toprank/*/bin/toprank-update-check 2>/dev/null | head -1)+_UPD_BIN=$(ls ~/.claude/plugins/cache/nowork-studio/notfair/*/bin/notfair-update-check 2>/dev/null | head -1)[ -n "$_UPD_BIN" ] && _UPD=$("$_UPD_BIN" 2>/dev/null || true) || _UPD=""[ -n "$_UPD" ] && echo "$_UPD" || true```-If the output contains `UPGRADE_AVAILABLE <old> <new>`: immediately follow the inline upgrade flow in the `/toprank-upgrade` skill (Step 1 onward) to auto-upgrade, then return here and continue.+If the output contains `UPGRADE_AVAILABLE <old> <new>`: immediately follow the inline upgrade flow in the `/notfair:upgrade` skill (Step 1 onward) to auto-upgrade, then return here and continue.-If the output contains `JUST_UPGRADED <old> <new>`: mention "toprank upgraded from v{old} to v{new}" briefly, then continue.+If the output contains `JUST_UPGRADED <old> <new>`: mention "NotFair upgraded from v{old} to v{new}" briefly, then continue.---diff --git a/docs/openclaw-adaptive-layer.md b/docs/openclaw-adaptive-layer.mdindex 985769de..fed29bf6 100644--- a/docs/openclaw-adaptive-layer.md+++ b/docs/openclaw-adaptive-layer.md@@ -1,12 +1,12 @@# OpenClaw Adaptive Layer (MVP)-Toprank's OpenClaw surface is a thin adaptive layer that sits on top of the existing open-source SEO skills. It does **not** replace `seo/` or `google-ads/`. It adds multi-site state, scheduled review loops, artifact writing, and policy gates so an operator can manage a portfolio of websites from one OpenClaw workspace.+NotFair's OpenClaw surface is a thin adaptive layer that sits on top of the existing open-source SEO skills. It does **not** replace `seo/` or `google-ads/`. It adds multi-site state, scheduled review loops, artifact writing, and policy gates so an operator can manage a portfolio of websites from one OpenClaw workspace.## Product definition**Goal:** maximize qualified organic growth across a portfolio of websites, subject to explicit safety and approval rules.-**Core idea:** the existing Toprank skills are capability modules; the OpenClaw layer is the operator.+**Core idea:** the existing NotFair skills are capability modules; the OpenClaw layer is the operator.## Operating model@@ -132,11 +132,11 @@ The MVP requires at least:The MVP ships five OpenClaw-facing wrapper skills:-- `toprank-site-onboard`-- `toprank-portfolio-review`-- `toprank-weekly-review`-- `toprank-improve-page`-- `toprank-investigate-drop`+- `notfair-site-onboard`+- `notfair-portfolio-review`+- `notfair-weekly-review`+- `notfair-improve-page`+- `notfair-investigate-drop`These wrappers keep the existing `seo/` skills as the source of truth. The wrapper adds:diff --git a/gemini/SKILL.md b/gemini/SKILL.mdindex 596ac09f..055aae89 100644--- a/gemini/SKILL.md+++ b/gemini/SKILL.md@@ -277,8 +277,8 @@ Present Gemini's response with a clear header:### 5b — Cross-model analysis (if Claude already reviewed)-If Claude has already reviewed the same changes (e.g., via `/toprank:seo-analysis`-or `/toprank:google-ads-audit` earlier in the conversation), produce a cross-model+If Claude has already reviewed the same changes (e.g., via `/notfair:seo-analysis`+or `/notfair:google-ads-audit` earlier in the conversation), produce a cross-modelcomparison:> **Cross-Model Analysis: Claude vs Gemini**@@ -304,7 +304,7 @@ be flagged to the user for a judgment call.Based on the results:- **Review PASS:** "Gemini approved. Ready to ship."-- **Review FAIL:** "Gemini flagged blocking issues. Address them, then re-run `/toprank:gemini review`."+- **Review FAIL:** "Gemini flagged blocking issues. Address them, then re-run `/notfair:gemini review`."- **Challenge — HIGH risk:** "Stress test surfaced high-risk scenarios. Consider the mitigations before proceeding."- **Challenge — LOW risk:** "Gemini couldn't find major attack vectors. Changes look resilient."- **Consult:** "Want me to apply any of Gemini's suggestions?"diff --git a/google-ads/manage/references/change-tracking.md b/google-ads/manage/references/change-tracking.mdindex 508861ce..3fa0a592 100644--- a/google-ads/manage/references/change-tracking.md+++ b/google-ads/manage/references/change-tracking.md@@ -42,12 +42,12 @@ Append to the `changes` array:Users shouldn't have to remember to come back. Two complementary mechanisms:-1. **SessionStart hook** — `bin/toprank-change-watch` scans every account's `change-log.json` and prints any entry whose `reviewAfter` has passed and `reviewed == false`. Wire it in `~/.claude/settings.json`:+1. **SessionStart hook** — `bin/notfair-change-watch` scans every account's `change-log.json` and prints any entry whose `reviewAfter` has passed and `reviewed == false`. Wire it in `~/.claude/settings.json`:```json{"hooks": {"SessionStart": [- { "hooks": [ { "type": "command", "command": "/home/user/toprank/bin/toprank-change-watch" } ] }+ { "hooks": [ { "type": "command", "command": "/home/user/notfair/bin/notfair-change-watch" } ] }]}}@@ -56,6 +56,6 @@ Users shouldn't have to remember to come back. Two complementary mechanisms:2. **Calendar (.ics) reminder** — after logging a change, offer to generate a calendar invite the user can drop into any calendar app:```- toprank-change-watch ics <account_id> <change_id> > ~/review-<change_id>.ics+ notfair-change-watch ics <account_id> <change_id> > ~/review-<change_id>.ics```The .ics file includes a 9-hour-before alarm so the user gets notified on review day. Cross-platform, no cloud dependency, works offline.diff --git a/google-ads/shared/policy-registry.json b/google-ads/shared/policy-registry.jsonindex 96440bce..5444d51b 100644--- a/google-ads/shared/policy-registry.json+++ b/google-ads/shared/policy-registry.json@@ -1,6 +1,6 @@{"$schema": "policy-registry/v1",- "description": "Versioned registry of Google Ads policy and behavior assumptions used across toprank ads skills. Each entry tracks a specific assumption, its volatility, verification source, and when it should be re-verified.",+ "description": "Versioned registry of Google Ads policy and behavior assumptions used across notfair ads skills. Each entry tracks a specific assumption, its volatility, verification source, and when it should be re-verified.","last_full_review": "2026-04-04","entries": [{diff --git a/google-ads/shared/preamble.md b/google-ads/shared/preamble.mdindex 76738b9f..87e2d688 100644--- a/google-ads/shared/preamble.md+++ b/google-ads/shared/preamble.md@@ -2,17 +2,17 @@Every google-ads skill reads this before doing anything else. It handles updates, MCP detection, config resolution, and onboarding in one place — so individual skills don't repeat this logic.-## Step 0: Check for toprank updates+## Step 0: Check for NotFair updates```bash-_UPD_BIN=$(ls ~/.claude/plugins/cache/nowork-studio/toprank/*/bin/toprank-update-check 2>/dev/null | head -1)+_UPD_BIN=$(ls ~/.claude/plugins/cache/nowork-studio/notfair/*/bin/notfair-update-check 2>/dev/null | head -1)[ -n "$_UPD_BIN" ] && _UPD=$("$_UPD_BIN" 2>/dev/null || true) || _UPD=""[ -n "$_UPD" ] && echo "$_UPD" || true```-If the output contains `UPGRADE_AVAILABLE <old> <new>`: immediately follow the inline upgrade flow in the `/toprank-upgrade` skill (Step 1 onward) to auto-upgrade. After the upgrade completes, re-read the updated preamble from the new plugin cache and restart from Step 1 (the upgrade check itself doesn't need to run again).+If the output contains `UPGRADE_AVAILABLE <old> <new>`: immediately follow the inline upgrade flow in the `/notfair:upgrade` skill (Step 1 onward) to auto-upgrade. After the upgrade completes, re-read the updated preamble from the new plugin cache and restart from Step 1 (the upgrade check itself doesn't need to run again).-If the output contains `JUST_UPGRADED <old> <new>`: mention "toprank upgraded from v{old} to v{new}" briefly, then continue to Step 1.+If the output contains `JUST_UPGRADED <old> <new>`: mention "NotFair upgraded from v{old} to v{new}" briefly, then continue to Step 1.If neither: continue to Step 1 silently.@@ -46,7 +46,7 @@ Continue to Step 2 (MCP detection always runs).Always verify that a Google Ads MCP server is available — the MCP server could be down, unauthorized, or misconfigured even with a saved accountId.1. Check for NotFair tools. The MCP server may be exposed under several different tool-name prefixes depending on the host (across the NotFair → NotFair-GoogleAds namespace split, multiple prefixes may briefly coexist):- - `mcp__NotFair-GoogleAds__*` / `mcp__notfair_googleads__*` / `mcp__NotFair_GoogleAds__*` — Claude Code CLI (toprank plugin default, current; exact form depends on Claude Code's key sanitization)+ - `mcp__NotFair-GoogleAds__*` / `mcp__notfair_googleads__*` / `mcp__NotFair_GoogleAds__*` — Claude Code CLI (NotFair plugin default, current; exact form depends on Claude Code's key sanitization)- `mcp__claude_ai_NotFairGoogleAds__*` — Claude Desktop / claude.ai plugin connector (current)- `mcp__notfair__*` / `mcp__claude_ai_NotFair__*` — pre-0.16.0 plugin (legacy NotFair prefix, before the GoogleAds namespace split)- any other prefix matching `mcp__.*[Nn]ot[Ff]air.*__` (future hosts)diff --git a/install/README.md b/install/README.mdindex f80e21de..16b28ff9 100644--- a/install/README.md+++ b/install/README.md@@ -1,10 +1,10 @@# Per-host install adapters-This directory is the home for **thin install adapters** that wire Toprank into a specific AI agent host. Each adapter registers the *same* host-agnostic skills (under `seo/`, `google-ads/`, `meta-ads/`, `gemini/` at the repo root) into the host's expected layout.+This directory is the home for **thin install adapters** that wire NotFair into a specific AI agent host. Each adapter registers the *same* host-agnostic skills (under `seo/`, `google-ads/`, `meta-ads/`, `gemini/` at the repo root) into the host's expected layout.## Why this exists-Toprank ships one source of truth for skills. Different agent hosts expect skills in different places:+NotFair ships one source of truth for skills. Different agent hosts expect skills in different places:- **Claude Code** — reads `.claude-plugin/plugin.json` directly from the repo. No adapter needed; the manifest at the repo root *is* the adapter.- **OpenClaw** — expects skills under `~/.openclaw/skills/`. The adapter lives at `../openclaw/install/install.sh` (kept there for back-compat). Future relocations will preserve a stub here.@@ -26,15 +26,15 @@ Toprank ships one source of truth for skills. Different agent hosts expect skillIf your adapter writes into a file the user also edits (their workspace `AGENTS.md`, `CLAUDE.md`, host config, etc.), wrap inserted content like this:```-<!-- toprank:managed -->+<!-- notfair:managed -->... auto-generated rows ...-<!-- /toprank:managed -->+<!-- /notfair:managed -->```-Re-running the installer rewrites only inside the fence. Anything the user wrote outside is preserved. This is what makes `toprank-upgrade` safe across hosts where users have hand-customized their config.+Re-running the installer rewrites only inside the fence. Anything the user wrote outside is preserved. This is what makes `/notfair:upgrade` safe across hosts where users have hand-customized their config.## What not to put here- **Skill source code.** Skills belong in `seo/`, `google-ads/`, `meta-ads/`, `gemini/`. Adapters point at them; adapters do not own them.- **Host-specific orchestrators.** Those go alongside the host (e.g., `openclaw/skills/`), not under `install/`.-- **Runtime state.** Use `~/.toprank/<host>/` or the host's standard runtime directory.+- **Runtime state.** Use `~/.toprank/<host>/` (path retained from the toprank → notfair rename; see CHANGELOG 0.24.0) or the host's standard runtime directory.diff --git a/meta-ads/shared/policy-registry.json b/meta-ads/shared/policy-registry.jsonindex 652e78df..040ee7ef 100644--- a/meta-ads/shared/policy-registry.json+++ b/meta-ads/shared/policy-registry.json@@ -1,6 +1,6 @@{"$schema": "policy-registry/v1",- "description": "Versioned registry of Meta Ads (Facebook + Instagram) policy and behavior assumptions used across toprank meta-ads skills. Each entry tracks a specific assumption, its volatility, verification source, and when it should be re-verified.",+ "description": "Versioned registry of Meta Ads (Facebook + Instagram) policy and behavior assumptions used across notfair meta-ads skills. Each entry tracks a specific assumption, its volatility, verification source, and when it should be re-verified.","last_full_review": "2026-05-01","entries": [{@@ -22,7 +22,7 @@"last_verified": "2026-05-01","source": "Meta Business Help","source_url": "https://www.facebook.com/business/help/235811013522940",- "notes": "Meta surfaces both 'clicks (all)' and 'inline_link_clicks'. Toprank skills always use link clicks for CTR/CPC because all-clicks include profile/like/see-more clicks that aren't optimization-relevant.",+ "notes": "Meta surfaces both 'clicks (all)' and 'inline_link_clicks'. NotFair skills always use link clicks for CTR/CPC because all-clicks include profile/like/see-more clicks that aren't optimization-relevant.","stale_after_days": 365},{diff --git a/meta-ads/shared/preamble.md b/meta-ads/shared/preamble.mdindex 713489cd..18ab1eb2 100644--- a/meta-ads/shared/preamble.md+++ b/meta-ads/shared/preamble.md@@ -2,17 +2,17 @@Every meta-ads skill reads this before doing anything else. Handles update checks, MCP detection, config resolution, and onboarding so individual skills don't repeat this logic.-## Step 0: Check for toprank updates+## Step 0: Check for NotFair updates```bash-_UPD_BIN=$(ls ~/.claude/plugins/cache/nowork-studio/toprank/*/bin/toprank-update-check 2>/dev/null | head -1)+_UPD_BIN=$(ls ~/.claude/plugins/cache/nowork-studio/notfair/*/bin/notfair-update-check 2>/dev/null | head -1)[ -n "$_UPD_BIN" ] && _UPD=$("$_UPD_BIN" 2>/dev/null || true) || _UPD=""[ -n "$_UPD" ] && echo "$_UPD" || true```-If the output contains `UPGRADE_AVAILABLE <old> <new>`: immediately follow the inline upgrade flow in the `/toprank-upgrade` skill (Step 1 onward) to auto-upgrade. After the upgrade completes, re-read the updated preamble from the new plugin cache and restart from Step 1.+If the output contains `UPGRADE_AVAILABLE <old> <new>`: immediately follow the inline upgrade flow in the `/notfair:upgrade` skill (Step 1 onward) to auto-upgrade. After the upgrade completes, re-read the updated preamble from the new plugin cache and restart from Step 1.-If the output contains `JUST_UPGRADED <old> <new>`: mention "toprank upgraded from v{old} to v{new}" briefly, then continue to Step 1.+If the output contains `JUST_UPGRADED <old> <new>`: mention "NotFair upgraded from v{old} to v{new}" briefly, then continue to Step 1.If neither: continue to Step 1 silently.@@ -57,21 +57,21 @@ Continue to Step 2 (MCP detection always runs).Always verify that a Meta Ads MCP server is available — the MCP server could be down, unauthorized, or misconfigured even with a saved `metaAccountId`.1. Check for the NotFair Meta tools. The MCP server may be exposed under several different tool-name prefixes depending on the host:- - `mcp__NotFair-MetaAds__*` / `mcp__notfair_metaads__*` / `mcp__NotFair_MetaAds__*` — Claude Code CLI (toprank plugin default; exact form depends on Claude Code's key sanitization)+ - `mcp__NotFair-MetaAds__*` / `mcp__notfair_metaads__*` / `mcp__NotFair_MetaAds__*` — Claude Code CLI (NotFair plugin default; exact form depends on Claude Code's key sanitization)- `mcp__claude_ai_NotFair-MetaAds__*` / `mcp__claude_ai_NotFairMetaAds__*` — Claude Desktop / claude.ai plugin connector- any other prefix matching `mcp__.*([Nn]ot[Ff]air[-_]?[Mm]eta[Aa]ds?)__` (future hosts)**How to detect:** scan your available tool list for any tool whose name ends in `listAdAccounts` AND whose prefix references Meta (matches the regex above — do not pick a generic `listAdAccounts` from another platform's MCP). Take everything before `listAdAccounts` as the detected prefix. Save the prefix and the result for reuse in Steps 3 and 4.-2. If no NotFair-MetaAds variant exists, check for Meta's official MCP or community Meta MCP servers (any `mcp__.*meta.*ads__listAdAccounts`). If you find one, fall back to it but warn the user that toprank's heuristics are tuned for the NotFair surface (specifically `runScript`'s `ads.graphParallel`).+2. If no NotFair-MetaAds variant exists, check for Meta's official MCP or community Meta MCP servers (any `mcp__.*meta.*ads__listAdAccounts`). If you find one, fall back to it but warn the user that NotFair's heuristics are tuned for the NotFair MCP surface (specifically `runScript`'s `ads.graphParallel`).3. If none exists, guide the user:> No Meta Ads MCP server detected.>-> The toprank plugin registers the `NotFair-MetaAds` HTTP MCP server (`https://notfair.co/api/mcp/meta_ads`) in `.mcp.json`. Try restarting Claude Code — on first connection it opens a browser tab for OAuth sign-in to NotFair. You can also trigger sign-in manually with `/mcp`.+> The NotFair plugin registers the `NotFair-MetaAds` HTTP MCP server (`https://notfair.co/api/mcp/meta_ads`) in `.mcp.json`. Try restarting Claude Code — on first connection it opens a browser tab for OAuth sign-in to NotFair. You can also trigger sign-in manually with `/mcp`.>-> If the problem persists, run `/toprank-upgrade` to make sure your plugin includes the Meta server registration, or configure a Meta Ads MCP server manually.+> If the problem persists, run `/notfair:upgrade` to make sure your NotFair plugin includes the Meta server registration, or configure a Meta Ads MCP server manually.Stop here until the MCP server is available.diff --git a/toprank-upgrade-skill/SKILL.md b/notfair-upgrade-skill/SKILL.mdsimilarity index 75%rename from toprank-upgrade-skill/SKILL.mdrename to notfair-upgrade-skill/SKILL.mdindex 18c96222..899499fd 100644--- a/toprank-upgrade-skill/SKILL.md+++ b/notfair-upgrade-skill/SKILL.md@@ -1,10 +1,10 @@----name: toprank-upgrade-argument-hint: "<or just run '/toprank-upgrade'>"+name: upgrade+argument-hint: "<or just run '/notfair:upgrade'>"description: >- Upgrade toprank plugin to the latest version. Updates the marketplace repo,+ Upgrade the NotFair plugin to the latest version. Updates the marketplace repo,installs the new version to the plugin cache, and updates installed_plugins.json.- Use when asked to "upgrade toprank", "update toprank", or "get latest version".+ Use when asked to "upgrade notfair", "update notfair", or "get latest version".Also handles inline upgrade prompts when a skill detects UPGRADE_AVAILABLE at startup.allowed-tools:- Bash@@ -12,18 +12,18 @@ allowed-tools:- AskUserQuestion----# /toprank-upgrade+# /notfair:upgrade-Upgrade the toprank plugin to the latest version and show what's new.+Upgrade the NotFair plugin to the latest version and show what's new.## Key paths| What | Path ||------|------|| Marketplace repo | `~/.claude/plugins/marketplaces/nowork-studio/` |-| Plugin cache | `~/.claude/plugins/cache/nowork-studio/toprank/<version>/` |+| Plugin cache | `~/.claude/plugins/cache/nowork-studio/notfair/<version>/` || Installed plugins | `~/.claude/plugins/installed_plugins.json` |-| Update state | `~/.toprank/` |+| Update state | `~/.toprank/` (intentionally preserved — see CHANGELOG 0.24.0) |---@@ -33,7 +33,7 @@ This section is used when a skill preamble outputs `UPGRADE_AVAILABLE`.### Step 1: Auto-upgrade-Log "Upgrading toprank v{old} → v{new}..." and proceed to Step 2.+Log "Upgrading NotFair v{old} → v{new}..." and proceed to Step 2.---@@ -43,9 +43,9 @@ First check for dev symlink (see "Dev symlink detection" section). If detected,```bash# Find the currently installed plugin path-INSTALLED_DIR=$(ls -d ~/.claude/plugins/cache/nowork-studio/toprank/*/ 2>/dev/null | grep -v '.bak' | head -1)+INSTALLED_DIR=$(ls -d ~/.claude/plugins/cache/nowork-studio/notfair/*/ 2>/dev/null | grep -v '.bak' | head -1)if [ -z "$INSTALLED_DIR" ]; then- echo "ERROR: toprank plugin not found in cache"; exit 1+ echo "ERROR: NotFair plugin not found in cache"; exit 1fiMARKETPLACE_DIR="$HOME/.claude/plugins/marketplaces/nowork-studio"if [ ! -d "$MARKETPLACE_DIR/.git" ]; then@@ -71,7 +71,7 @@ NEW_VERSION=$(cat VERSION | tr -d '[:space:]')GIT_SHA=$(git rev-parse HEAD)# Create new versioned cache directory-NEW_CACHE_DIR="$HOME/.claude/plugins/cache/nowork-studio/toprank/$NEW_VERSION"+NEW_CACHE_DIR="$HOME/.claude/plugins/cache/nowork-studio/notfair/$NEW_VERSION"if [ -d "$NEW_CACHE_DIR" ]; thenrm -rf "$NEW_CACHE_DIR"fi@@ -81,11 +81,11 @@ mkdir -p "$NEW_CACHE_DIR"rsync -a --exclude='.git' "$MARKETPLACE_DIR/" "$NEW_CACHE_DIR/"```-If the copy fails, warn: "Upgrade failed — the old version is still active. Run `/toprank-upgrade` manually." and stop.+If the copy fails, warn: "Upgrade failed — the old version is still active. Run `/notfair:upgrade` manually." and stop.### Step 5: Update installed_plugins.json-Read `~/.claude/plugins/installed_plugins.json`, then update the `toprank@nowork-studio` entry:+Read `~/.claude/plugins/installed_plugins.json`, then update the `notfair@nowork-studio` entry:```bashpython3 -c "@@ -96,18 +96,18 @@ path = os.path.expanduser('~/.claude/plugins/installed_plugins.json')with open(path) as f:data = json.load(f)-data['plugins']['toprank@nowork-studio'] = [{+data['plugins']['notfair@nowork-studio'] = [{'scope': 'user',- 'installPath': os.path.expanduser('~/.claude/plugins/cache/nowork-studio/toprank/$NEW_VERSION'),+ 'installPath': os.path.expanduser('~/.claude/plugins/cache/nowork-studio/notfair/$NEW_VERSION'),'version': '$NEW_VERSION',- 'installedAt': data['plugins'].get('toprank@nowork-studio', [{}])[0].get('installedAt', datetime.now(timezone.utc).isoformat()),+ 'installedAt': data['plugins'].get('notfair@nowork-studio', [{}])[0].get('installedAt', datetime.now(timezone.utc).isoformat()),'lastUpdated': datetime.now(timezone.utc).isoformat(),'gitCommitSha': '$GIT_SHA'}]with open(path, 'w') as f:json.dump(data, f, indent=4)-print('Updated installed_plugins.json: toprank@nowork-studio -> v$NEW_VERSION')+print('Updated installed_plugins.json: notfair@nowork-studio -> v$NEW_VERSION')"```@@ -116,7 +116,7 @@ print('Updated installed_plugins.json: toprank@nowork-studio -> v$NEW_VERSION')Remove old versioned cache directories (keep only the new one). Never remove a `dev` symlink:```bash-for dir in ~/.claude/plugins/cache/nowork-studio/toprank/*/; do+for dir in ~/.claude/plugins/cache/nowork-studio/notfair/*/; dover=$(basename "$dir")if [ "$ver" != "$NEW_VERSION" ] && [ "$ver" != "dev" ]; thenrm -rf "$dir"@@ -140,7 +140,7 @@ Read `$NEW_CACHE_DIR/CHANGELOG.md`. Find all version entries between the old verFormat:```-toprank v{new} — upgraded from v{old}!+NotFair v{new} — upgraded from v{old}!What's new:- [bullet 1]@@ -161,25 +161,25 @@ After showing What's New, continue with whatever skill the user originally invokBefore upgrading, check if the installed cache directory is a symlink named `dev`:```bash-CACHE_DIR=$(ls -d ~/.claude/plugins/cache/nowork-studio/toprank/*/ 2>/dev/null | head -1)+CACHE_DIR=$(ls -d ~/.claude/plugins/cache/nowork-studio/notfair/*/ 2>/dev/null | head -1)if [ -L "${CACHE_DIR%/}" ] && [ "$(basename "$CACHE_DIR")" = "dev" ]; thenecho "DEV_SYMLINK"fi```-If `DEV_SYMLINK`: tell the user "toprank is installed as a dev symlink — it always points to your local source (v$(cat "$CACHE_DIR/VERSION" 2>/dev/null | tr -d '[:space:]')). No upgrade needed." and **stop**. Do not proceed with Steps 2–8.+If `DEV_SYMLINK`: tell the user "NotFair is installed as a dev symlink — it always points to your local source (v$(cat "$CACHE_DIR/VERSION" 2>/dev/null | tr -d '[:space:]')). No upgrade needed." and **stop**. Do not proceed with Steps 2–8.---## Standalone usage-When invoked directly as `/toprank-upgrade`:+When invoked directly as `/notfair:upgrade`:1. Check for dev symlink (see "Dev symlink detection" above). If detected, stop.2. Force a fresh update check (bypass cache and snooze):```bash-_UPD_BIN=$(ls ~/.claude/plugins/cache/nowork-studio/toprank/*/bin/toprank-update-check 2>/dev/null | head -1)+_UPD_BIN=$(ls ~/.claude/plugins/cache/nowork-studio/notfair/*/bin/notfair-update-check 2>/dev/null | head -1)[ -n "$_UPD_BIN" ] && _UPD=$("$_UPD_BIN" --force 2>/dev/null || true) || _UPD=""echo "$_UPD"```diff --git a/toprank-upgrade-skill/evals/evals.json b/notfair-upgrade-skill/evals/evals.jsonsimilarity index 90%rename from toprank-upgrade-skill/evals/evals.jsonrename to notfair-upgrade-skill/evals/evals.jsonindex ca0cbb89..d146e6bf 100644--- a/toprank-upgrade-skill/evals/evals.json+++ b/notfair-upgrade-skill/evals/evals.json@@ -1,9 +1,9 @@{- "skill_name": "toprank-upgrade",+ "skill_name": "upgrade","evals": [{"id": 1,- "prompt": "Upgrade toprank to the latest version.",+ "prompt": "Upgrade notfair to the latest version.","expected_output": "The skill should detect the install type (global-git, local-git, or vendored), save the current version, run the appropriate upgrade command, and show a What's New summary from the CHANGELOG.","files": [],"expectations": [@@ -16,7 +16,7 @@},{"id": 2,- "prompt": "Is toprank up to date?",+ "prompt": "Is notfair up to date?","expected_output": "The skill should run a forced update check and report whether the user is on the latest version. If already up to date, it should confirm with the current version number. If an update is available, it should offer to upgrade.","files": [],"expectations": [diff --git a/openclaw/README.md b/openclaw/README.mdindex 37dea4ff..217fe967 100644--- a/openclaw/README.md+++ b/openclaw/README.md@@ -1,6 +1,6 @@-# OpenClaw surface for Toprank+# OpenClaw surface for NotFair-Toprank + OpenClaw is now a **closed-loop SEO operator**.+NotFair + OpenClaw is now a **closed-loop SEO operator**.It does not just run one-off audits. It can now:- pull real SEO signals from Google Search Console,@@ -12,7 +12,7 @@ It does not just run one-off audits. It can now:- update learned priors,- and keep going.-This directory adds that multi-site adaptive layer for OpenClaw **without replacing the existing Toprank skills**.+This directory adds that multi-site adaptive layer for OpenClaw **without replacing the existing NotFair skills**.## The new power@@ -62,7 +62,7 @@ export TOPRANK_OPENCLAW_HOME=/custom/path## Install-Run from the Toprank repo root:+Run from the NotFair repo root:```bash./openclaw/install/install.sh@@ -80,7 +80,7 @@ Why copy instead of symlink wrapper skills directly? OpenClaw skill discovery inVerify:```bash-openclaw skills check | grep -i toprank+openclaw skills check | grep -i notfairpython3 -m pytest -q openclaw/tests```@@ -89,15 +89,15 @@ python3 -m pytest -q openclaw/testsUse this as the setup prompt for a fresh machine or a new OpenClaw instance. Replace the placeholders before pasting.```text-Set up the Toprank OpenClaw SEO Operator on this machine.+Set up the NotFair OpenClaw SEO Operator on this machine.Repo:-- If the Toprank repo already exists locally, use it; do not reclone.-- Otherwise clone https://github.com/nowork-studio/toprank and cd into the repo root.+- If the NotFair repo already exists locally, use it; do not reclone.+- Otherwise clone https://github.com/nowork-studio/notfair and cd into the repo root.Install:1. Run: ./openclaw/install/install.sh-2. Verify Toprank skills are discoverable: openclaw skills check | grep -i toprank+2. Verify NotFair skills are discoverable: openclaw skills check | grep -i notfair3. Run tests: python3 -m pytest -q openclaw/testsSites:@@ -120,7 +120,7 @@ Smoke test:2. Run one weekly review:TOPRANK_OPENCLAW_HOME="$HOME/.toprank/openclaw" python3 openclaw/bin/weekly_review.py "<site_id_1>"3. Confirm the review wrote audit.json, action-plan.json, and verification.json under ~/.toprank/openclaw/sites/<site_id>/runs/.-4. Confirm openclaw cron list shows Toprank OpenClaw Scheduler and one Toprank Weekly Review job per active site.+4. Confirm openclaw cron list shows NotFair OpenClaw Scheduler and one NotFair Weekly Review job per active site.Policy:- This is an SEO operator loop, not an auto-publisher.@@ -157,7 +157,7 @@ That creates:## Why this matters-Before this layer, Toprank had strong point skills.+Before this layer, NotFair had strong point skills.Now it has memory and recurrence:- **real signal ingestion** via GSC analysis,@@ -192,11 +192,11 @@ Use these example payloads and flows as templates:## Wrapper skills-- `toprank-site-onboard` — register a site and initialize its work folder-- `toprank-portfolio-review` — rank all active sites by urgency/opportunity-- `toprank-weekly-review` — review one site and propose the next best action-- `toprank-improve-page` — improve one URL on a site-- `toprank-investigate-drop` — traffic-drop recovery workflow+- `notfair-site-onboard` — register a site and initialize its work folder+- `notfair-portfolio-review` — rank all active sites by urgency/opportunity+- `notfair-weekly-review` — review one site and propose the next best action+- `notfair-improve-page` — improve one URL on a site+- `notfair-investigate-drop` — traffic-drop recovery workflow## Autonomous loop building blocks@@ -268,8 +268,8 @@ Install it with OpenClaw cron:The OpenClaw cron installer creates:-- `Toprank OpenClaw Scheduler` — hourly follow-up processor-- `Toprank Weekly Review — <site>` — one weekly review per active portfolio site+- `NotFair OpenClaw Scheduler` — hourly follow-up processor+- `NotFair Weekly Review — <site>` — one weekly review per active portfolio siteIt intentionally does not set a model by default. If you want a model override, pass `--model <provider/model>` only after confirming the local OpenClaw model allowlist accepts it.@@ -281,10 +281,10 @@ macOS `launchd` is still available as a lower-level alternative:./openclaw/install/install-launchd.sh```-Or use the system cron example at `openclaw/install/toprank-openclaw.cron.example`.+Or use the system cron example at `openclaw/install/notfair-openclaw.cron.example`.This is now the core of a real autonomous operator loop.## Design principle-The OpenClaw surface is an **adapter layer**. The existing Toprank skill folders remain canonical. The OpenClaw wrappers add persistent state, portfolio awareness, artifact writing, and policy gates.+The OpenClaw surface is an **adapter layer**. The existing NotFair skill folders remain canonical. The OpenClaw wrappers add persistent state, portfolio awareness, artifact writing, and policy gates.diff --git a/openclaw/artifacts/schemas/action-plan.schema.json b/openclaw/artifacts/schemas/action-plan.schema.jsonindex 12d3e936..9c15642a 100644--- a/openclaw/artifacts/schemas/action-plan.schema.json+++ b/openclaw/artifacts/schemas/action-plan.schema.json@@ -1,6 +1,6 @@{"$schema": "https://json-schema.org/draft/2020-12/schema",- "title": "Toprank OpenClaw Action Plan",+ "title": "NotFair OpenClaw Action Plan","type": "object","properties": {"site_id": {diff --git a/openclaw/artifacts/schemas/audit.schema.json b/openclaw/artifacts/schemas/audit.schema.jsonindex f632f9d5..8cf10ebf 100644--- a/openclaw/artifacts/schemas/audit.schema.json+++ b/openclaw/artifacts/schemas/audit.schema.json@@ -1,6 +1,6 @@{"$schema": "https://json-schema.org/draft/2020-12/schema",- "title": "Toprank OpenClaw Audit",+ "title": "NotFair OpenClaw Audit","type": "object","properties": {"site_id": {diff --git a/openclaw/artifacts/schemas/business-context.schema.json b/openclaw/artifacts/schemas/business-context.schema.jsonindex a8584e1e..92634278 100644--- a/openclaw/artifacts/schemas/business-context.schema.json+++ b/openclaw/artifacts/schemas/business-context.schema.json@@ -1,6 +1,6 @@{"$schema": "https://json-schema.org/draft/2020-12/schema",- "title": "Toprank OpenClaw Business Impact Context",+ "title": "NotFair OpenClaw Business Impact Context","type": "object","properties": {"site_id": { "type": "string" },diff --git a/openclaw/artifacts/schemas/feedback.schema.json b/openclaw/artifacts/schemas/feedback.schema.jsonindex 6293ded5..9797956c 100644--- a/openclaw/artifacts/schemas/feedback.schema.json+++ b/openclaw/artifacts/schemas/feedback.schema.json@@ -1,6 +1,6 @@{"$schema": "https://json-schema.org/draft/2020-12/schema",- "title": "Toprank OpenClaw Feedback",+ "title": "NotFair OpenClaw Feedback","type": "object","properties": {"site_id": {diff --git a/openclaw/artifacts/schemas/goal.schema.json b/openclaw/artifacts/schemas/goal.schema.jsonindex c7c9c52d..affb59f4 100644--- a/openclaw/artifacts/schemas/goal.schema.json+++ b/openclaw/artifacts/schemas/goal.schema.json@@ -1,6 +1,6 @@{"$schema": "https://json-schema.org/draft/2020-12/schema",- "title": "Toprank OpenClaw Goal",+ "title": "NotFair OpenClaw Goal","type": "object","properties": {"goal_id": {diff --git a/openclaw/artifacts/schemas/learning-log.schema.json b/openclaw/artifacts/schemas/learning-log.schema.jsonindex 002370c1..09efe36e 100644--- a/openclaw/artifacts/schemas/learning-log.schema.json+++ b/openclaw/artifacts/schemas/learning-log.schema.json@@ -1,6 +1,6 @@{"$schema": "https://json-schema.org/draft/2020-12/schema",- "title": "Toprank OpenClaw Learning Log",+ "title": "NotFair OpenClaw Learning Log","type": "object","properties": {"site_id": {diff --git a/openclaw/artifacts/schemas/patch-set.schema.json b/openclaw/artifacts/schemas/patch-set.schema.jsonindex 4ee8e3f2..74a5e229 100644--- a/openclaw/artifacts/schemas/patch-set.schema.json+++ b/openclaw/artifacts/schemas/patch-set.schema.json@@ -1,6 +1,6 @@{"$schema": "https://json-schema.org/draft/2020-12/schema",- "title": "Toprank OpenClaw Patch Set",+ "title": "NotFair OpenClaw Patch Set","type": "object","properties": {"site_id": {diff --git a/openclaw/artifacts/schemas/portfolio.schema.json b/openclaw/artifacts/schemas/portfolio.schema.jsonindex e90cee94..66436c36 100644--- a/openclaw/artifacts/schemas/portfolio.schema.json+++ b/openclaw/artifacts/schemas/portfolio.schema.json@@ -1,6 +1,6 @@{"$schema": "https://json-schema.org/draft/2020-12/schema",- "title": "Toprank OpenClaw Portfolio",+ "title": "NotFair OpenClaw Portfolio","type": "object","properties": {"schema_version": {diff --git a/openclaw/artifacts/schemas/proposal.schema.json b/openclaw/artifacts/schemas/proposal.schema.jsonindex 9ac89b1c..6412db48 100644--- a/openclaw/artifacts/schemas/proposal.schema.json+++ b/openclaw/artifacts/schemas/proposal.schema.json@@ -1,6 +1,6 @@{"$schema": "https://json-schema.org/draft/2020-12/schema",- "title": "Toprank OpenClaw Proposal",+ "title": "NotFair OpenClaw Proposal","type": "object","properties": {"site_id": {diff --git a/openclaw/artifacts/schemas/queue-item.schema.json b/openclaw/artifacts/schemas/queue-item.schema.jsonindex be105ac9..48d3f697 100644--- a/openclaw/artifacts/schemas/queue-item.schema.json+++ b/openclaw/artifacts/schemas/queue-item.schema.json@@ -1,6 +1,6 @@{"$schema": "https://json-schema.org/draft/2020-12/schema",- "title": "Toprank OpenClaw Queue Item",+ "title": "NotFair OpenClaw Queue Item","type": "object","properties": {"item_id": {diff --git a/openclaw/artifacts/schemas/site-profile.schema.json b/openclaw/artifacts/schemas/site-profile.schema.jsonindex 07a5bd41..cf039a2c 100644--- a/openclaw/artifacts/schemas/site-profile.schema.json+++ b/openclaw/artifacts/schemas/site-profile.schema.json@@ -1,6 +1,6 @@{"$schema": "https://json-schema.org/draft/2020-12/schema",- "title": "Toprank OpenClaw Site Profile",+ "title": "NotFair OpenClaw Site Profile","type": "object","properties": {"schema_version": {diff --git a/openclaw/artifacts/schemas/state-snapshot.schema.json b/openclaw/artifacts/schemas/state-snapshot.schema.jsonindex 301623e2..95a9a3c9 100644--- a/openclaw/artifacts/schemas/state-snapshot.schema.json+++ b/openclaw/artifacts/schemas/state-snapshot.schema.json@@ -1,6 +1,6 @@{"$schema": "https://json-schema.org/draft/2020-12/schema",- "title": "Toprank OpenClaw State Snapshot",+ "title": "NotFair OpenClaw State Snapshot","type": "object","properties": {"site_id": {diff --git a/openclaw/artifacts/schemas/verification.schema.json b/openclaw/artifacts/schemas/verification.schema.jsonindex 951711cc..13d124d5 100644--- a/openclaw/artifacts/schemas/verification.schema.json+++ b/openclaw/artifacts/schemas/verification.schema.json@@ -1,6 +1,6 @@{"$schema": "https://json-schema.org/draft/2020-12/schema",- "title": "Toprank OpenClaw Verification",+ "title": "NotFair OpenClaw Verification","type": "object","properties": {"site_id": {diff --git a/openclaw/bin/bootstrap_site.py b/openclaw/bin/bootstrap_site.pyindex 349237c4..23fcda49 100755--- a/openclaw/bin/bootstrap_site.py+++ b/openclaw/bin/bootstrap_site.py@@ -1,5 +1,5 @@#!/usr/bin/env python3-"""Initialize a per-site work folder inside the Toprank OpenClaw runtime workspace."""+"""Initialize a per-site work folder inside the NotFair OpenClaw runtime workspace."""from __future__ import annotationsdiff --git a/openclaw/bin/bootstrap_workspace.py b/openclaw/bin/bootstrap_workspace.pyindex 7d4e0237..4cd1f4f1 100755--- a/openclaw/bin/bootstrap_workspace.py+++ b/openclaw/bin/bootstrap_workspace.py@@ -1,5 +1,5 @@#!/usr/bin/env python3-"""Create the Toprank OpenClaw runtime workspace if it does not exist."""+"""Create the NotFair OpenClaw runtime workspace if it does not exist."""from __future__ import annotationsdiff --git a/openclaw/bin/followups_due.py b/openclaw/bin/followups_due.pyindex 22c4944e..e7039b39 100755--- a/openclaw/bin/followups_due.py+++ b/openclaw/bin/followups_due.py@@ -1,5 +1,5 @@#!/usr/bin/env python3-"""List due or upcoming follow-up items from the Toprank OpenClaw schedule."""+"""List due or upcoming follow-up items from the NotFair OpenClaw schedule."""from __future__ import annotationsdiff --git a/openclaw/bin/hydrate_followup_gsc.py b/openclaw/bin/hydrate_followup_gsc.pyindex 6d7bb22e..5538b9fb 100755--- a/openclaw/bin/hydrate_followup_gsc.py+++ b/openclaw/bin/hydrate_followup_gsc.py@@ -81,7 +81,7 @@ def main(argv: list[str]) -> int:if args.analysis_file:data = json.loads(Path(args.analysis_file).read_text())else:- with tempfile.NamedTemporaryFile(prefix="toprank_gsc_", suffix=".json", delete=False) as tmp:+ with tempfile.NamedTemporaryFile(prefix="notfair_gsc_", suffix=".json", delete=False) as tmp:output_path = Path(tmp.name)cmd = [sys.executable, str(ANALYZE_GSC), "--site", gsc_property, "--days", str(days), "--output", str(output_path)]diff --git a/openclaw/bin/onboard_site.py b/openclaw/bin/onboard_site.pyindex b7f154fc..ea6270f6 100755--- a/openclaw/bin/onboard_site.py+++ b/openclaw/bin/onboard_site.py@@ -1,5 +1,5 @@#!/usr/bin/env python3-"""Register or update a site in the Toprank OpenClaw portfolio."""+"""Register or update a site in the NotFair OpenClaw portfolio."""from __future__ import annotationsdiff --git a/openclaw/bin/portfolio_review.py b/openclaw/bin/portfolio_review.pyindex 381726c8..9591aba6 100755--- a/openclaw/bin/portfolio_review.py+++ b/openclaw/bin/portfolio_review.py@@ -1,5 +1,5 @@#!/usr/bin/env python3-"""Rank active sites in the Toprank OpenClaw portfolio by urgency and upside."""+"""Rank active sites in the NotFair OpenClaw portfolio by urgency and upside."""from __future__ import annotationsdiff --git a/openclaw/bin/publish_pending.py b/openclaw/bin/publish_pending.pyindex 066b1a51..b1c838f8 100755--- a/openclaw/bin/publish_pending.py+++ b/openclaw/bin/publish_pending.py@@ -105,7 +105,7 @@ def build_payload(entry: dict, body: str) -> dict[str, Any]:"inlineImages": entry.get("inlineImages") or [],"structuredData": entry.get("structuredData"),"scheduledAt": entry.get("scheduledDate"),- "source": {"tool": "toprank", "skill": "content-planner", "version": "1"},+ "source": {"tool": "notfair", "skill": "content-planner", "version": "1"},}@@ -122,7 +122,7 @@ def post_to_webhook("Content-Type": "application/json","Accept": "application/json","Authorization": f"Bearer {token}",- "User-Agent": "toprank-publisher/1",+ "User-Agent": "notfair-publisher/1",},)try:diff --git a/openclaw/bin/run_scheduler.py b/openclaw/bin/run_scheduler.pyindex 644f6ba5..1770bdaf 100755--- a/openclaw/bin/run_scheduler.py+++ b/openclaw/bin/run_scheduler.py@@ -1,5 +1,5 @@#!/usr/bin/env python3-"""Process due items from the Toprank OpenClaw schedule."""+"""Process due items from the NotFair OpenClaw schedule."""from __future__ import annotationsdiff --git a/openclaw/bin/runtime.py b/openclaw/bin/runtime.pyindex a893c5df..68835340 100755--- a/openclaw/bin/runtime.py+++ b/openclaw/bin/runtime.py@@ -1,5 +1,5 @@#!/usr/bin/env python3-"""Shared helpers for the Toprank OpenClaw runtime workspace."""+"""Shared helpers for the NotFair OpenClaw runtime workspace."""from __future__ import annotationsdiff --git a/openclaw/bin/weekly_review.py b/openclaw/bin/weekly_review.pyindex f8403039..9b6b2eb9 100755--- a/openclaw/bin/weekly_review.py+++ b/openclaw/bin/weekly_review.py@@ -811,7 +811,7 @@ def cannibalization_issue(cannibal: dict[str, Any], brand_terms: list[str] | Nondef technical_consistency_findings(data: dict[str, Any]) -> list[dict[str, Any]]:"""Extract index/sitemap/canonical/link findings from analyzer or crawler output.- Toprank does not assume one crawler schema. Site-specific analyzers can pass a+ NotFair does not assume one crawler schema. Site-specific analyzers can pass acompact `index_sitemap_consistency` block, or nest the same block under`technical_seo` / `technical_audit`."""@@ -1087,7 +1087,7 @@ class PageSnapshotParser(HTMLParser):def live_fetch_headers(site_profile: dict[str, Any] | None = None) -> dict[str, str]:headers = {- "User-Agent": "Mozilla/5.0 (compatible; ToprankOpenClawSEOOperator/1.0; +https://openclaw.ai)",+ "User-Agent": "Mozilla/5.0 (compatible; NotFairOpenClawSEOOperator/1.0; +https://openclaw.ai)","Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",}profile = site_profile or {}@@ -2337,7 +2337,7 @@ def build_payload(def run_analysis(site_property: str, days: int, brand_terms: str | None) -> dict[str, Any]:- with tempfile.NamedTemporaryFile(prefix="toprank_weekly_review_", suffix=".json", delete=False) as tmp:+ with tempfile.NamedTemporaryFile(prefix="notfair_weekly_review_", suffix=".json", delete=False) as tmp:output_path = Path(tmp.name)cmd = [sys.executable, str(ANALYZE_GSC), "--site", site_property, "--days", str(days), "--output", str(output_path)]if brand_terms:diff --git a/openclaw/install/install-openclaw-cron.sh b/openclaw/install/install-openclaw-cron.shindex 1cf34c98..4509b321 100755--- a/openclaw/install/install-openclaw-cron.sh+++ b/openclaw/install/install-openclaw-cron.sh@@ -3,7 +3,7 @@ set -euo pipefailusage() {cat <<'USAGE'-Install OpenClaw cron wiring for the Toprank OpenClaw SEO Operator.+Install OpenClaw cron wiring for the NotFair OpenClaw SEO Operator.Usage:./openclaw/install/install-openclaw-cron.sh [options]@@ -18,8 +18,8 @@ Options:--weekly-time <HH:MM> Local time for weekly reviews. Default: 06:30.--scheduler-every <dur> Scheduler interval. Default: 1h.--sites <csv> Comma-separated sites. Default: active sites from ~/.toprank/openclaw/portfolio.json.- --runtime-home <path> Toprank runtime home. Default: ~/.toprank/openclaw.- --repo-root <path> Toprank repo root. Default: auto-detected from this script.+ --runtime-home <path> NotFair runtime home. Default: ~/.toprank/openclaw.+ --repo-root <path> NotFair repo root. Default: auto-detected from this script.Publisher (opt-in; off by default — see openclaw/install/notfair-publisher.md):--enable-publisher Register a recurring publisher job that POSTs ready@@ -80,7 +80,7 @@ if ! command -v openclaw >/dev/null 2>&1; thenfiif [[ ! -x "$REPO_ROOT/openclaw/bin/run_scheduler.py" ]]; then- echo "ERROR: Toprank repo root looks wrong: $REPO_ROOT" >&2+ echo "ERROR: NotFair repo root looks wrong: $REPO_ROOT" >&2exit 1fi@@ -137,7 +137,7 @@ add_job_if_missing() {openclaw cron add --name "$name" "$@"}-scheduler_msg="Run the Toprank OpenClaw scheduler. Execute exactly: TOPRANK_OPENCLAW_HOME=\"$RUNTIME_HOME\" python3 \"$REPO_ROOT/openclaw/bin/run_scheduler.py\". Parse the JSON. If processed, manual_attention, and restored_from_queue are all empty, reply exactly NO_REPLY. If any are non-empty, summarize what changed and include any item_id/site_id that needs attention. If the command fails, report the blocker."+scheduler_msg="Run the NotFair OpenClaw scheduler. Execute exactly: TOPRANK_OPENCLAW_HOME=\"$RUNTIME_HOME\" python3 \"$REPO_ROOT/openclaw/bin/run_scheduler.py\". Parse the JSON. If processed, manual_attention, and restored_from_queue are all empty, reply exactly NO_REPLY. If any are non-empty, summarize what changed and include any item_id/site_id that needs attention. If the command fails, report the blocker."scheduler_args=(--every "$SCHEDULER_EVERY"@@ -149,7 +149,7 @@ scheduler_args=([[ -n "$MODEL" ]] && scheduler_args+=(--model "$MODEL")scheduler_args+=("${delivery_args[@]}")-add_job_if_missing "Toprank OpenClaw Scheduler" "${scheduler_args[@]}"+add_job_if_missing "NotFair OpenClaw Scheduler" "${scheduler_args[@]}"sites=()while IFS= read -r site; do@@ -165,7 +165,7 @@ for i in "${!sites[@]}"; do# Cron day-of-week: 1=Monday. Spread sites across weekdays, then wrap.dow=$(( (i % 5) + 1 ))cron_expr="$minute $hour * * $dow"- weekly_msg="Run the automated Toprank weekly SEO review for $site. Execute exactly: TOPRANK_OPENCLAW_HOME=\"$RUNTIME_HOME\" python3 \"$REPO_ROOT/openclaw/bin/weekly_review.py\" \"$site\". Parse the JSON stdout. If it contains user_message, send that user_message to the user as the main visible update. If business_context_request is present, explicitly ask those questions; do not bury them behind artifact paths. Otherwise summarize the top issue, proposed next action, whether it requires approval, and the artifact path. Do not edit websites, CMS, repos, or publish anything. If the command fails, report the blocker."+ weekly_msg="Run the automated NotFair weekly SEO review for $site. Execute exactly: TOPRANK_OPENCLAW_HOME=\"$RUNTIME_HOME\" python3 \"$REPO_ROOT/openclaw/bin/weekly_review.py\" \"$site\". Parse the JSON stdout. If it contains user_message, send that user_message to the user as the main visible update. If business_context_request is present, explicitly ask those questions; do not bury them behind artifact paths. Otherwise summarize the top issue, proposed next action, whether it requires approval, and the artifact path. Do not edit websites, CMS, repos, or publish anything. If the command fails, report the blocker."weekly_args=(--cron "$cron_expr"@@ -179,7 +179,7 @@ for i in "${!sites[@]}"; do[[ -n "$MODEL" ]] && weekly_args+=(--model "$MODEL")weekly_args+=("${delivery_args[@]}")- add_job_if_missing "Toprank Weekly Review — $site" "${weekly_args[@]}"+ add_job_if_missing "NotFair Weekly Review — $site" "${weekly_args[@]}"doneif [[ "$ENABLE_PUBLISHER" -eq 1 ]]; then@@ -191,7 +191,7 @@ if [[ "$ENABLE_PUBLISHER" -eq 1 ]]; thenif [[ -n "$PUBLISHER_CALENDAR" ]]; thenpublisher_cmd+=" --calendar \"$PUBLISHER_CALENDAR\""fi- publisher_msg="Run the Toprank publisher. Execute exactly: $publisher_cmd. Parse the JSON stdout. If processed is empty, reply exactly NO_REPLY. Otherwise summarize: how many published, how many failed (with reasons), how many retried. If the command exits non-zero, report the blocker. Do not retry the publisher in this turn — the next cron pass picks up retryable failures."+ publisher_msg="Run the NotFair publisher. Execute exactly: $publisher_cmd. Parse the JSON stdout. If processed is empty, reply exactly NO_REPLY. Otherwise summarize: how many published, how many failed (with reasons), how many retried. If the command exits non-zero, report the blocker. Do not retry the publisher in this turn — the next cron pass picks up retryable failures."publisher_args=(--every "$PUBLISHER_EVERY"@@ -203,7 +203,7 @@ if [[ "$ENABLE_PUBLISHER" -eq 1 ]]; then[[ -n "$MODEL" ]] && publisher_args+=(--model "$MODEL")publisher_args+=("${delivery_args[@]}")- add_job_if_missing "Toprank NotFair Publisher" "${publisher_args[@]}"+ add_job_if_missing "NotFair NotFair Publisher" "${publisher_args[@]}"if [[ -z "${NOTFAIR_PUBLISH_TOKEN:-}" ]]; thenecho@@ -214,5 +214,5 @@ if [[ "$ENABLE_PUBLISHER" -eq 1 ]]; thenfiecho-echo "Installed/verified Toprank OpenClaw cron jobs:"-openclaw cron list | grep -i 'Toprank' || true+echo "Installed/verified NotFair OpenClaw cron jobs:"+openclaw cron list | grep -i 'NotFair' || truediff --git a/openclaw/install/notfair-openclaw.cron.example b/openclaw/install/notfair-openclaw.cron.examplenew file mode 100644index 00000000..1de85cd0--- /dev/null+++ b/openclaw/install/notfair-openclaw.cron.example@@ -0,0 +1,6 @@+# Run the NotFair OpenClaw scheduler every hour.+# Edit TOPRANK_OPENCLAW_HOME if you keep runtime state elsewhere (env var+# name retained from the toprank → notfair rename to preserve existing+# config; see CHANGELOG 0.24.0).++0 * * * * TOPRANK_OPENCLAW_HOME="$HOME/.toprank/openclaw" /usr/bin/env python3 /ABSOLUTE/PATH/TO/notfair/openclaw/bin/run_scheduler.py >> "$HOME/.toprank/openclaw/logs/cron.log" 2>&1diff --git a/openclaw/install/notfair-publisher.md b/openclaw/install/notfair-publisher.mdindex 7276a105..6dfc2ec5 100644--- a/openclaw/install/notfair-publisher.md+++ b/openclaw/install/notfair-publisher.md@@ -1,6 +1,6 @@# NotFair Publisher — Webhook Contract-`openclaw/bin/publish_pending.py` POSTs ready blog posts from a Toprank content+`openclaw/bin/publish_pending.py` POSTs ready blog posts from a NotFair contentcalendar to a NotFair-hosted Next.js webhook. This file is the contract: theNext.js handler on `notfair.co` must accept exactly this shape.@@ -58,7 +58,7 @@ There is no HMAC signing in v1. If you need request integrity, add an],"structuredData": { "@context": "https://schema.org", "@type": "BlogPosting", "...": "..." },"scheduledAt": "2026-05-22",- "source": { "tool": "toprank", "skill": "content-planner", "version": "1" }+ "source": { "tool": "notfair", "skill": "content-planner", "version": "1" }}```diff --git a/openclaw/install/toprank-openclaw.cron.example b/openclaw/install/toprank-openclaw.cron.exampledeleted file mode 100644index 79445197..00000000--- a/openclaw/install/toprank-openclaw.cron.example+++ /dev/null@@ -1,4 +0,0 @@-# Run the Toprank OpenClaw scheduler every hour.-# Edit TOPRANK_OPENCLAW_HOME if you keep runtime state elsewhere.--0 * * * * TOPRANK_OPENCLAW_HOME="$HOME/.toprank/openclaw" /usr/bin/env python3 /ABSOLUTE/PATH/TO/toprank/openclaw/bin/run_scheduler.py >> "$HOME/.toprank/openclaw/logs/cron.log" 2>&1diff --git a/openclaw/shared/adapter-rules.md b/openclaw/shared/adapter-rules.mdindex fa631092..37ba4a56 100644--- a/openclaw/shared/adapter-rules.md+++ b/openclaw/shared/adapter-rules.md@@ -4,7 +4,7 @@ These rules apply to every `openclaw/skills/*` wrapper.## 1. Preserve the canonical skills-The existing Toprank skills under `seo/` and `google-ads/` remain the source of truth for domain expertise. Do not fork or silently rewrite them inside the OpenClaw surface.+The existing NotFair skills under `seo/` and `google-ads/` remain the source of truth for domain expertise. Do not fork or silently rewrite them inside the OpenClaw surface.## 2. Treat OpenClaw as the operator layer@@ -37,7 +37,7 @@ python3 {baseDir}/../../bin/site_id.py https://example.comIf the user did not specify a site and multiple sites are active, either:-- run `toprank-portfolio-review`, or+- run `notfair-portfolio-review`, or- ask the user which site they mean.## 5. Required artifactsdiff --git a/openclaw/skills/toprank-improve-page/SKILL.md b/openclaw/skills/notfair-improve-page/SKILL.mdsimilarity index 89%rename from openclaw/skills/toprank-improve-page/SKILL.mdrename to openclaw/skills/notfair-improve-page/SKILL.mdindex 5a598c22..5c7c5350 100644--- a/openclaw/skills/toprank-improve-page/SKILL.md+++ b/openclaw/skills/notfair-improve-page/SKILL.md@@ -1,16 +1,16 @@----name: toprank-improve-page+name: notfair-improve-pagedescription: Improve one URL inside a registered site by producing a focused diagnosis, proposal, and verification artifact.-metadata: { "openclaw": { "emoji": "🧱", "homepage": "https://github.com/nowork-studio/toprank", "requires": { "bins": ["python3"] } } }+metadata: { "openclaw": { "emoji": "🧱", "homepage": "https://github.com/nowork-studio/notfair", "requires": { "bins": ["python3"] } } }----# Toprank Improve Page+# NotFair Improve Page1. Read `{baseDir}/../../shared/adapter-rules.md`.2. Read `{baseDir}/../../shared/artifact-contract.md`.3. Read `{baseDir}/../../shared/policy.md`.4. Load the site work folder, then focus on the target URL and choose the canonical page-level skills that best fit the issue.-5. Read and follow the canonical Toprank skill at `{baseDir}/../../../seo/seo-page/SKILL.md`.+5. Read and follow the canonical NotFair skill at `{baseDir}/../../../seo/seo-page/SKILL.md`.6. Convert the page diagnosis into a structured proposal using `python3 {baseDir}/../../bin/improve_page.py <site> --url <url> --issue-summary "..." --proposal-summary "..."`.7. If you also have file-level edits to suggest, include `--patch-path` and `--patch-summary` so a `patch-set.json` artifact is written.8. Verify that the run wrote `proposal.json` and `verification.json`, plus `patch-set.json` when relevant.diff --git a/openclaw/skills/toprank-investigate-drop/SKILL.md b/openclaw/skills/notfair-investigate-drop/SKILL.mdsimilarity index 86%rename from openclaw/skills/toprank-investigate-drop/SKILL.mdrename to openclaw/skills/notfair-investigate-drop/SKILL.mdindex d1f5f0e6..1a50d1d9 100644--- a/openclaw/skills/toprank-investigate-drop/SKILL.md+++ b/openclaw/skills/notfair-investigate-drop/SKILL.md@@ -1,16 +1,16 @@----name: toprank-investigate-drop+name: notfair-investigate-dropdescription: Investigate an organic traffic drop for one registered site and produce a ranked recovery plan with artifacts.-metadata: { "openclaw": { "emoji": "🚨", "homepage": "https://github.com/nowork-studio/toprank", "requires": { "bins": ["python3"] } } }+metadata: { "openclaw": { "emoji": "🚨", "homepage": "https://github.com/nowork-studio/notfair", "requires": { "bins": ["python3"] } } }----# Toprank Investigate Drop+# NotFair Investigate Drop1. Read `{baseDir}/../../shared/adapter-rules.md`.2. Read `{baseDir}/../../shared/artifact-contract.md`.3. Read `{baseDir}/../../shared/policy.md`.4. Resolve the target site, load prior audits and latest state, then compare the current problem against the site's recent history before choosing the next recovery action.-5. Read and follow the canonical Toprank skill at `{baseDir}/../../../seo/seo-analysis/SKILL.md`.+5. Read and follow the canonical NotFair skill at `{baseDir}/../../../seo/seo-analysis/SKILL.md`.6. Convert the investigation into a structured recovery run using `python3 {baseDir}/../../bin/investigate_drop.py <site> --summary "..." --likely-cause "..."`.7. If the drop points to a specific URL, include `--target-url <url>` so the adaptive layer queues a follow-up page-improvement task.8. Verify that the run wrote `audit.json`, `action-plan.json`, and `verification.json`, plus any follow-up queue items.@@ -26,4 +26,4 @@ Your job:- rank the fastest and safest recovery actions,- write `audit.json`, `action-plan.json`, and `verification.json`.-If the drop investigation suggests a page-level fix, queue a follow-up `toprank-improve-page` task.+If the drop investigation suggests a page-level fix, queue a follow-up `notfair-improve-page` task.diff --git a/openclaw/skills/toprank-portfolio-review/SKILL.md b/openclaw/skills/notfair-portfolio-review/SKILL.mdsimilarity index 77%rename from openclaw/skills/toprank-portfolio-review/SKILL.mdrename to openclaw/skills/notfair-portfolio-review/SKILL.mdindex 024def9c..d06988f5 100644--- a/openclaw/skills/toprank-portfolio-review/SKILL.md+++ b/openclaw/skills/notfair-portfolio-review/SKILL.md@@ -1,18 +1,18 @@----name: toprank-portfolio-review-description: Review all registered websites in the Toprank OpenClaw portfolio and rank which site deserves attention next.-metadata: { "openclaw": { "emoji": "📊", "homepage": "https://github.com/nowork-studio/toprank", "requires": { "bins": ["python3"] } } }+name: notfair-portfolio-review+description: Review all registered websites in the NotFair OpenClaw portfolio and rank which site deserves attention next.+metadata: { "openclaw": { "emoji": "📊", "homepage": "https://github.com/nowork-studio/notfair", "requires": { "bins": ["python3"] } } }----# Toprank Portfolio Review+# NotFair Portfolio Review1. Read `{baseDir}/../../shared/adapter-rules.md`.2. Read `{baseDir}/../../shared/artifact-contract.md`.3. Read `{baseDir}/../../shared/policy.md`.4. Load `portfolio.json` and each active site's `latest-state.json` from the OpenClaw runtime home.5. Run `python3 {baseDir}/../../bin/portfolio_review.py` to get the current ranked site list and write a portfolio review artifact.-6. Read and follow the canonical Toprank skill at `{baseDir}/../../../seo/seo-analysis/SKILL.md` only for the top-ranked site(s) if you need deeper analysis.-7. If the top site needs deeper work, either launch `toprank-weekly-review` for that site or ask the operator which site to dive into.+6. Read and follow the canonical NotFair skill at `{baseDir}/../../../seo/seo-analysis/SKILL.md` only for the top-ranked site(s) if you need deeper analysis.+7. If the top site needs deeper work, either launch `notfair-weekly-review` for that site or ask the operator which site to dive into.## Wrapper jobdiff --git a/openclaw/skills/toprank-site-onboard/SKILL.md b/openclaw/skills/notfair-site-onboard/SKILL.mdsimilarity index 83%rename from openclaw/skills/toprank-site-onboard/SKILL.mdrename to openclaw/skills/notfair-site-onboard/SKILL.mdindex 9c0560ca..be286e69 100644--- a/openclaw/skills/toprank-site-onboard/SKILL.md+++ b/openclaw/skills/notfair-site-onboard/SKILL.md@@ -1,10 +1,10 @@----name: toprank-site-onboard-description: Register a website in Toprank's OpenClaw adaptive layer and initialize its per-site work folder.-metadata: { "openclaw": { "emoji": "🧭", "homepage": "https://github.com/nowork-studio/toprank", "requires": { "bins": ["python3"] } } }+name: notfair-site-onboard+description: Register a website in NotFair's OpenClaw adaptive layer and initialize its per-site work folder.+metadata: { "openclaw": { "emoji": "🧭", "homepage": "https://github.com/nowork-studio/notfair", "requires": { "bins": ["python3"] } } }----# Toprank Site Onboard+# NotFair Site Onboard1. Read `{baseDir}/../../shared/adapter-rules.md`.2. Read `{baseDir}/../../shared/artifact-contract.md`.@@ -13,7 +13,7 @@ metadata: { "openclaw": { "emoji": "🧭", "homepage": "https://github.com/nowor5. Run:- `python3 {baseDir}/../../bin/bootstrap_workspace.py`- `python3 {baseDir}/../../bin/onboard_site.py <url> --display-name "..." --brand-terms "A,B" --business-weight 1.0 --cadence weekly --goal-type grow_non_brand_clicks --primary-metric non_brand_clicks_28d`-6. Read and follow the canonical Toprank skill at `{baseDir}/../../../seo/seo-analysis/SKILL.md` only if you need deeper site understanding during onboarding.+6. Read and follow the canonical NotFair skill at `{baseDir}/../../../seo/seo-analysis/SKILL.md` only if you need deeper site understanding during onboarding.7. Confirm that `site-profile.json`, `goals.json`, and `portfolio.json` were updated.## Wrapper jobdiff --git a/openclaw/skills/toprank-weekly-review/SKILL.md b/openclaw/skills/notfair-weekly-review/SKILL.mdsimilarity index 92%rename from openclaw/skills/toprank-weekly-review/SKILL.mdrename to openclaw/skills/notfair-weekly-review/SKILL.mdindex 5cee6422..53428947 100644--- a/openclaw/skills/toprank-weekly-review/SKILL.md+++ b/openclaw/skills/notfair-weekly-review/SKILL.md@@ -1,10 +1,10 @@----name: toprank-weekly-review+name: notfair-weekly-reviewdescription: Run a weekly SEO review for one registered website, write audit artifacts, and choose the next best safe action.-metadata: { "openclaw": { "emoji": "📈", "homepage": "https://github.com/nowork-studio/toprank", "requires": { "bins": ["python3"] } } }+metadata: { "openclaw": { "emoji": "📈", "homepage": "https://github.com/nowork-studio/notfair", "requires": { "bins": ["python3"] } } }----# Toprank Weekly Review+# NotFair Weekly Review1. Read `{baseDir}/../../shared/adapter-rules.md`.2. Read `{baseDir}/../../shared/artifact-contract.md`.@@ -12,7 +12,7 @@ metadata: { "openclaw": { "emoji": "📈", "homepage": "https://github.com/nowor4. Read `{baseDir}/../../shared/recommendation-quality.md`.5. Read `{baseDir}/../../../seo/shared/seo-best-practices.md` and use its MECE lanes to explain why the top action is the right kind of SEO work.6. Resolve the target `site_id`; if no site was specified and multiple sites are active, run portfolio review first or ask the user which site to review.-7. Read and follow the canonical Toprank skill at `{baseDir}/../../../seo/seo-analysis/SKILL.md`.+7. Read and follow the canonical NotFair skill at `{baseDir}/../../../seo/seo-analysis/SKILL.md`.8. Prefer the automated runner:- `python3 {baseDir}/../../bin/weekly_review.py <site_id-or-url>`- add `--gsc-property` if the site profile does not already contain onediff --git a/openclaw/tests/test_publish_pending.py b/openclaw/tests/test_publish_pending.pyindex d27e15e5..fde2e160 100644--- a/openclaw/tests/test_publish_pending.py+++ b/openclaw/tests/test_publish_pending.py@@ -316,7 +316,7 @@ class PublishPendingTest(unittest.TestCase):self.assertEqual(p["body"], "# Body\n\nText.")self.assertEqual(p["bodyFormat"], "markdown")self.assertEqual(p["featuredImage"], {"url": "https://x/img.png", "alt": "a"})- self.assertEqual(p["source"], {"tool": "toprank", "skill": "content-planner", "version": "1"})+ self.assertEqual(p["source"], {"tool": "notfair", "skill": "content-planner", "version": "1"})self.assertEqual(captured["token"], "secret-token")self.assertEqual(captured["url"], "https://hook.example")diff --git a/seo/broken-link-checker/scripts/checker.py b/seo/broken-link-checker/scripts/checker.pyindex 2faa4dd2..99671432 100644--- a/seo/broken-link-checker/scripts/checker.py+++ b/seo/broken-link-checker/scripts/checker.py@@ -1,6 +1,6 @@#!/usr/bin/env python3"""-Broken Link Checker for Toprank.+Broken Link Checker for NotFair.Crawls a website starting from a given URL and identifies broken links (HTTP 4xx/5xx).Usage:@@ -39,7 +39,7 @@ class LinkParser(HTMLParser):def check_url(url, timeout=10):"""Checks a URL and returns (status_code, error_msg)."""- headers = {'User-Agent': 'ToprankBrokenLinkChecker/1.0'}+ headers = {'User-Agent': 'NotFairBrokenLinkChecker/1.0'}# Try HEAD first for efficiencyreq = urllib.request.Request(url, method='HEAD', headers=headers)@@ -92,7 +92,7 @@ def crawl(start_url, max_pages=50):continue# Check robots.txt Disallow- if rp and not rp.can_fetch("ToprankBrokenLinkChecker/1.0", current_url):+ if rp and not rp.can_fetch("NotFairBrokenLinkChecker/1.0", current_url):print(f"Skipping (blocked by robots.txt): {current_url}", file=sys.stderr)continue@@ -102,7 +102,7 @@ def crawl(start_url, max_pages=50):print(f"[{pages_crawled}/{max_pages}] Checking: {current_url}", file=sys.stderr)try:- req = urllib.request.Request(current_url, headers={'User-Agent': 'ToprankBrokenLinkChecker/1.0'})+ req = urllib.request.Request(current_url, headers={'User-Agent': 'NotFairBrokenLinkChecker/1.0'})with urllib.request.urlopen(req, timeout=10) as response:status = response.getcode()if status >= 400:diff --git a/seo/content-planner/SKILL.md b/seo/content-planner/SKILL.mdindex c8656404..ebe8c33d 100644--- a/seo/content-planner/SKILL.md+++ b/seo/content-planner/SKILL.md@@ -21,7 +21,7 @@ opportunities for *this* site, and produce a dated calendar the user can publishagainst.The output is a structured `content-calendar.json` plus a Markdown summary. The-JSON is consumed by the `toprank-content-calendar` viewer (a local server that+JSON is consumed by the `notfair-content-calendar` viewer (a local server thatrenders the calendar in the browser).**Boundary with sibling skills:**@@ -204,16 +204,16 @@ Print:3. The viewer command, with the exact invocation:```-toprank-content-calendar [--port 8323] [--calendar {data_dir}/content-calendar.json]+notfair-content-calendar [--port 8323] [--calendar {data_dir}/content-calendar.json]```> Open the calendar in your browser:>> ```bash-> ~/.claude/plugins/cache/nowork-studio/toprank/<version>/bin/toprank-content-calendar+> ~/.claude/plugins/cache/nowork-studio/notfair/<version>/bin/notfair-content-calendar> ```>-> (or run it from a clone of the toprank repo: `bin/toprank-content-calendar`.)+> (or run it from a clone of the notfair repo: `bin/notfair-content-calendar`.)> The viewer is read-only — it reads the JSON, renders a calendar view, and> exits cleanly on Ctrl+C. Edit the JSON to change scheduling; reload to see> updates.diff --git a/seo/content-planner/evals/evals.json b/seo/content-planner/evals/evals.jsonindex 3983c771..5509993c 100644--- a/seo/content-planner/evals/evals.json+++ b/seo/content-planner/evals/evals.json@@ -4,7 +4,7 @@{"id": 1,"prompt": "Plan my next 90 days of content based on Search Console data. My site is example.com — a small B2B accounting SaaS for freelancers.",- "expected_output": "A GSC-driven content calendar with 8–12 prioritized topics, each tagged by opportunity bucket (striking-distance, gap, ctr-underperformer), scheduled across 12 weeks, with click-potential scores. The skill should write content-calendar.json to {data_dir} and tell the user how to launch the toprank-content-calendar viewer.",+ "expected_output": "A GSC-driven content calendar with 8–12 prioritized topics, each tagged by opportunity bucket (striking-distance, gap, ctr-underperformer), scheduled across 12 weeks, with click-potential scores. The skill should write content-calendar.json to {data_dir} and tell the user how to launch the notfair-content-calendar viewer.","files": [],"expectations": ["Skill checks for GSC connection before doing anything else",@@ -13,7 +13,7 @@"Computes clickPotential per topic using the documented formula","Every scheduled title uses a hook pattern (number, audience, contrarian, or outcome-promise) — no bare keyword titles","Writes content-calendar.json to {data_dir}/content-calendar.json with the documented schema",- "Tells the user the exact command to run the toprank-content-calendar viewer",+ "Tells the user the exact command to run the notfair-content-calendar viewer","Caps at 12 topics for a 90-day horizon unless user asks for more"]},diff --git a/seo/setup-cms/SKILL.md b/seo/setup-cms/SKILL.mdindex a00568f9..1d1142f3 100644--- a/seo/setup-cms/SKILL.md+++ b/seo/setup-cms/SKILL.md@@ -2,7 +2,7 @@name: setup-cmsargument-hint: "<CMS name: wordpress, strapi, contentful, or ghost>"description: >- Connect a CMS to toprank SEO tools. Guides users through configuring+ Connect a CMS to notfair SEO tools. Guides users through configuringWordPress, Strapi, Contentful, or Ghost — tests the connection, and writescredentials to .env.local. Once set up, seo-analysis automatically cross-references CMS content against Google Search Console data. Use whenever the@@ -18,7 +18,7 @@ allowed-tools:# /setup-cms-Guide the user through connecting their CMS to toprank's SEO analysis tools.+Guide the user through connecting their CMS to notfair's SEO analysis tools.Once configured, `/seo-analysis` automatically pulls published content fromthe CMS and cross-references it against Google Search Console data — finding@@ -85,7 +85,7 @@ Tell the user:> 2. **Your WordPress username** (the one you log in with)> 3. **An Application Password** — create one in:> WordPress Admin → Users → Profile → scroll to **Application Passwords**-> → enter a name like "toprank" → click **Add New** → copy the generated password+> → enter a name like "notfair" → click **Add New** → copy the generated password>> Paste each value when ready."diff --git a/seo/setup-cms/evals/evals.json b/seo/setup-cms/evals/evals.jsonindex 25693fe4..2936c615 100644--- a/seo/setup-cms/evals/evals.json+++ b/seo/setup-cms/evals/evals.json@@ -3,7 +3,7 @@"evals": [{"id": 1,- "prompt": "Connect my WordPress site to toprank.",+ "prompt": "Connect my WordPress site to notfair.","expected_output": "The skill should detect if a CMS is already configured, then guide the user through WordPress setup: asking for the WordPress URL, username, and Application Password. It should explain how to create an Application Password in WordPress Admin.","files": [],"expectations": [diff --git a/seo/shared/seo-best-practices.md b/seo/shared/seo-best-practices.mdindex ae0af995..937a21e9 100644--- a/seo/shared/seo-best-practices.md+++ b/seo/shared/seo-best-practices.md@@ -1,6 +1,6 @@# SEO Best Practices Reference-This is the shared reference for Toprank SEO operators. Use it to keep recommendations grounded in durable SEO principles rather than one-off heuristics.+This is the shared reference for NotFair SEO operators. Use it to keep recommendations grounded in durable SEO principles rather than one-off heuristics.## Primary resourcesdiff --git a/server-google-ads.json b/server-google-ads.jsonindex 151b240c..5b1d4592 100644--- a/server-google-ads.json+++ b/server-google-ads.json@@ -5,7 +5,7 @@"description": "Google Ads MCP - analyze performance, manage keywords, bids, and campaigns.","websiteUrl": "https://notfair.co","repository": {- "url": "https://github.com/nowork-studio/toprank",+ "url": "https://github.com/nowork-studio/notfair","source": "github"},"version": "0.4.0",diff --git a/server-meta-ads.json b/server-meta-ads.jsonindex fded0aa4..1e179b26 100644--- a/server-meta-ads.json+++ b/server-meta-ads.json@@ -5,7 +5,7 @@"description": "Meta Ads MCP (Facebook + Instagram) - analyze performance, manage budgets, pause campaigns.","websiteUrl": "https://notfair.co","repository": {- "url": "https://github.com/nowork-studio/toprank",+ "url": "https://github.com/nowork-studio/notfair","source": "github"},"version": "0.1.0",diff --git a/test/helpers/eval_store.py b/test/helpers/eval_store.pyindex 3ec06b60..1a5e44e7 100644--- a/test/helpers/eval_store.py+++ b/test/helpers/eval_store.py@@ -1,5 +1,5 @@"""-Eval result persistence for toprank tests.+Eval result persistence for notfair tests.Accumulates test results, writes them to ~/.toprank-evals/, prints a summary table."""diff --git a/test/helpers/llm_judge.py b/test/helpers/llm_judge.pyindex 7fe59bac..b9671276 100644--- a/test/helpers/llm_judge.py+++ b/test/helpers/llm_judge.py@@ -1,5 +1,5 @@"""-LLM-as-judge helpers for toprank evals.+LLM-as-judge helpers for notfair evals.Uses Gemini (cheapest option). Set GEMINI_API_KEY or GOOGLE_GENERATIVE_AI_API_KEY.diff --git a/test/helpers/session_runner.py b/test/helpers/session_runner.pyindex 0a6b4958..00ccc708 100644--- a/test/helpers/session_runner.py+++ b/test/helpers/session_runner.py@@ -84,7 +84,7 @@ def parse_ndjson(lines: list[str]) -> tuple[list[Any], Any, int, list[ToolCall]]def create_skill_workdir(skill_path: str, skill_name: str) -> str:"""Copy skill into a temp dir so Claude auto-discovers it at .claude/skills/<name>."""- tmpdir = tempfile.mkdtemp(prefix=f'toprank-test-')+ tmpdir = tempfile.mkdtemp(prefix=f'notfair-test-')dest = os.path.join(tmpdir, '.claude', 'skills', skill_name)shutil.copytree(skill_path, dest)return tmpdirdiff --git a/test/install.test.sh b/test/install.test.shindex afe6a129..db3a3f56 100755--- a/test/install.test.sh+++ b/test/install.test.sh@@ -4,7 +4,7 @@# Usage:# ./test/install.test.sh#-# Validates that the toprank repo has the correct Claude Code plugin structure.+# Validates that the notfair repo has the correct Claude Code plugin structure.set -eo pipefail@@ -43,12 +43,16 @@ assert_not_contains() {! grep -q "$needle" "$path" 2>/dev/null && pass "$label" || fail "$label — '$needle' found in $path (should not be)"}-# Skill paths relative to repo root (name:path pairs)+# Skill paths relative to repo root (name:path pairs). Names mirror the+# SKILL.md frontmatter `name:` field, which becomes the slash command tail+# after the `notfair:` plugin prefix (e.g. `name: upgrade` → `/notfair:upgrade`).SKILL_ENTRIES=("google-ads:google-ads/manage""google-ads-audit:google-ads/audit""google-ads-copy:google-ads/copy""google-ads-landing:google-ads/landing"+ "meta-ads:meta-ads/manage"+ "meta-ads-audit:meta-ads/audit""seo-analysis:seo/seo-analysis""content-writer:seo/content-writer""content-planner:seo/content-planner"@@ -59,7 +63,7 @@ SKILL_ENTRIES=("seo-page:seo/seo-page""broken-link-checker:seo/broken-link-checker""geo-optimizer:seo/geo-optimizer"- "toprank-upgrade:toprank-upgrade-skill"+ "upgrade:notfair-upgrade-skill""gemini:gemini")@@ -81,6 +85,18 @@ assert_json_field "$REPO_ROOT/.claude-plugin/plugin.json" "skills" "plugin.jsonassert_json_field "$REPO_ROOT/.claude-plugin/marketplace.json" "plugins" "marketplace.json has plugins"+# Plugin name in plugin.json must be 'notfair' (post-0.24.0 rename)+PLUGIN_NAME=$(python3 -c "import json; print(json.load(open('$REPO_ROOT/.claude-plugin/plugin.json'))['name'])")+[ "$PLUGIN_NAME" = "notfair" ] \+ && pass "plugin.json name is 'notfair'" \+ || fail "plugin.json name is '$PLUGIN_NAME', expected 'notfair'"++# marketplace.json plugin entry name must also be 'notfair'+MKT_PLUGIN_NAME=$(python3 -c "import json; print(json.load(open('$REPO_ROOT/.claude-plugin/marketplace.json'))['plugins'][0]['name'])")+[ "$MKT_PLUGIN_NAME" = "notfair" ] \+ && pass "marketplace.json plugins[0].name is 'notfair'" \+ || fail "marketplace.json plugins[0].name is '$MKT_PLUGIN_NAME', expected 'notfair'"+# Plugin version matches VERSION filePLUGIN_VERSION=$(python3 -c "import json; print(json.load(open('$REPO_ROOT/.claude-plugin/plugin.json'))['version'])")FILE_VERSION=$(cat "$REPO_ROOT/VERSION" | tr -d '[:space:]')@@ -117,7 +133,7 @@ for entry in "${SKILL_ENTRIES[@]}"; dodone# Guard: actual SKILL.md count must match-actual_skill_count=$(find "$REPO_ROOT/google-ads" "$REPO_ROOT/seo" "$REPO_ROOT/toprank-upgrade-skill" "$REPO_ROOT/gemini" -name "SKILL.md" | wc -l | tr -d ' ')+actual_skill_count=$(find "$REPO_ROOT/google-ads" "$REPO_ROOT/seo" "$REPO_ROOT/meta-ads" "$REPO_ROOT/notfair-upgrade-skill" "$REPO_ROOT/gemini" -name "SKILL.md" | wc -l | tr -d ' ')if [ "$actual_skill_count" -ne "${#SKILL_ENTRIES[@]}" ]; thenfail "Expected ${#SKILL_ENTRIES[@]} SKILL.md files but found $actual_skill_count"else@@ -134,13 +150,23 @@ echo "=== 3. Legacy structure + helpers ==="|| fail "setup script still exists (should be deleted)"assert_dir "$REPO_ROOT/bin" "bin/ helper directory exists"-assert_file "$REPO_ROOT/bin/toprank-config" "bin/toprank-config exists"-assert_file "$REPO_ROOT/bin/toprank-update-check" "bin/toprank-update-check exists"-assert_file "$REPO_ROOT/bin/toprank-change-watch" "bin/toprank-change-watch exists"+assert_file "$REPO_ROOT/bin/notfair-config" "bin/notfair-config exists"+assert_file "$REPO_ROOT/bin/notfair-update-check" "bin/notfair-update-check exists"+assert_file "$REPO_ROOT/bin/notfair-change-watch" "bin/notfair-change-watch exists"++# Old toprank-* bin names must not coexist (0.24.0 rename should be clean)+[ ! -f "$REPO_ROOT/bin/toprank-config" ] \+ && pass "legacy bin/toprank-config removed" \+ || fail "bin/toprank-config still exists (should have been git-mv'd to notfair-config)"++# Old toprank-upgrade-skill/ directory must not coexist+[ ! -d "$REPO_ROOT/toprank-upgrade-skill" ] \+ && pass "legacy toprank-upgrade-skill/ removed" \+ || fail "toprank-upgrade-skill/ still exists (should have been git-mv'd to notfair-upgrade-skill/)"[ ! -d "$REPO_ROOT/skills" ] \&& pass "skills/ flat directory removed" \- || fail "skills/ directory still exists (skills should be in google-ads/, seo/, toprank-upgrade-skill/, gemini/)"+ || fail "skills/ directory still exists (skills should be in google-ads/, seo/, meta-ads/, notfair-upgrade-skill/, gemini/)"[ ! -d "$REPO_ROOT/.agents" ] \&& pass ".agents/ directory removed" \@@ -152,14 +178,15 @@ echo ""echo "=== 4. Shared preambles ==="assert_file "$REPO_ROOT/google-ads/shared/preamble.md" "Google Ads shared preamble exists"+assert_file "$REPO_ROOT/meta-ads/shared/preamble.md" "Meta Ads shared preamble exists"assert_file "$REPO_ROOT/seo/shared/preamble.md" "SEO shared preamble exists"# Ads skills reference the shared preamble (not inline MCP detection)for skill in manage audit copy; doassert_contains "$REPO_ROOT/google-ads/$skill/SKILL.md" "../shared/preamble.md" \- "$skill references shared preamble"+ "google-ads/$skill references shared preamble"assert_not_contains "$REPO_ROOT/google-ads/$skill/SKILL.md" "mcp__notfair__listConnectedAccounts" \- "$skill does not inline MCP detection (notfair prefix)"+ "google-ads/$skill does not inline MCP detection (notfair prefix)"done# SEO skills that need GSC reference the shared preamblediff --git a/test/unit/test_analyze_gsc.py b/test/unit/test_analyze_gsc.pyindex 4be063cc..38bb421b 100644--- a/test/unit/test_analyze_gsc.py+++ b/test/unit/test_analyze_gsc.py@@ -803,10 +803,10 @@ class TestClassifyBranded(unittest.TestCase):self.assertFalse(gsc.classify_branded('acme pricing', None))def test_multiple_brand_terms_any_match(self):- self.assertTrue(gsc.classify_branded('toprank seo tool', ['acme', 'toprank']))+ self.assertTrue(gsc.classify_branded('notfair seo tool', ['acme', 'notfair']))def test_multiple_brand_terms_none_match(self):- self.assertFalse(gsc.classify_branded('best content marketing', ['acme', 'toprank']))+ self.assertFalse(gsc.classify_branded('best content marketing', ['acme', 'notfair']))def test_partial_word_match(self):# "acmecorp" contains "acme" — should match