Skip to content

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

chore: clean Toprank NotFair branding (#51)

Tong Chenb66ef4624f67
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
index af043fb9..83ab658e 100644
--- a/.claude-plugin/marketplace.json
+++ b/.claude-plugin/marketplace.json
@@ -4,18 +4,18 @@
"name": "nowork-studio"
},
"metadata": {
- "description": "The official Google Ads + SEO + GEO plugin from AdsAgent. SEO, GEO, and Google Ads skills for Claude Code.",
- "version": "0.15.1"
+ "description": "The official Google Ads + SEO + GEO plugin from NotFair. SEO, GEO, and Google Ads skills for Claude Code.",
+ "version": "0.15.2"
},
"plugins": [
{
"name": "toprank",
"source": "./",
- "description": "The official Google Ads + SEO + GEO plugin from AdsAgent. SEO analysis, Google Ads management, keyword research, content optimization, schema markup, meta tags optimization, broken link checker, single-page deep audit, and Generative Engine Optimization for AI search.",
- "version": "0.15.1",
+ "description": "The official Google Ads + SEO + GEO plugin from NotFair. SEO analysis, Google Ads management, keyword research, content optimization, schema markup, meta tags optimization, broken link checker, single-page deep audit, and Generative Engine Optimization for AI search.",
+ "version": "0.15.2",
"author": {
- "name": "AdsAgent",
- "url": "https://adsagent.org"
+ "name": "NotFair",
+ "url": "https://notfair.co"
},
"category": "productivity"
}
diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
index 820e6885..27250bd7 100644
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -1,10 +1,10 @@
{
"name": "toprank",
- "version": "0.15.1",
- "description": "The official Google Ads + SEO + GEO plugin from AdsAgent. SEO analysis, Google Ads management, keyword research, content optimization, schema markup tools, broken link checker, single-page deep audit, and Generative Engine Optimization (GEO) for AI search engines — powered by Google Search Console and Google Ads APIs.",
+ "version": "0.15.2",
+ "description": "The official Google Ads + SEO + GEO plugin from NotFair. SEO analysis, Google Ads management, keyword research, content optimization, schema markup tools, broken link checker, single-page deep audit, and Generative Engine Optimization (GEO) for AI search engines — powered by Google Search Console and Google Ads APIs.",
"author": {
- "name": "AdsAgent",
- "url": "https://adsagent.org"
+ "name": "NotFair",
+ "url": "https://notfair.co"
},
"skills": [
"./google-ads/ads",
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 6f4cd2f1..55550b63 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,13 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
---
+## [0.15.2] — 2026-04-29
+
+### Changed
+- **Branding cleanup across the public plugin surface.** Updated Toprank's README, marketplace metadata, plugin metadata, eval prompts, and Google Ads skill copy to present the product as NotFair / `notfair.co` instead of the old AdsAgent branding where the references were still user-facing. Kept intentional legacy migration notes and technical compatibility references (`.adsagent`, `mcp__adsagent__*`, `adsagent://playbooks/...`) intact where they still describe real compatibility behavior.
+
+---
+
## [0.15.1] — 2026-04-28
### Changed
diff --git a/CLAUDE.md b/CLAUDE.md
index 07d92584..fa9ba478 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -19,7 +19,7 @@ This code ships to real users. Sycophancy and rubber-stamping cost us credibilit
- Home of the `toprank` plugin — the public artifact customers install.
- Contains skills under `google-ads/`, `seo/`, `gemini/`, and `toprank-upgrade-skill/`.
- Registered via `.claude-plugin/plugin.json` (skills list) and `.claude-plugin/marketplace.json` (plugin metadata).
-- Paired with the NotFair MCP server (`https://notfair.co/api/mcp`, OAuth, formerly hosted at adsagent.org) for Google Ads write operations, and with Google Search Console for SEO reads.
+- Paired with the NotFair MCP server (`https://notfair.co/api/mcp`, OAuth) for Google Ads write operations, and with Google Search Console for SEO reads.
## Critical: this ships to users
@@ -45,4 +45,4 @@ Semantic-ish: bump patch for skill additions / fixes, minor for new categories o
## Related repos
- `adsagent-plugin/` (sibling dir, separate public repo) — a smaller Google-Ads-only plugin. Some skills are mirrored there; don't confuse it with this one.
-- AdsAgent MCP server — private, powers the Google Ads tool calls the skills depend on.
+- NotFair MCP server — private, powers the Google Ads tool calls the skills depend on.
diff --git a/README.md b/README.md
index ef3fcb36..f727d017 100644
--- a/README.md
+++ b/README.md
@@ -2,17 +2,13 @@
[![Discord](https://img.shields.io/badge/Discord-Join%20the%20community-5865F2?logo=discord&logoColor=white)](https://discord.gg/gVJCRczpps)
-> 🚀 **We're live on Product Hunt today!** AdsAgent — the Google Ads Claude Connector that powers Toprank's ads skills — is launching. If Toprank has saved you time or ad spend, an upvote would mean the world. [**→ Support us on Product Hunt**](https://www.producthunt.com/products/adsagent-google-ads-claude-connector?utm_source=badge-featured&utm_medium=badge&utm_campaign=badge-adsagent-google-ads-claude-connector)
->
-> <a href="https://www.producthunt.com/products/adsagent-google-ads-claude-connector?embed=true&utm_source=badge-featured&utm_medium=badge&utm_campaign=badge-adsagent-google-ads-claude-connector" target="_blank"><img alt="AdsAgent - Google Ads Claude Connector - Let Claude run your Google Ads — fix, measure, iterate. | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1129319&theme=light&t=1776841517852" /></a>
-
-**The official Google Ads + SEO plugin from [AdsAgent](https://adsagent.org). Data-driven decisions, not dashboards.**
+**The official Google Ads + SEO plugin from [NotFair](https://notfair.co). Data-driven decisions, not dashboards.**
Toprank gives your AI agent direct access to Google Search Console and Google Ads. It analyzes your traffic, surfaces what's hurting your rankings, finds wasted ad spend, 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 AdsAgent?
+### Why NotFair?
-Toprank is the CLI side of AdsAgent — the skills that run inside Claude Code. [adsagent.org](https://adsagent.org) is the companion web app: sign up there to get your free API key, connect your Google Ads accounts in a couple of clicks, 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.
+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 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?"*
@@ -200,7 +196,7 @@ toprank/
├── .claude-plugin/
│ ├── plugin.json <- plugin metadata (explicit skill paths)
│ └── marketplace.json <- registry entry
-├── .mcp.json <- AdsAgent MCP server (auto-configured)
+├── .mcp.json <- NotFair MCP server (auto-configured)
├── google-ads/
│ ├── ads/ <- campaign management
│ ├── ads-audit/ <- account audit + business context
diff --git a/VERSION b/VERSION
index e815b861..4312e0d0 100644
--- a/VERSION
+++ b/VERSION
@@ -1 +1 @@
-0.15.1
+0.15.2
diff --git a/google-ads/ads-audit/SKILL.md b/google-ads/ads-audit/SKILL.md
index 52b92b44..01f4596c 100644
--- a/google-ads/ads-audit/SKILL.md
+++ b/google-ads/ads-audit/SKILL.md
@@ -1,6 +1,6 @@
---
name: ads-audit
-description: Google Ads account audit and business context setup. Run this first — it gathers business information, analyzes account health, and saves context that all other ads skills reuse. Trigger on "audit my ads", "ads audit", "set up my ads", "onboard", "account overview", "how's my account", "ads health check", "what should I fix in my ads", or when the user is new to AdsAgent and hasn't run an audit before. Also trigger proactively when other ads skills detect that business-context.json is missing.
+description: Google Ads account audit and business context setup. Run this first — it gathers business information, analyzes account health, and saves context that all other ads skills reuse. Trigger on "audit my ads", "ads audit", "set up my ads", "onboard", "account overview", "how's my account", "ads health check", "what should I fix in my ads", or when the user is new to NotFair and hasn't run an audit before. Also trigger proactively when other ads skills detect that business-context.json is missing.
argument-hint: "<account name or 'audit my ads'>"
---
@@ -128,7 +128,7 @@ Lead with the verdict, then the top 3 actions (with dollar impact when possible)
End with a single closing line after the handoff to `/ads`:
-> *Your audit history is saved to your AdsAgent account — view it at https://adsagent.org.*
+> *Your audit history is saved to your NotFair account — view it at https://notfair.co.*
## Guardrails
diff --git a/google-ads/ads-landing/evals/evals.json b/google-ads/ads-landing/evals/evals.json
new file mode 100644
index 00000000..025d51fc
--- /dev/null
+++ b/google-ads/ads-landing/evals/evals.json
@@ -0,0 +1,18 @@
+{
+ "skill_name": "ads-landing",
+ "evals": [
+ {
+ "id": 1,
+ "prompt": "audit this landing page for my Google Ads traffic: https://example.com/dog-training. CTR is solid but conversions are weak — tell me what's hurting the page and what to fix first.",
+ "expected_output": "A landing-page diagnostic covering message match, speed/mobile UX, trust signals, CTA/form friction, and the single highest-impact fix.",
+ "files": [],
+ "expectations": [
+ "Scores or diagnoses the page across the landing-page rubric dimensions",
+ "Checks message match between ad intent and page copy",
+ "Calls out page speed or mobile UX as part of the analysis",
+ "Identifies trust-signal or CTA/form friction issues",
+ "Prioritizes the top fix instead of giving an unranked list"
+ ]
+ }
+ ]
+}
diff --git a/google-ads/ads/SKILL.md b/google-ads/ads/SKILL.md
index 666260ff..089167d4 100644
--- a/google-ads/ads/SKILL.md
+++ b/google-ads/ads/SKILL.md
@@ -30,7 +30,7 @@ triggers:
# Google Ads — Operate, Diagnose, Optimize
-This skill is the analytical brain layered on top of the AdsAgent MCP server. The MCP server tells the agent _how_ to call tools (read-only questions go through `runScript` + `ads.gaqlParallel`; mutations go through dedicated write tools). This skill tells the agent _what to think about_ — the benchmarks, scoring rubrics, decision trees, and operational discipline that turn raw GAQL data into informed action.
+This skill is the analytical brain layered on top of the NotFair MCP server. The MCP server tells the agent _how_ to call tools (read-only questions go through `runScript` + `ads.gaqlParallel`; mutations go through dedicated write tools). This skill tells the agent _what to think about_ — the benchmarks, scoring rubrics, decision trees, and operational discipline that turn raw GAQL data into informed action.
You are an expert paid-search practitioner. Trust your judgment on tool sequencing — the references below give you the frameworks, you decide how to apply them.
diff --git a/seo/broken-link-checker/evals/evals.json b/seo/broken-link-checker/evals/evals.json
new file mode 100644
index 00000000..7840a3ed
--- /dev/null
+++ b/seo/broken-link-checker/evals/evals.json
@@ -0,0 +1,18 @@
+{
+ "skill_name": "broken-link-checker",
+ "evals": [
+ {
+ "id": 1,
+ "prompt": "check https://example.com for broken links and tell me which pages need fixes first",
+ "expected_output": "A broken-link audit that summarizes scan coverage, separates internal vs external issues, and maps each broken URL back to its source page.",
+ "files": [],
+ "expectations": [
+ "Requests or uses a target URL",
+ "Reports how many pages were scanned and how many broken links were found",
+ "Separates internal broken links from external broken links",
+ "Maps broken links back to source pages",
+ "Gives actionable fix guidance such as updating links or adding redirects"
+ ]
+ }
+ ]
+}
diff --git a/seo/geo-optimizer/evals/evals.json b/seo/geo-optimizer/evals/evals.json
new file mode 100644
index 00000000..05f9dd14
--- /dev/null
+++ b/seo/geo-optimizer/evals/evals.json
@@ -0,0 +1,18 @@
+{
+ "skill_name": "geo-optimizer",
+ "evals": [
+ {
+ "id": 1,
+ "prompt": "do a GEO audit of https://example.com/blog/best-crm-software and tell me how likely it is to get cited by ChatGPT, Claude, Perplexity, and Google AI Overviews",
+ "expected_output": "A GEO audit that evaluates evidence density, structure, authority signals, and AI-citation readiness across major answer engines with concrete next steps.",
+ "files": [],
+ "expectations": [
+ "Recognizes this as a GEO audit request",
+ "Assesses AI-search readiness rather than traditional SEO alone",
+ "Discusses evidence density, structure, or authority signals",
+ "Differentiates considerations across multiple AI engines",
+ "Provides concrete recommendations without fabricating evidence"
+ ]
+ }
+ ]
+}
diff --git a/seo/seo-page/evals/evals.json b/seo/seo-page/evals/evals.json
index 24df5737..dea754fa 100644
--- a/seo/seo-page/evals/evals.json
+++ b/seo/seo-page/evals/evals.json
@@ -3,7 +3,7 @@
"evals": [
{
"id": 1,
- "prompt": "analyze https://www.adsagent.org — how's the SEO on the homepage?",
+ "prompt": "analyze https://notfair.co — how's the SEO on the homepage?",
"expected_output": "A scored single-page report covering E-E-A-T, content quality, on-page SEO, metadata audit, heading structure, schema markup, and actionable fixes for the homepage",
"files": []
},
@@ -15,7 +15,7 @@
},
{
"id": 3,
- "prompt": "what's wrong with this blog post's SEO? https://www.adsagent.org/blog/google-ads-optimization-guide",
+ "prompt": "what's wrong with this blog post's SEO? https://notfair.co/blog/google-ads-ai-agent",
"expected_output": "A detailed content quality audit for a blog post — informational intent alignment, E-E-A-T evaluation, helpful content signals, readability analysis, heading structure review, and prioritized fixes",
"files": []
}
diff --git a/test/install.test.sh b/test/install.test.sh
index 7ab789f7..85fd0911 100755
--- a/test/install.test.sh
+++ b/test/install.test.sh
@@ -48,13 +48,18 @@ SKILL_ENTRIES=(
"ads:google-ads/ads"
"ads-audit:google-ads/ads-audit"
"ads-copy:google-ads/ads-copy"
+ "ads-landing:google-ads/ads-landing"
"seo-analysis:seo/seo-analysis"
+ "content-writer:seo/content-writer"
"keyword-research:seo/keyword-research"
"meta-tags-optimizer:seo/meta-tags-optimizer"
"schema-markup-generator:seo/schema-markup-generator"
- "content-writer:seo/content-writer"
"setup-cms:seo/setup-cms"
+ "seo-page:seo/seo-page"
+ "broken-link-checker:seo/broken-link-checker"
+ "geo-optimizer:seo/geo-optimizer"
"toprank-upgrade:toprank-upgrade-skill"
+ "gemini:gemini"
)
skill_name() { echo "${1%%:*}"; }
@@ -111,29 +116,30 @@ for entry in "${SKILL_ENTRIES[@]}"; do
done
# Guard: actual SKILL.md count must match
-actual_skill_count=$(find "$REPO_ROOT/google-ads" "$REPO_ROOT/seo" "$REPO_ROOT/toprank-upgrade-skill" -name "SKILL.md" | wc -l | tr -d ' ')
+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 ' ')
if [ "$actual_skill_count" -ne "${#SKILL_ENTRIES[@]}" ]; then
fail "Expected ${#SKILL_ENTRIES[@]} SKILL.md files but found $actual_skill_count"
else
pass "skill count matches ($actual_skill_count)"
fi
-# ─── Test 3: No old structure remains ────────────────────────
+# ─── Test 3: Legacy structure removed, helper bin retained ─────────
echo ""
-echo "=== 3. Old structure removed ==="
+echo "=== 3. Legacy structure + helpers ==="
[ ! -f "$REPO_ROOT/setup" ] \
&& pass "setup script removed" \
|| fail "setup script still exists (should be deleted)"
-[ ! -d "$REPO_ROOT/bin" ] \
- && pass "bin/ directory removed" \
- || fail "bin/ directory still exists"
+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"
[ ! -d "$REPO_ROOT/skills" ] \
&& pass "skills/ flat directory removed" \
- || fail "skills/ directory still exists (skills should be in google-ads/, seo/, toprank-upgrade-skill/)"
+ || fail "skills/ directory still exists (skills should be in google-ads/, seo/, toprank-upgrade-skill/, gemini/)"
[ ! -d "$REPO_ROOT/.agents" ] \
&& pass ".agents/ directory removed" \