NotFair-MetaAds

io.github.nowork-studio由 GitHub 账号 nowork-studio 发布v0.1.0更新于 Oct 24, 2026

Meta Ads MCP (Facebook + Instagram) - analyze performance, manage budgets, pause campaigns.

已验证Streamable HTTP可网页运行数据与分析商业与电商

概览

AI 生成的概览

远程 Meta Ads MCP 服务器，让助手查看 Facebook 和 Instagram 广告表现、分析预算与素材，并执行经批准的广告系列变更。

可以做什么
  • 查看 Facebook 和 Instagram 的广告系列、广告组、素材与成效数据
  • 审计追踪设置、账户结构、受众、花费效率与扩量准备度
  • 分析预算与素材疲劳，撰写有数据依据的素材简报
  • 在用户授权范围内执行受支持的广告操作，例如暂停广告系列和调整预算
适用场景
当你希望助手审计或优化 Meta（Facebook 与 Instagram）广告账户、找出浪费的投放花费或制定素材更新计划，并愿意通过 OAuth 连接账户时适用。
运行要求
需访问 notfair.co 上的远程 MCP 端点（streamable HTTP），并在浏览器中完成 OAuth 登录。相关 Meta Ads 账户需在 OAuth 时选择的 NotFair 工作区中完成连接。未声明任何环境变量或请求头。
安装前请注意
OAuth 会授予服务器访问已连接广告账户的权限；请求的工具参数会发送至 NotFair，各平台返回的结果会回到你的 AI 客户端。部分操作会改动线上广告，包括暂停广告系列和调整预算，批准前请先审阅变更内容。只连接你打算使用的工作区和账户。

安装

在 SourceWeft 中

  1. 打开 控制台中的 NotFair-MetaAds，将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.nowork-studio%2Fnotfair-meta-ads/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。

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

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.

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:

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，提交 ed835f2

工具

0
该服务器需要登录，因此 SourceWeft 无法在没有账号的情况下读取其工具，也未收录。已连接账号所能看到的内容可能因账号及其权限而异。

版本历史

1
  1. v0.1.0最新Sep 16, 2026

评分

已满足适用检查项的 85%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分