# NotFair Plugin

45 open SEO, GEO, content, and ads skills for coding agents, plus a hosted MCP for live ad and analytics accounts.

An MIT-licensed plugin of 45 SKILL.md workflows for Claude Code, Codex, Cursor, Gemini CLI, and other agents: site and page SEO audits, keyword and content planning, GEO optimization, content writing, and Google, Meta, X, and LinkedIn ads work. Skills run locally as prompt files; live account access (GA4, Search Console, ad platforms) goes through the Builder's hosted NotFair MCP with OAuth. Adapting means editing the skill files.

Alternative to: Semrush, Ahrefs

- Capabilities: adaptable, operable
- Vertical: content-publishing
- Shape: skill
- Form factor: skill
- Execution model: hybrid
- Provenance: unknown (recorded, never ranked)
- Repo: https://github.com/nowork-studio/notfair-plugin (MIT), 3449 stars, last commit 2026-08-29
- Last activity: 2026-08-29
- Page: apps/nowork-studio--notfair-plugin.html
- JSON: apps/nowork-studio--notfair-plugin.json

## Use it when

- I want my coding agent to audit my site and write the fixes and content, using procedures I can read and tune
- I manage ad accounts and want an agent to find wasted spend and propose changes I approve

## Gotchas

- Skills that touch live accounts need the hosted NotFair MCP: 7 days unlimited, then 300 operations per month on the free tier
- The hosted MCP is where account data flows; the open repo is the procedures, not the connector
- Vertical fit is marketing and SEO more than publishing; only the content-writer and GEO skills produce publishable material
- Renamed from TopRank after its Show HN; older references use the old name

## Editions

- Free: Free, open source
  - source: https://github.com/nowork-studio/notfair-plugin
  - installable: /plugin marketplace add nowork-studio/notfair-plugin && /plugin install notfair@nowork-studio
  - hosted: https://notfair.co/
- Growth: $79 per month, closed source
  - hosted: https://notfair.co/

## Adaptable: make it yours

Effort: config-only (14 things to edit)

Every skill is a readable SKILL.md with references and scripts; change the decision rules, output format, or brand standards by editing those files. plugin.json, mcp.json, .mcp.json, gemini-extension.json, and the server-*.json files wire the plugin into each host and point at the hosted MCP; AGENTS.md maps requests to skills. The README calls it forkable on purpose.

- Env vars: none
- Config files: plugin.json, mcp.json, .mcp.json, server.json, server-google-ads.json, server-meta-ads.json, gemini-extension.json, AGENTS.md
- Prompt files: seo/*/SKILL.md, google-ads/*/SKILL.md, meta-ads/*/SKILL.md, paid-ads/*/SKILL.md, analytics/*/SKILL.md, skills/*/SKILL.md
- Accounts you'll need: NotFair (for hosted MCP live data); Google Ads, Meta Ads, X Ads, LinkedIn Ads, GA4, Search Console (connected over OAuth through NotFair)

## Operable: what an agent can drive

Operability: native. Interface: mcp at https://github.com/nowork-studio/notfair-plugin (published by the builder, both).

### Reach (partial coverage)

- Audit a full site's SEO: reachable. seo-analysis skill (README catalog)
- Audit one page: reachable. seo-page skill
- Keyword research and content planning: reachable. README SEO area: keyword research, content planning
- Optimize content for AI answer engines (GEO): reachable. geo-optimizer skill
- Write articles, briefs, and metadata: reachable. content-writer skill; README Content area
- Query live GA4 and Search Console data: reachable. google-analytics and search-console skills through hosted MCP; needs NotFair account and OAuth
- Audit and change Google Ads: reachable. google-ads-audit skill; writes are approval-gated per notfair.co
- Review Meta Ads creative and audiences: reachable. meta-ads-creative skill through hosted MCP
- Manage X and LinkedIn Ads: reachable. paid-ads-x and LinkedIn skills through hosted MCP
- Publish the content it writes: not reachable. no publishing target in the skill catalog; pair with a CMS or scheduler listing

## Code stack

- Languages: Markdown, Python, TypeScript
- Frameworks: none
- Package manager: pip
- Database: none
- Hosting target: agent plugin marketplaces (Claude Code, Codex, Cursor, Kiro, Gemini CLI)

## Model stack

- Providers: any agent host (Claude, Codex, Gemini, Hermes)
- Models: none
- Keys you need (names only): none
- Prompts live in: seo/*/SKILL.md, google-ads/, meta-ads/, paid-ads/, analytics/, skills/, AGENTS.md
- Tools: hosted NotFair MCP at notfair.co/api/mcp/notfair

## Skills

pure: Skill pack is the product; the hosted MCP only feeds live ad and analytics accounts into the skills.
- Paths: analytics/*/SKILL.md, google-ads/*/SKILL.md, meta-ads/*/SKILL.md, paid-ads/*/SKILL.md, gemini/SKILL.md, notfair-upgrade-skill/SKILL.md
- Install: /plugin marketplace add nowork-studio/notfair-plugin

## Evidence and confidence

- formFactor: README: installs as a plugin marketplace of SKILL.md files for Claude Code, Codex, Cursor, Kiro, Gemini CLI (confidence 0.95)
- executionModel: skills are fixed procedures the host model follows; live data comes from MCP tools (confidence 0.85)
- operability: the skills and the org's hosted MCP (mcp.json points at notfair.co/api/mcp/notfair) are the interface itself, published by the same org (confidence 0.9)
- effort: README: 'Every skill is built in the open as a readable SKILL.md'; plugin.json and mcp.json at repo root (confidence 0.9)
- editions: notfair.co: free tier then 300 MCP ops per month; Growth $79 per month; repo MIT (confidence 0.8)
- active: pushedAt 2026-08-29; plugin.json version 0.27.2
- provenance: CLAUDE.md and AGENTS.md present; no statement of how the skills were authored (confidence 0.4)
- reach:  (confidence 0.85)

## Open questions

- Which skills work fully offline without the hosted MCP? README implies SEO and content skills do
- Should the Curator route this to a marketing vertical rather than content-publishing?

## Sources

- https://github.com/nowork-studio/notfair-plugin (sourcing:content-publishing:community)
- https://notfair.co/ (analysis:content-publishing)
- https://news.ycombinator.com/item?id=47724937 (sourcing:content-publishing:community)
