← all repositories
nowork-studio/notfair-plugin

An ad agency that fits inside Claude Code

It exists because marketing dashboards show you what broke, but someone still has to log into three ad platforms and pull the levers.

3.4k stars TypeScript Coding Assistants
notfair-plugin
Velocity · 7d
+4.0
★ / day
Trend
steady
star history

What it does

NotFair is a Claude Code plugin that wires your AI agent directly into Google Ads, Meta Ads, and Google Search Console. It audits campaigns for wasted spend, creative fatigue, and keyword bloat, then surfaces specific fixes—like pausing a zero-conversion keyword or adding negative search terms. For SEO, it crawls your site, diagnoses ranking drops, and can rewrite meta tags, headings, and structured data if it has repo access.

The interesting bit

The unusual part is the weekly review loop: after you approve changes, Claude scores its own recent decisions as wins, losses, or too-new-to-judge, building a feedback cycle that most agency retainers lack. It also includes a dedicated geo-optimizer skill that rewrites content specifically to be cited by AI search engines like ChatGPT and Perplexity.

Key highlights

  • Namespaced skills for Google Ads (/notfair:google-ads-audit), Meta Ads, and SEO that share business context between commands
  • Companion web app at notfair.co shares the same audit engine; CLI and browser use identical tooling
  • Built-in Gemini cross-model review for adversarial stress-testing of ad and SEO decisions
  • MCP servers handle OAuth to ad platforms automatically; tokens store in the OS keychain
  • Free and open-source, though it requires a notfair.co account to authorize ad platform access

Caveats

  • The project recently renamed itself from Toprank to NotFair (v0.24.0), and the runtime state directory still lives under ~/.toprank/, so the transition is incomplete
  • Meta Ads mutations route through dedicated tools, but operations outside that surface punt you back to the native Meta Ads Manager rather than improvising—a safe choice, but the agent can’t handle every edge case
  • SEO code changes only ship automatically if the agent has access to your repository; otherwise you’re back to copy-paste

Verdict

Grab it if you run paid acquisition or SEO for a living and already live in Claude Code. Skip it if you expect a fully autonomous agent—this is more of a very opinionated analyst that occasionally files pull requests.

Frequently asked

What is nowork-studio/notfair-plugin?
It exists because marketing dashboards show you what broke, but someone still has to log into three ad platforms and pull the levers.
Is notfair-plugin open source?
Yes — nowork-studio/notfair-plugin is open source, released under the MIT license.
What language is notfair-plugin written in?
nowork-studio/notfair-plugin is primarily written in TypeScript.
How popular is notfair-plugin?
nowork-studio/notfair-plugin has 3.4k stars on GitHub and is currently holding steady.
Where can I find notfair-plugin?
nowork-studio/notfair-plugin is on GitHub at https://github.com/nowork-studio/notfair-plugin.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.