用途定位
toprank（仓库标识 nowork-studio/notfair-plugin）是一套面向 AI 智能体的开源 SEO、GEO 与营销技能集合，采用 MIT 许可。它的目标不是提供另一个通用提示词合集，而是给 Claude Code、Codex、Hermes、Cursor、Kiro、Gemini CLI 等兼容智能体提供可以实际遵循的营销工作流。
主要能力
仓库当前包含 48 项技能，横跨 SEO、GEO、付费媒体、广告平台、分析、WordPress、CRM 与跨模型审查等类别。借助这些技能，智能体可以：
- 审计网站，或调查自然流量下滑的原因；
- 分析 GA4 与 Search Console 数据；
- 在 Google、Meta、X、LinkedIn、Reddit、TikTok 等平台排查浪费的广告支出；
- 操作已连接的 WordPress 与 GoHighLevel 账户；
- 制定营销活动计划，并产出可复核的变更；
- 寻找可能在 AI 回答中获得引用的页面（GEO 相关）。
每项技能都有唯一的可发现入口 skills/<name>/SKILL.md，该入口会加载对应类别文件夹中可读的 WORKFLOW.md，并按需附带参考资料、脚本和评估用例。使用者可以检查、调整或贡献更优的工作流。
使用方式
仓库兼容 Agent Plugins 1.0 规范，根目录的 plugin.json 与 mcp.json 遵循该规范。可按宿主环境采用不同安装路径：
- 从市场安装 NotFair 插件，然后直接提出所需工作流；也可以使用自然语言，例如“审计我的网站并说明自然流量为何下降”“找出可能在 AI 回答中获得引用的页面”“检查上个月的广告支出并指出提高 ROAS 最安全的优化机会”。
- 在 Cursor 中，从插件市场安装；插件会加载本仓库的开源营销技能，并注册一个托管的 NotFair MCP 连接。按 Cursor 提示完成浏览器 OAuth 流程后即可使用。市场列表可用前，可将仓库克隆到 Cursor 的本地插件目录进行本地测试，安装或更新本地插件后需重启 Cursor。
- 在 Kiro 中，从 Powers 面板将公开仓库安装为自定义 power；列表获批后也可在 Powers 注册表中找到 NotFair。
- 在 Gemini CLI 中，可直接从 GitHub 安装扩展；扩展会加载仓库指引与通用 NotFair MCP，需要认证时运行 /mcp auth NotFair。
- 在 Codex 中，可直接通过 Codex 安装通用 NotFair 插件：Codex 会安装技能、注册一个 NotFair MCP 连接并打开其 OAuth 流程。若偏好工作区本地检出，可克隆仓库并作为工作区打开，AGENTS.md 会把营销请求映射到合适的技能。若 nowork-studio 市场已配置，可改为刷新该市场。
针对具体宿主的配置，可把 INSTALL_FOR_AGENTS.md 提供给智能体，或按该文件说明粘贴相应内容。
设计思路
仓库选择“技能拆分”而非“单一巨型营销智能体”，原因是营销任务在同一套模糊提示下会变得不可靠。NotFair 插件把工作拆分为聚焦、可测试的流程：
- 专门化：每项技能都有明确职责、必需输入、决策规则和输出格式。
- 以证据为导向：实时数据工作流使用 Search Console、Google Analytics、Google Ads、Meta Ads、X Ads、LinkedIn Ads、Reddit Ads、TikTok Ads、WordPress 或 GoHighLevel，而不是仅凭通用最佳实践猜测。
- 默认安全：只读审查先于变更，付费媒体改动保持显式，不暗示不支持的能力。
- 与宿主无关：规范技能是普通文件，而非锁定在某个智能体运行时中的逻辑。
- 可复刻：全部采用 MIT 许可，团队可审查并调整流程以符合自身标准。
此外还包含跨模型审查与维护相关内容，例如 Gemini review 会在完成认证设置后，把选定的审查上下文发送给 Google 的 Gemini CLI。
实时数据与集成
部分技能完全基于仓库、URL 或提供的导出文件运行；实时账户分析则使用一个通过 OAuth 连接的通用 NotFair MCP。插件只注册一个名为 NotFair 的服务器，供所有受支持平台共享。
智能体依据实时服务器的指令和能力描述选择工具。技能只提供营销工作流和证据标准，不硬编码 MCP 工具名称或调用顺序。手动配置与从旧的按平台连接迁移，可参考连接与升级指南。每个平台需在 OAuth 期间选定的 NotFair 工作区中完成连接后才可用，并应遵循服务器返回的账户设置指引。
受支持的账户操作取决于实时连接。变更必须保持在用户授权范围内，并依据账户实际状态进行验证。除非当前智能体会话暴露了经过验证的连接器，Amazon 与 ChatGPT Ads 仅用于规划或导出审查工作流。setup-cms 是本地 SEO 脚本的凭据向导；实时 WordPress 工作使用 /notfair:wordpress。
技能内部，连接器使用与工具无关的占位符，例如 ~~google-ads、~~meta-ads、~~x-ads、~~linkedin-ads、~~reddit-ads、~~tiktok-ads、~~search-console、~~google-analytics、~~wordpress 和 ~~gohighlevel。智能体会把每个占位符解析为当前会话中可用的兼容工具，因此工作流不绑定单一 MCP 命名空间。
隐私与本地工作流
插件通过浏览器 OAuth 连接所声明的 NotFair MCP 端点。请求的工具参数会发送至 NotFair，来自已连接提供方的结果会返回给获授权的 AI 客户端。存储、保留与删除细节见隐私政策。建议只连接计划使用的工作区和平台账户。
可选的本地工作流会运行可读的 Python 或 shell 脚本。爬虫会请求用户提供的 URL；Search Console 直接脚本使用用户显式授权的 Google Cloud 登录；CMS 脚本使用通过 setup-cms 配置的站点凭据；Gemini review 在完成认证设置后，将选定的审查上下文发送给 Google 的 Gemini CLI。这些工作流需要显式选择，凭据不应出现在报告和提交中，实时平台工作应优先使用可用的 OAuth MCP。插件没有自动钩子或本地 MCP 服务器。日历查看器在回环地址上提供本地规划数据，可选的更新检查器会从 GitHub 读取公开版本文件。
原先独立的 NotFair Next.js 博客库已迁至其自有公开仓库，并通过 GitHub Releases 分发，其源码与发布流程不再随本 AI 智能体插件打包。已停用的 NotFair CMO 应用也不再包含在内。
仓库组织与贡献
AGENTS.md 是通用入口，负责把用户意图映射到规范的 SKILL.md，并说明各工作流所需的外部依赖。每项技能位于各自的类别文件夹中。
新增或修改技能时：保持工作流聚焦于一个明确的营销任务；在 WORKFLOW.md 中使用祈使式、可测试的指令，并保持 skills/ 下的入口同步；添加或更新评估覆盖；更新 AGENTS.md、插件清单、VERSION 与 CHANGELOG.md；以“一项技能或一项连贯改进”为单位提交 pull request。仓库约定详见插件开发文档。
适用场景
适合希望让 AI 智能体按照可审查流程执行 SEO、GEO、付费媒体与分析类营销任务的团队，尤其是需要复用、分叉或按自身标准调整工作流的场景。
限制与暂未提供的信息
当前资料未提供具体价格、收费方式或付费方案信息；未说明各技能的具体输入输出样例；未列出全部 48 项技能的完整清单；实时功能所支持的具体账户操作细节取决于运行时连接，资料未逐一列举。Amazon 与 ChatGPT Ads 在缺少已验证连接器时仅限规划或导出审查。使用前需自行确认授权范围与凭据管理要求。
