NotFair

io.github.nowork-studio由 GitHub 帳號 nowork-studio 發布v0.27.18更新於 Nov 7, 2026

OAuth MCP for Google, Meta, X, LinkedIn, Reddit, TikTok, GSC, GA4, WordPress and GHL.

已驗證Streamable HTTP可網頁執行效率與工作流資料與分析商業與電商

概覽

AI 產生的概覽

以 OAuth 連線的行銷 MCP，讓助理稽核 SEO、管理各平台付費廣告，並操作 GA4、Search Console、WordPress 與 GoHighLevel。

可以做什麼
  • 稽核網站與頁面的 SEO、GEO／AI 引用能見度、結構化資料、hreflang、網站地圖與反向連結，並規劃內容
  • 查詢即時 GA4 與 Search Console 資料，比較期間、檢查網址、管理網站地圖提交
  • 檢視並最佳化 Google、Meta、X、LinkedIn、Reddit、TikTok 的付費媒體，包括預算、定向與素材
  • 讀取並更新已連線的 WordPress 內容、媒體、設定與外掛
  • 讀取並變更 GoHighLevel 聯絡人、對話、商機與行事曆
  • 內含 48 個行銷技能包，附工作流程、參考資料與腳本，供相容的代理使用
適用情境
適合希望助理依據即時行銷資料、而非一般性建議來工作的情境：稽核網站、追查流量下滑、檢視廣告花費與 ROAS，或在 WordPress 與 CRM 中執行經核准的變更。
執行需求
位於 notfair.co 的遠端 streamable HTTP 端點，必須使用 OAuth；需完成瀏覽器 OAuth 流程並選擇工作區。各平台（Google、Meta、X、LinkedIn、Reddit、TikTok、GSC、GA4、WordPress、GoHighLevel）須先在該工作區連線後才能使用。選用的本機工作流程需要 Python 或 shell，Gemini 複核需要 Gemini API 金鑰。
安裝前請注意
此伺服器可變更實際帳戶：廣告預算、定向與素材、WordPress 內容與設定、CRM 紀錄。建議先做唯讀檢視再修改，並核對變更後的帳戶狀態。工具參數與結果會經 NotFair 傳送給已連線的供應商。本機腳本會使用網站憑證與 Google 登入資訊，請勿寫入報告或提交到程式庫。只連接你打算使用的帳戶。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 NotFair，將其新增到工作區。
  2. 連接 所需的 憑證。它們會被私密儲存，絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.nowork-studio%2Fnotfair/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。 客戶端會在首次連接時完成 OAuth 登入。

{
  "mcpServers": {
    "notfair": {
      "type": "http",
      "url": "https://notfair.co/api/mcp/notfair"
    }
  }
}

README

NotFair Plugin

[License: MIT] [Discord]

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

AreaExamples
SEOFull-site and page audits, keyword research, content planning, technical SEO, schema, local SEO, international SEO, e-commerce SEO, and regression monitoring
GEO / AEOImprove content for citation and visibility in ChatGPT, Perplexity, Gemini, Claude, and Google AI Overviews
Paid mediaPlan, review, and optimize cross-channel campaigns with explicit budgets, measurement, and approval boundaries
Google AdsAudit accounts, analyze search terms, manage keywords and budgets, write RSA copy, plan assets, and diagnose landing pages
Meta AdsReview Facebook and Instagram performance, diagnose creative fatigue, assess audiences, and create evidence-based creative briefs
X AdsAnalyze campaigns and line items, review conversion performance, manage targeting and creative, and execute approved changes
LinkedIn AdsConnect B2B media to lead quality, analyze campaign groups and campaigns, and manage targeting, creative, conversions, and leads
Reddit AdsAnalyze campaigns, ad groups, and ads, review conversions and audiences, and execute approved Reddit Ads changes
TikTok AdsAnalyze connected TikTok advertisers, review delivery and creative performance, and execute approved campaign changes
WordPressRead and update connected WordPress content, media, comments, design, settings, plugins, and approved site changes
GoHighLevelRead contacts, conversations, opportunities, and calendars, then make only explicitly requested CRM changes
AnalyticsQuery live GA4 and Search Console data, compare complete periods, inspect URLs, manage sitemaps, and update supported measurement configuration
ContentTurn search demand into editorial plans, briefs, articles, landing pages, metadata, and structured data

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:

text
/plugin marketplace add nowork-studio/notfair-plugin/plugin install notfair@nowork-studio

Then ask for the workflow you need:

text
/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.

Grok Bot and Cursor

The repository includes a native Cursor manifest and a portable Agent Plugins manifest for compatible hosts. Marketplace submission does not imply approval. See the xAI marketplace review guide for reviewer setup, test prompts, and expected results.

In Grok Bot, open Connect apps and look for NotFair once its public listing is approved. In Cursor, install NotFair from its plugin marketplace once available. 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 the agent 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:

bash
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:

bash
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:

bash
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.

bash
git clone https://github.com/nowork-studio/notfair-plugin.gitcd notfair-plugin

If the nowork-studio marketplace is already configured, refresh it instead:

bash
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:

text
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:

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

SkillWhat it does
seo-analysisAudits a full site with Search Console and crawl data, then prioritizes the highest-impact fixes.
seo-pagePerforms a deep audit of one URL for intent, content, structure, and on-page SEO.
content-writerWrites or improves search-led articles, landing pages, and service pages.
content-plannerTurns Search Console opportunities into a prioritized, dated editorial calendar.
keyword-researchBuilds a keyword universe, classifies intent, and organizes topic clusters.
meta-tags-optimizerImproves titles, meta descriptions, Open Graph tags, and SERP click-through potential.
schema-markup-generatorCreates and validates JSON-LD structured data.
broken-link-checkerFinds broken internal and external links and reports site-health issues.
geo-optimizerAudits and rewrites content for citation in AI search and answer engines.
local-seoReviews Google Business Profile, local pages, NAP consistency, reviews, and local schema.
hreflang-internationalDiagnoses hreflang, canonical, language, and regional targeting problems.
sitemap-auditChecks XML sitemap structure, freshness, coverage, and URL validity.
image-seoReviews alt text, formats, compression, responsive images, CLS, and image discovery.
ecommerce-seoAudits product pages, category pages, variants, faceted navigation, and product schema.
programmatic-seoPlans useful templated pages at scale with demand, uniqueness, and indexation guardrails.
competitor-pagesCompares ranking pages and produces a practical SERP brief.
sxoConnects search visibility and SERP CTR to the post-click conversion experience.
seo-driftCreates a baseline and detects ranking, metadata, canonical, and indexation regressions.
backlink-auditReviews referring domains, anchor text, link risk, and internal-link opportunities.
setup-cmsLocal Application-Password / .env.local setup for SEO scripts against WordPress, Strapi, Contentful, or Ghost.

Paid media

SkillWhat it does
paid-adsRoutes broad paid-media questions to the right channel and workflow.
paid-ads-setupConnects accounts and captures business, economics, tracking, and budget context.
paid-ads-launchProduces a reviewable campaign or multi-channel experiment plan before spend begins.
paid-ads-reviewCreates comparable weekly or monthly scorecards and checks tracking health.
paid-ads-optimizeFinds waste and pacing problems, then proposes narrow, reversible changes.
paid-ads-creativeDevelops cross-channel concepts, claim ledgers, fatigue hypotheses, and test briefs.
paid-ads-xAudits and operates connected X Ads campaigns, line items, targeting, creative, audiences, and budgets.
paid-ads-linkedinAudits and operates connected LinkedIn Ads around qualified pipeline outcomes.
paid-ads-redditAudits and operates connected Reddit Ads campaigns, ad groups, ads, audiences, pixels, and budgets.
paid-ads-tiktokAudits and operates connected TikTok Ads delivery, creative, targeting, and budgets.
paid-ads-amazonPlans and reviews Amazon Ads with margin-aware ACoS guardrails.
paid-ads-chatgptDesigns bounded ChatGPT Ads experiments or reviews verified exports.
paid-ads-integrationsVerifies connector, account, and tool access before promising a capability.
paid-ads-guideExplains installation, supported platforms, limits, and troubleshooting.

Google Ads

SkillWhat it does
google-ads-auditScores account health, validates tracking, and finds wasted spend.
google-adsReviews performance and manages supported keywords, bids, budgets, negatives, and campaigns.
google-ads-copyWrites compliant RSA headlines and descriptions with test variants.
google-ads-assetsPlans sitelinks, callouts, snippets, image assets, and Performance Max briefs.
google-ads-landingDiagnoses keyword-to-ad-to-page relevance and landing-page quality.

Meta Ads

SkillWhat it does
meta-ads-auditAudits tracking, structure, creative health, audiences, spend efficiency, and scaling readiness.
meta-adsReviews Facebook and Instagram performance and executes supported campaign operations.
meta-ads-creativeProduces evidence-based concepts, copy angles, UGC briefs, and refresh experiments.

Analytics

SkillWhat it does
google-analyticsAnalyzes live GA4 acquisition, engagement, pages, events, and conversions and safely manages supported measurement configuration.
search-consoleAnalyzes live Search Console queries and pages, inspects URLs, and manages approved sitemap submissions.

WordPress

SkillWhat it does
wordpressOperates connected WordPress sites: content, media, comments, design, settings, plugins, themes, and approved HTML or admin changes.

CRM

SkillWhat it does
gohighlevelOperates connected GoHighLevel contacts, conversations, opportunities, calendars, and other approved CRM changes.

Cross-model review and maintenance

SkillWhat it does
geminiUses Google Gemini for a second opinion, adversarial challenge, or open consultation.
upgradeUpdates an installed NotFair plugin and summarizes what changed.

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.

Data sourceUsed forConnection
Google Search ConsoleSearch performance, queries, pages, indexing, URL inspection, and sitemapsOne NotFair connection
Google Analytics 4Acquisition, engagement, landing pages, events, conversions, realtime, and measurement configurationOne NotFair connection
Google AdsCampaign performance, search terms, bids, budgets, keywords, and change historyOne NotFair connection
Meta AdsFacebook and Instagram campaigns, ad sets, creatives, and insightsOne NotFair connection
X AdsCampaigns, line items, performance, targeting, promoted posts, audiences, and approved mutationsOne NotFair connection
LinkedIn AdsCampaign groups, campaigns, creatives, analytics, targeting, conversions, and leadsOne NotFair connection
Reddit AdsCampaigns, ad groups, ads, reporting, audiences, pixels, funding instruments, and approved mutationsOne NotFair connection
TikTok AdsAdvertiser delivery, reporting, creative, targeting, and approved mutationsOne NotFair connection
WordPressConnected site content, media, comments, design, settings, plugins, themes, and approved mutationsOne NotFair connection
GoHighLevelContacts, conversations, opportunities, calendars, and approved CRM mutationsOne NotFair connection
Other CMS platformsLocal SEO-script content review in Strapi, Contentful, or Ghostsetup-cms Application Password / API token, not NotFair MCP
Google GeminiCross-model reviewGemini API key

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

text
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:

text
seo/your-skill-name/├── WORKFLOW.md       # full instructions and frontmatter├── references/       # optional supporting knowledge└── scripts/          # optional deterministic tooling

When adding or changing a skill:

  1. Keep the workflow focused on one clear marketing job.
  2. Use imperative, testable instructions in WORKFLOW.md, and keep the entry point under skills/ in sync.
  3. Add or update eval coverage.
  4. Update AGENTS.md, the plugin manifest, VERSION, and CHANGELOG.md.

Open a pull request with one skill or one coherent improvement. See plugin development for repository conventions.

Community

License

MIT

來源：README.md，提交 f70e360

工具

0
該伺服器需要登入，因此 SourceWeft 無法在沒有帳號的情況下讀取其工具，也未收錄。已連接帳號所能看到的內容可能因帳號及其權限而異。

版本歷史

10
  1. v0.27.18最新Nov 7, 2026
  2. v0.27.16Oct 9, 2026
  3. v0.27.15Oct 1, 2026
  4. v0.27.14Sep 25, 2026
  5. v0.27.12Sep 24, 2026
  6. v0.27.11Sep 22, 2026
  7. v0.27.10Sep 21, 2026
  8. v0.27.9Sep 19, 2026
  9. v0.27.8Sep 17, 2026
  10. v0.27.7Sep 16, 2026

評分

已滿足適用檢查項的 85%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分