AdsAgent

NotFair 插件

面向 AI Agent 的开源 SEO、GEO 和营销技能。

NotFair 插件为 Claude Code、Codex、Hermes 和其他兼容的 Agent 提供实用的营销工作流，而不是又一套通用提示词。你可以用它审核网站、调查流量下滑、分析 GA4 和 Search Console 数据、找出 Google、Meta、X、LinkedIn、Reddit 和 TikTok 上浪费的广告支出、操作已连接的 WordPress 和 GoHighLevel 账户、制定营销活动计划，并实施可供审核的变更。

每项技能都有一个易于发现的 skills/<name>/SKILL.md 入口文件。该文件会加载类别文件夹中的 WORKFLOW.md，并按需提供参考资料、脚本和评测。你可以检查、调整这些工作流，也可以贡献更好的工作流。

你的 Agent 能做什么

领域	示例
SEO	全站和页面审核、关键词研究、内容规划、技术 SEO、结构化数据、本地 SEO、国际 SEO、电商 SEO 和回归监控
GEO / AEO	优化内容，提升其在 ChatGPT、Perplexity、Gemini、Claude 和 Google AI Overviews 中的引用率和可见度
付费媒体	规划、审核并优化跨渠道营销活动，明确预算、衡量方式和审批边界
Google Ads	审核账户、分析搜索字词、管理关键词和预算、撰写 RSA 文案、规划素材并诊断落地页
Meta Ads	查看 Facebook 和 Instagram 的效果、诊断创意疲劳、评估受众，并创建以证据为依据的创意简报
X Ads	分析营销活动和广告系列项、查看转化效果、管理定向和创意，并执行已批准的变更
LinkedIn Ads	将 B2B 媒体投放与潜在客户质量关联起来，分析营销活动组和营销活动，并管理定向、创意、转化和潜在客户
Reddit Ads	分析营销活动、广告组和广告，查看转化和受众，并执行已批准的 Reddit Ads 变更
TikTok Ads	分析已连接的 TikTok 广告主，查看投放和创意效果，并执行已批准的营销活动变更
WordPress	读取和更新已连接的 WordPress 内容、媒体、评论、设计、设置、插件和已批准的网站变更
GoHighLevel	读取联系人、对话、商机和日历，然后仅执行明确要求的 CRM 变更
分析	查询实时 GA4 和 Search Console 数据、比较完整时间段、检查 URL、管理站点地图并更新受支持的衡量配置
内容	将搜索需求转化为编辑计划、简报、文章、落地页、元数据和结构化数据

NotFair 插件目前包含 48 项技能，涵盖 SEO、GEO、付费媒体、广告平台、分析、WordPress、CRM 和跨模型审核。

快速开始

Claude Code

从其市场安装 NotFair 插件：

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

然后提出你需要的工作流：

/notfair:seo-analysis
/notfair:geo-optimizer
/notfair:google-ads-audit
/notfair:meta-ads-creative
/notfair:paid-ads-x
/notfair:google-analytics
/notfair:search-console

你也可以使用日常语言：

审核我的网站，并告诉我自然流量下滑的原因。

找出有望在 AI 答案中获得引用的页面。

检查上个月的广告支出，并展示提升 ROAS 最稳妥的机会。

Cursor

从 Cursor 插件市场安装 NotFair。该插件会加载本仓库中的 开源营销技能，并注册一个托管的 NotFair MCP 连接。按照 Cursor 的提示 完成浏览器 OAuth 流程，然后让 Cursor 审核广告账户、分析 GA4 或 Search Console，或运行下方列出的 SEO 和 GEO 工作流。

如果在市场上架前进行本地测试，请将此仓库克隆到 Cursor 的本地插件目录：

git clone https://github.com/nowork-studio/notfair-plugin.git ~/.cursor/plugins/local/notfair

安装或更新本地插件后，请重启 Cursor。

Kiro Powers

在 Kiro 的 Powers 面板中将公开仓库安装为自定义 Power，或在其条目获批后，从 Powers 注册表中查找 NotFair。根目录中的 plugin.json 和 mcp.json 遵循 Agent Plugins 1.0 规范。

Gemini CLI

直接从 GitHub 安装扩展：

gemini extensions install https://github.com/nowork-studio/notfair-plugin

该扩展会加载仓库指南和通用 NotFair MCP。收到身份验证请求时，在 Gemini CLI 中运行 /mcp auth NotFair。

Codex、Hermes 和其他 Agent

通过 Codex 直接安装通用 NotFair 插件：

codex plugin marketplace add nowork-studio/notfair-plugin --json && codex plugin add notfair@nowork-studio --json && codex mcp login NotFair

Codex 会安装技能、注册一个 NotFair MCP 连接，并打开其 OAuth 流程。如果你更喜欢仅在工作区使用的本地检出版本，请克隆仓库并将其作为工作区打开；AGENTS.md 会将营销请求对应到合适的技能。

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

如果已配置 nowork-studio 市场，请改为刷新：

codex plugin marketplace upgrade nowork-studio --json && codex plugin add notfair@nowork-studio --json && codex mcp login NotFair

如需针对特定宿主的设置说明，请将 INSTALL_FOR_AGENTS.md 提供给你的 Agent，或粘贴：

Retrieve and follow the instructions at:
https://raw.githubusercontent.com/nowork-studio/notfair-plugin/main/INSTALL_FOR_AGENTS.md

指南与对比

关于将广告账户连接到 AI Agent 以及如何选择设置方案的背景阅读：

• Google Ads MCP 服务对比
• Meta Ads MCP 服务对比
• Google Ads 的 Claude 连接器对比
• Meta Ads 的 Claude 连接器对比
• 如何将 Google Ads 连接到 Claude
• 如何将 Meta Ads 连接到 Claude
• Google Ads MCP 概览
• Meta Ads MCP 概览

为什么使用技能，而不是一个庞大的营销 Agent？

如果每个请求都由同一个模糊的提示词处理，营销工作就会变得不可靠。NotFair Plugin 将工作拆分为专注且可测试的流程。

• **专业化：**每项技能都有明确的职责、必需输入、决策规则和输出格式。
• **以证据为依据：**实时数据工作流会使用 Search Console、Google Analytics、Google Ads、Meta Ads、X Ads、LinkedIn Ads、Reddit Ads、TikTok Ads、WordPress 或 GoHighLevel，而不是根据泛泛的最佳实践进行猜测。
• **安全至上：**先进行只读审查，再执行变更；付费媒体变更会明确说明；绝不暗示不受支持的功能。
• **不依赖特定宿主：**规范技能以纯文件形式提供，而非将逻辑限制在某个 Agent 运行时中。
• **可分叉：**所有内容均采用 MIT 许可，团队可以审查并根据自身标准调整工作流。

技能目录

SEO 和 GEO

技能	功能
seo-analysis	使用 Search Console 和抓取数据审查整个网站，然后按优先级列出影响最大的修复项。
seo-page	深入审查单个 URL 的搜索意图、内容、结构和页面 SEO。
content-writer	撰写或改进以搜索为导向的文章、着陆页和服务页面。
content-planner	将 Search Console 中的机会转化为按优先级排序并标注日期的编辑日历。
keyword-research	构建关键词集合、分类搜索意图并整理主题集群。
meta-tags-optimizer	改进标题、元描述、Open Graph 标签和搜索结果页的点击潜力。
schema-markup-generator	创建并验证 JSON-LD 结构化数据。
broken-link-checker	查找失效的内部和外部链接，并报告网站健康问题。
geo-optimizer	审查并改写内容，使其适合在 AI 搜索和答案引擎中被引用。
local-seo	检查 Google 商家资料、本地页面、NAP 一致性、评价和本地结构化数据。
hreflang-international	诊断 hreflang、canonical、语言和区域定位问题。
sitemap-audit	检查 XML 站点地图的结构、更新情况、覆盖范围和 URL 有效性。
image-seo	检查替代文本、格式、压缩、响应式图像、CLS 和图像发现情况。
ecommerce-seo	审查产品页面、类别页面、变体、分面导航和产品结构化数据。
programmatic-seo	在需求、独特性和收录防护措施的约束下，规划大规模创建实用的模板化页面。
competitor-pages	对比排名页面并生成实用的 SERP 简报。
sxo	将搜索曝光度和 SERP 点击率与点击后的转化体验联系起来。
seo-drift	建立基准，并检测排名、元数据、canonical 和收录情况的退化。
backlink-audit	检查引荐域名、锚文本、链接风险和内部链接机会。
setup-cms	为针对 WordPress、Strapi、Contentful 或 Ghost 的 SEO 脚本设置本地 Application-Password / .env.local。

付费媒体

技能	功能
paid-ads	将广泛的付费媒体问题引导至合适的渠道和工作流。
paid-ads-setup	连接账户，并收集业务、经济效益、跟踪和预算相关背景信息。
paid-ads-launch	在开始投放前，制定可供审核的广告系列或多渠道实验计划。
paid-ads-review	创建可比较的周度或月度记分卡，并检查跟踪状况。
paid-ads-optimize	找出浪费和投放节奏问题，然后提出范围有限、可撤销的调整。
paid-ads-creative	制定跨渠道创意概念、宣传主张清单、创意疲劳假设和测试简报。
paid-ads-x	审核并管理已连接的 X Ads 广告系列、广告项、定向、创意、受众和预算。
paid-ads-linkedin	围绕合格的销售管道成果，审核并管理已连接的 LinkedIn Ads。
paid-ads-reddit	审核并管理已连接的 Reddit Ads 广告系列、广告组、广告、受众、像素和预算。
paid-ads-tiktok	审核并管理已连接的 TikTok Ads 投放、创意、定向和预算。
paid-ads-amazon	制定并审核 Amazon Ads 计划，并设置考虑利润率的 ACoS 防护指标。
paid-ads-chatgpt	设计范围明确的 ChatGPT Ads 实验，或审核经过验证的导出数据。
paid-ads-integrations	在承诺某项能力前，验证连接器、账户和工具的访问权限。
paid-ads-guide	说明安装方式、支持的平台、限制和故障排除方法。

Google Ads

技能	功能
google-ads-audit	评估账户健康状况、验证跟踪并找出浪费的支出。
google-ads	审核成效并管理受支持的关键词、出价、预算、否定关键词和广告系列。
google-ads-copy	编写符合规范的 RSA 标题和描述，并提供测试变体。
google-ads-assets	规划附加链接、附加宣传信息、结构化摘要、图片素材和 Performance Max 简报。
google-ads-landing	诊断关键词、广告与页面之间的相关性以及落地页质量。

Meta Ads

技能	功能
meta-ads-audit	审核跟踪、结构、创意表现、受众、支出效率和扩量准备情况。
meta-ads	审核 Facebook 和 Instagram 的成效，并执行受支持的广告系列操作。
meta-ads-creative	制定以证据为依据的创意概念、文案角度、UGC 简报和创意更新实验。

分析

技能	功能
google-analytics	分析 GA4 实时获客、互动、页面、事件和转化数据，并安全管理受支持的衡量配置。
search-console	分析 Search Console 实时查询和页面、检查 URL，并管理获批的站点地图提交。

WordPress

技能	功能
wordpress	管理已连接的 WordPress 网站：内容、媒体、评论、设计、设置、插件、主题，以及获批的 HTML 或管理后台更改。

CRM

技能	功能
gohighlevel	管理已连接的 GoHighLevel 联系人、对话、商机、日历和其他获批的 CRM 更改。

跨模型审查与维护

技能	功能
gemini	使用 Google Gemini 提供第二意见、进行对抗性审查或开放式咨询。
upgrade	更新已安装的 NotFair 插件，并总结变更内容。

实时数据与集成

有些技能完全基于代码仓库、URL 或提供的导出文件运行。实时账户分析使用一个通过 OAuth 连接的 通用 NotFair MCP。该插件只注册一个名为 NotFair 的服务，供所有受支持的平台共用。

Agent 会根据实时服务的指令和能力说明选择工具。技能提供营销工作流和证据标准，而不会将 MCP 工具名称或调用顺序硬编码。有关手动配置以及从旧版逐平台连接迁移的说明，请参阅连接与升级指南。在 OAuth 期间选定的 NotFair 工作区中完成连接后，相应平台即可使用。请遵循服务返回的任何账户设置指南。

数据来源	用途	连接方式
Google Search Console	搜索表现、查询、页面、索引、URL 检查和站点地图	一个 NotFair 连接
Google Analytics 4	获客、互动、着陆页、事件、转化、实时数据和衡量配置	一个 NotFair 连接
Google Ads	广告系列表现、搜索字词、出价、预算、关键字和变更历史	一个 NotFair 连接
Meta Ads	Facebook 和 Instagram 广告系列、广告组、创意素材和数据分析	一个 NotFair 连接
X Ads	广告系列、广告系列项、表现、定向、推广帖子、受众和经批准的变更	一个 NotFair 连接
LinkedIn Ads	广告系列组、广告系列、创意素材、分析、定向、转化和潜在客户	一个 NotFair 连接
Reddit Ads	广告系列、广告组、广告、报告、受众、像素、资金工具和经批准的变更	一个 NotFair 连接
TikTok Ads	广告主投放、报告、创意素材、定向和经批准的变更	一个 NotFair 连接
WordPress	已连接的网站内容、媒体、评论、设计、设置、插件、主题和经批准的变更	一个 NotFair 连接
GoHighLevel	联系人、对话、商机、日历和经批准的 CRM 变更	一个 NotFair 连接
其他 CMS 平台	在 Strapi、Contentful 或 Ghost 中审查本地 SEO 脚本内容	setup-cms 应用程序密码 / API 令牌，不使用 NotFair MCP
Google Gemini	跨模型审查	Gemini API 密钥

受支持的账户操作由实时连接提供。变更必须遵循用户的授权，并根据变更后的账户状态进行验证。除非当前 Agent 会话提供经过验证的连接器，否则 Amazon 和 ChatGPT Ads 仍仅支持规划或审查导出文件的工作流。setup-cms 是本地 SEO 脚本凭据配置向导；实时 WordPress 操作使用 /notfair:wordpress。

隐私与支持

该插件通过浏览器 OAuth 连接到声明的 NotFair MCP 端点。 请求的工具参数会发送至 NotFair，已连接服务商返回的结果会发送至你授权的 AI 客户端。有关存储、保留和删除详情，请参阅隐私政策。请仅连接你打算使用的工作区和平台账号。

可选的本地工作流会运行可读的 Python 或 shell 脚本。爬虫会请求你提供的 URL；直接运行的 Search Console 脚本会使用你明确授权的 Google Cloud 登录；CMS 脚本会使用你通过 setup-cms 配置的站点凭据。Gemini 审核会在完成身份验证设置后，将所选审核上下文发送至 Google 的 Gemini CLI。请明确选择这些工作流，勿将凭据放入报告或提交中；如果可用，请使用 OAuth MCP 执行实时平台操作。没有自动插件钩子或本地 MCP 服务。日历查看器通过 loopback 提供本地规划数据，可选的更新检查器会读取 GitHub 上的公开版本文件。

独立的 NotFair Next.js 博客库现已迁至自己的公开代码库，并通过其 GitHub 版本发布。其源代码和发布工作流不再与这个 AI Agent 插件捆绑。已停用的 NotFair CMO 应用也不再包含在内。

• 隐私政策
• 服务条款
• 产品与集成支持
• 支持与社区
• 问题跟踪器

在技能中，连接器使用与工具无关的占位符，例如 ~~google-ads、~~meta-ads、~~x-ads、~~linkedin-ads、~~reddit-ads、~~tiktok-ads、~~search-console、~~google-analytics、~~wordpress 和 ~~gohighlevel。Agent 会将每个占位符解析为当前会话中可用的兼容工具，因此工作流不会绑定到某个 MCP 命名空间。

代码库结构

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 是通用入口。它会将用户意图映射到规范的 SKILL.md，并说明每个工作流所需的外部依赖。

贡献

每项技能都位于各自的类别文件夹中：

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

添加或修改技能时：

1. 让工作流专注于一项明确的营销任务。
2. 在 WORKFLOW.md 中使用祈使式、可测试的指令，并确保 skills/ 下的入口文件与其保持同步。
3. 添加或更新评测覆盖范围。
4. 更新 AGENTS.md、插件清单、VERSION 和 CHANGELOG.md。

请针对一项技能或一项连贯的改进提交拉取请求。有关代码库规范，请参阅插件开发。

社区

• 加入 NotFair Discord
• 提交问题
• 如果这些工作流能让你的 Agent 更实用，请为代码库点星

许可证

MIT