mrkeyoor.com_
Tue 08 Sept 16:07 UTC
LLM Toolsevaluationupdated 08 Sept 2026

notfair-plugin review

NotFair Plugin is a collection of 45 open-source marketing procedures for Claude Code, Codex, Cursor, Gemini CLI, and compatible agents. It gives an agent detailed instructions for SEO, analytics, and paid-media work, while a hosted MCP connection supplies live account data and approved write actions.

Verdict

Our NotFair Plugin run installed 56 packages in 34 seconds and all 273 executed pytest cases passed, making the repository a low-friction trial for teams willing to inspect agent instructions. The strongest reason to use it is the combination of readable marketing procedures and one OAuth-connected MCP for live accounts. Skip it if hosted account access, agent write capability, or unresolved client segregation conflicts with company policy.

We ran it

Lab card: what happened when we ran notfair-pluginScreenshot of notfair-plugin (notfair.co)
Install✓ · 34s56 packages · 72 MB
Build✓ · 9s
Tests✓ · 11s273 passed · 0 failed · 15 skipped of 273 (pytest)
Known vulns0(pip-audit)
Repo661 files~66,729 lines of source · 4.7 MB · 3 CI workflows · tests dir

Answers from our run

Does notfair-plugin build from source?

Dependencies installed in 34 seconds (56 packages), and the build succeeded in 9 seconds. We cloned commit daf87d3 into a clean Debian container with 3 CPUs and no project-specific setup.

Do notfair-plugin's tests pass?

Yes: 273 of 273 passed when we ran the project's own test command (pytest). Some failures need services or credentials a bare container does not have.

Does notfair-plugin have known vulnerabilities in its dependencies?

pip-audit found none in the dependency tree at the time of our run.

Who should not use notfair-plugin?

Teams requiring all live account analysis to stay local: the README routes connected analytics and ad data through NotFair's hosted MCP and browser OAuth.

What are the alternatives to notfair-plugin?

Marketing Skills, Anthropic Skills, Superpowers. Our NotFair Plugin run installed 56 packages in 34 seconds and all 273 executed pytest cases passed, making the repository a low-friction trial for teams willing to inspect agent instructions.

Setup4/534-second install, 9-second build, and all executed tests passed
Docs5/5Host setup, skill routing, integrations, and safety rules are explicit
Community4/53,667 stars with issue and pull request activity in September
Maturity4/5v0.27.5 and 273 passing tests; open workflow bugs remain

Who it’s for

Marketing engineers who want readable agent instructions they can inspect and edit.
SEO teams combining crawls with Search Console, GA4, page-speed, and content data.
Paid-media operators who want proposed changes separated from approved account mutations.
Agencies prepared to design their own client isolation and review every account-level action.
Claude Code and Codex users who want a broad marketing plugin under an MIT license.

Who it’s NOT for

Teams requiring all live account analysis to stay local: the README routes connected analytics and ad data through NotFair's hosted MCP and browser OAuth.
Native Windows users who need every Bash helper to work from an automatic CRLF checkout: issue 102 documents a required preflight breaking, and pull request 116 was still open.
Agencies expecting built-in per-client skill segregation: issue 70 describes the flat Claude skills directory as a problem and asks how others handle it.
Buyers expecting live TikTok, Amazon, or ChatGPT Ads operations: the README limits those areas to planning or export review unless a verified connector is present.
Organizations that forbid AI agents from holding write-capable ad access: the plugin manifest declares write capability, and several supported ad workflows can execute authorized changes.

Setup reality

Our sandbox installed 56 Python packages in 34 seconds, using 72 MB on disk. The build succeeded in 9 seconds. Pytest then finished in 11 seconds with 273 passed, 0 failed, and 15 skipped of 273; pip-audit reported 0 known vulnerabilities.

The files alone handle URL, repository, or export-based work. Live Search Console, GA4, Google Ads, Meta Ads, X Ads, and LinkedIn Ads analysis needs the hosted NotFair MCP, browser OAuth, a selected workspace, and access to each underlying account. Gemini review also needs its own API or CLI authentication.

Host installation differs across Claude Code, Codex, Cursor, Kiro, and Gemini CLI. The repository has 661 files, about 66,729 source lines, three CI workflows, and a tests directory, but no Dockerfile. Windows and WSL users should check the open line-ending issue before relying on Bash preflights.

Forty-five skills cover search, analytics, and paid media

NotFair Plugin packages 45 procedures as readable SKILL.md files. They cover site and page audits, keyword work, metadata, structured data, local and international SEO, GEO, paid-media planning, and live account analysis. Each skill declares when an agent should use it, what inputs it needs, which actions require approval, and what output to produce. That makes review easier than a single hidden system prompt, and the MIT license permits teams to adapt the instructions.

The measured checkout had 661 files, roughly 66,729 lines of source, and occupied 4.7 MB. That size reflects more than prose. The repository includes scripts, references, manifests for several agent hosts, unit tests, LLM-judge evaluations, and an optional local goal application. A buyer should sample the exact skills they plan to run because quality can vary by workflow even when registration and policy tests pass.

One hosted MCP connects six named account platforms

The current README routes Google Search Console, GA4, Google Ads, Meta Ads, X Ads, and LinkedIn Ads through one NotFair MCP connection. Claude Code, Codex, Cursor, and Gemini CLI each have a documented installation path. Browser OAuth selects a NotFair workspace, after which the agent discovers the capabilities available for connected platforms. Repository-only audits can work without that account connection, which is useful for evaluating the writing before granting access.

Our install consumed 72 MB for 56 Python packages, a restrained dependency footprint for the repository checks. That number excludes an agent host, browser OAuth state, the hosted service, and any optional local application dependencies. A passing local setup therefore proves that the skill library can be validated; it does not prove that your Google or advertising accounts are connected, correctly scoped, or returning complete periods.

What happened when we ran it

Our sandbox installed the Python environment in 34 seconds, built the project in 9 seconds, and completed pytest in 11 seconds. Pytest reported 273 passed, 0 failed, and 15 skipped of 273 at commit daf87d3. Pip-audit found 0 known vulnerabilities in the installed packages. Those are clean repository mechanics, with no failure hidden behind a partial test result.

The run used a fresh unprivileged Python 3.12 Bookworm container with 3 CPUs and 8 GB of RAM. It did not connect to an advertising account, authorize OAuth, crawl a production site, or ask a model to execute a marketing workflow. The project had three CI workflow files and a tests directory, with no Dockerfile. Marketing correctness still needs a trial against representative inputs and a human review of every proposed account change.

Readable instructions still depend on the agent following them

A skill can tell an agent to compare complete date ranges, separate a proposal from a mutation, and avoid promising an unavailable connector. Those are good rules. They remain instructions interpreted by a model, so a team should keep approval and verification outside the model's discretion. The README itself says changes must stay within user authorization and be checked against resulting account state. For paid spend, that boundary belongs in operating procedure as well as prompt text.

The 273 passing cases cover the checked-out repository's automated suite, while 15 were skipped in our 11-second run. Neither figure is an accuracy score for SEO recommendations or ad decisions. Before adoption, choose two recurring tasks, save the source data, run the same prompts more than once, and compare the resulting actions with a senior operator's judgment. Instruction files make that audit possible because reviewers can point to the exact rule that needs changing.

Windows line endings can stop a required preflight

Issue 102 reports that bin/notfair-update-check, a required Bash preflight, can receive CRLF endings in a Windows checkout and fail before it runs. Pull request 116 adds line-ending rules and a regression check, but it was still open on September 8, 2026. Native Windows and WSL users should inspect whether that fix has landed or configure Git to preserve LF before treating installation as finished.

The same repository passed our 34-second Linux install and 11-second pytest run, so the Windows report is platform-specific rather than evidence of a general failure. Another open issue, 112, describes goal-agent provisioning treating a returned registration failure as success, which can leave required goal tools unavailable. Teams using the optional recurring-goal app should test failed registration and recovery, not infer that the clean core suite covers live provisioning.

Version 0.27.5 is active without a GitHub release

The repository's VERSION file and changelog identify 0.27.5, dated September 5, 2026. GitHub showed a last push that day, 3,667 stars, and 14 open issues and pull requests. New pull request activity appeared on September 8. The latest-release API returned no release, so updates are tracked through repository manifests and the changelog rather than a GitHub release page. The combined open count should not be read as 14 defects.

NotFair Plugin earns a trial because 56 dependencies installed cleanly, 273 executed tests passed, and the actual instructions can be audited. Its hosted data path and write-capable workflows deserve the same care as any account integration. Start with read-only work, inspect the selected skill, confirm the workspace and account, and require a human decision before spend or campaign state changes. Agencies should also settle client isolation before putting proprietary playbooks beside the shared 45-skill catalog.

Alternatives

ProjectWhat it isPick it when
Marketing Skills gh↗A marketing-focused skill collection covering CRO, copy, SEO, analytics, and growth work.pick this instead when you want a simpler marketing skill library without NotFair's hosted account connection.
Anthropic Skills gh↗Anthropic's public repository of example Agent Skills across several kinds of work.pick this instead when official examples and a general skill format matter more than deep marketing coverage.
Superpowers gh↗A general agent skill framework centered on software-development workflows.pick this instead when coding discipline and development process are the job, rather than SEO or paid media.

What people are saying

  1. [github-trending] nowork-studio/notfair-plugin

Sources

  1. NotFair Plugin README
  2. NotFair Plugin changelog
  3. Windows line-ending issue 102
  4. Windows line-ending pull request 116
  5. Goal-agent registration issue 112
  6. Agency skill segregation issue 70

More llm tools reviews

gpt4free · openai-agents-python · freecad-mcp · chat-on-steroids · my-free-code · claude-cookbooks · the whole board →