NotFair Plugin
Open-source SEO, GEO, and marketing skills for AI agents.
The NotFair Plugin gives Claude Code, Codex, Hermes, and other compatible agents practical marketing workflows they can follow—not another generic prompt collection. Use it to audit a site, investigate a traffic drop, analyze GA4 and Search Console, find wasted ad spend across Google, Meta, X, LinkedIn, Reddit, and TikTok, operate connected WordPress and GoHighLevel accounts, build campaign plans, and make reviewable changes.
Each skill has one discoverable skills/<name>/SKILL.md entry point. It loads a readable WORKFLOW.md in the category folder, with supporting references, scripts, and evals where needed. Inspect it, adapt it, or contribute a better workflow.
What your agent can do
The NotFair Plugin currently ships 48 skills across SEO, GEO, paid media, advertising platforms, analytics, WordPress, CRM, and cross-model review.
Quick start
Claude Code
Install the NotFair plugin from its marketplace:
/plugin marketplace add nowork-studio/notfair-plugin
/plugin install notfair@nowork-studio
Then ask for the workflow you need:
/notfair:seo-analysis
/notfair:geo-optimizer
/notfair:google-ads-audit
/notfair:meta-ads-creative
/notfair:paid-ads-x
/notfair:google-analytics
/notfair:search-console
You can also use plain language:
Audit my site and tell me why organic traffic fell.
Find pages that could earn citations in AI answers.
Review last month's ad spend and show me the safest opportunities to improve ROAS.
Cursor
Install NotFair from Cursor's plugin marketplace. The plugin loads the open-source marketing skills in this repository and registers one hosted NotFair MCP connection. Complete the browser OAuth flow when Cursor prompts you, then ask Cursor to audit an ad account, analyze GA4 or Search Console, or run one of the SEO and GEO workflows listed below.
For local testing before the marketplace listing is available, clone this repository into Cursor's local plugin directory:
git clone https://github.com/nowork-studio/notfair-plugin.git ~/.cursor/plugins/local/notfair
Restart Cursor after installing or updating the local plugin.
Kiro Powers
Install the public repository as a custom power from Kiro's Powers panel, or
find NotFair in the Powers registry after its listing is approved. The root
plugin.json and mcp.json follow the Agent Plugins
1.0 specification.
Gemini CLI
Install the extension directly from GitHub:
gemini extensions install https://github.com/nowork-studio/notfair-plugin
The extension loads the repository guidance and the universal NotFair MCP. Run
/mcp auth NotFair in Gemini CLI when authentication is requested.
Codex, Hermes, and other agents
Install the universal NotFair plugin directly through Codex:
codex plugin marketplace add nowork-studio/notfair-plugin --json && codex plugin add notfair@nowork-studio --json && codex mcp login NotFair
Codex installs the skills, registers one NotFair MCP connection, and opens its OAuth flow. If you prefer a workspace-local checkout, clone the repository and open it as a workspace; AGENTS.md maps marketing requests to the right skill.
git clone https://github.com/nowork-studio/notfair-plugin.git
cd notfair-plugin
If the nowork-studio marketplace is already configured, refresh it instead:
codex plugin marketplace upgrade nowork-studio --json && codex plugin add notfair@nowork-studio --json && codex mcp login NotFair
For host-specific setup, give your agent INSTALL_FOR_AGENTS.md, or paste:
Retrieve and follow the instructions at:
https://raw.githubusercontent.com/nowork-studio/notfair-plugin/main/INSTALL_FOR_AGENTS.md
Guides and comparisons
Background reading on connecting ad accounts to AI agents and choosing a setup:
- Google Ads MCP servers compared
- Meta Ads MCP servers compared
- Claude connectors for Google Ads compared
- Claude connectors for Meta Ads compared
- How to connect Google Ads to Claude
- How to connect Meta Ads to Claude
- Google Ads MCP overview
- Meta Ads MCP overview
Why skills instead of one giant marketing agent?
Marketing work gets unreliable when every request goes through the same vague prompt. The NotFair Plugin splits the work into focused, testable procedures.
- Specialized: each skill has a defined job, required inputs, decision rules, and output format.
- Evidence-led: live-data workflows use Search Console, Google Analytics, Google Ads, Meta Ads, X Ads, LinkedIn Ads, Reddit Ads, TikTok Ads, WordPress, or GoHighLevel instead of guessing from generic best practices.
- Safe by design: read-only review comes before mutation, paid-media changes stay explicit, and unsupported capabilities are never implied.
- Host-agnostic: the canonical skills are plain files, not logic trapped inside one agent runtime.
- Forkable: everything is MIT licensed, so teams can review and adapt the workflows to their own standards.
Skill catalog
SEO and GEO
Paid media
Google Ads
Meta Ads
Analytics
WordPress
CRM
Cross-model review and maintenance
Live data and integrations
Some skills work entirely from a repository, URL, or supplied export. Live account analysis uses one OAuth-connected universal NotFair MCP. The plugin registers exactly one server named NotFair, shared by every supported platform.
The agent chooses tools from the live server's instructions and capability descriptions. Skills supply marketing workflows and evidence standards without hardcoding MCP tool names or call sequences. See the connection and upgrade guide for manual configuration and migration from older per-platform connections. Each platform becomes available after it is connected in the NotFair workspace selected during OAuth. Follow any account setup guidance returned by the server.
Supported account operations come from the live connection. Changes must stay within the user's authorization and be verified against the resulting account state. Amazon and ChatGPT Ads remain planning or export-review workflows unless the current agent session exposes a verified connector. setup-cms is a local SEO-script credential wizard; live WordPress work uses /notfair:wordpress.
Privacy and support
The plugin connects to the declared NotFair MCP endpoint through browser OAuth. Requested tool arguments go to NotFair and results from connected providers return to your authorized AI client. See the privacy policy for storage, retention, and deletion details. Connect only the workspace and platform accounts you intend to use.
Optional local workflows run readable Python or shell scripts. Crawlers request
the URLs you supply; direct Search Console scripts use your explicitly authorized
Google Cloud login; CMS scripts use the site credentials you configure through
setup-cms. Gemini review sends the selected review context to Google's Gemini
CLI after its authentication setup. Choose these workflows explicitly, keep
credentials out of reports and commits, and use the OAuth MCP for live platform
work when it is available. There are no automatic plugin hooks or local MCP servers.
The calendar viewer serves local planning data on loopback, and the optional
update checker reads the public version file from GitHub.
The separate NotFair Next.js blog library now lives in its own public repository and is distributed through its GitHub releases. Its source and publishing workflow are no longer bundled in this AI-agent plugin. The retired NotFair CMO application is also no longer included.
Inside a skill, connectors use tool-agnostic placeholders such as ~~google-ads, ~~meta-ads, ~~x-ads, ~~linkedin-ads, ~~reddit-ads, ~~tiktok-ads, ~~search-console, ~~google-analytics, ~~wordpress, and ~~gohighlevel. The agent resolves each placeholder to a compatible tool available in the current session, so the workflow is not coupled to one MCP namespace.
How the repository is organized
notfair-plugin/
├── AGENTS.md # intent-to-skill resolver for AI agents
├── .claude-plugin/ # Claude Code plugin manifest
├── paid-ads/ # cross-channel planning, review, optimization
├── google-ads/ # audit, management, copy, assets, landing pages
├── meta-ads/ # audit, management, creative
├── analytics/ # Google Analytics and Search Console MCP workflows
├── wordpress/ # live WordPress MCP operator
├── gohighlevel/ # live GoHighLevel CRM MCP operator
├── seo/ # SEO, GEO, content, and technical-search skills
├── gemini/ # cross-model review
├── test/ # unit and LLM-judge evals
└── skills/ # shared entry points for every agent host
AGENTS.md is the universal entry point. It maps user intent to the canonical SKILL.md and documents the external dependency each workflow requires.
Contributing
Each skill lives in its own category folder:
seo/your-skill-name/
├── WORKFLOW.md # full instructions and frontmatter
├── references/ # optional supporting knowledge
└── scripts/ # optional deterministic tooling
When adding or changing a skill:
- Keep the workflow focused on one clear marketing job.
- Use imperative, testable instructions in
WORKFLOW.md, and keep the entry point underskills/in sync. - Add or update eval coverage.
- Update
AGENTS.md, the plugin manifest,VERSION, andCHANGELOG.md.
Open a pull request with one skill or one coherent improvement. See plugin development for repository conventions.
Community
- Join the NotFair Discord
- Open an issue
- Star the repository if these workflows make your agent more useful