内容
<div align="center">
# Growth OS增长操作系统
**适用于任何AI代理的开源增长操作系统。**
给你的代理一个网址。它学习业务，审计增长的全过程，连接你的真实分析账户，并将工作交给专注的营销技能——并保存上下文，以便它永远不会重复询问。
[](LICENSE)
[](#What-it-does)
[](#runs-on-any-agent)
[](https://nocodework.io)
[安装](#安装) · [连接账户](#连接账户) · [使用](#使用) · [工作原理](#工作原理) · [比较](#比较)
</div>
---
## 为什么
我创建了Growth OS，因为我厌倦了两件事。
首先，每次都要向AI重新解释我的业务。谁是客户，产品到底做什么，为什么有人购买——我一次又一次地打字。第二，我尝试的每个“增长AI”都是一个聊天，给出建议但从不触及真实的数字。它看不到我的Search Console，我的GA4，或者谷歌自己的PageSpeed API是否认为我的网站速度慢。因此建议是通用的，通用建议是毫无价值的。
Growth OS解决了这两个问题。它从一个URL中提取定位信息，并将其写入一个文件，你的代理可以永久读取。然后它连接到你的**实际**分析账户——只读，你自己的密钥——因此每次审计和建议都基于你的真实数据，而不是一种感觉。
它是开源的，MIT许可的，可以自行托管，并且可以在你已经使用的任何代理上运行。
## 它做什么
指向Growth OS一个商业网址，它会运行一个流程：
1. **提取定位信息** — 从网站中提取USP、UVP和ICP，并保存到`.agents/product-marketing.md`，一个持久的上下文文件，每个技能都会读取。
2. **审计增长** — 技术SEO、页面速度（通过谷歌的PageSpeed Insights API）、GEO / AI可见性（你在ChatGPT、Gemini、Claude和Perplexity等工具中的显示情况）、竞争格局和**实时基准**来自你的GA4和Search Console。
3. **委托原子技能** — 而不是一个庞大的提示，Growth OS会组合小的、单一用途的营销技能（编写比较页面，计划实验，修复标题标签），并将它们传递给共享的上下文。
4. **连接你的账户** — 通过复制粘贴步骤引导你连接每个API，并告诉你哪些可以立即开始，哪些需要时间。
整个设计理念是，代理执行枯燥、重复的粘合工作——身份验证流程、数据拉取、上下文管理——而你做出决定。
## 它连接什么
v1版本**仅读取**。Growth OS读取你的数据来进行审计和建议；它不花费预算、发布帖子或更改活动。每个集成都使用**你自己的密钥**，存储在你自己的`.env`文件中。
两个层级：
- 🟢 **零审批** — 你可以立即连接这些，只需要一个密钥或服务账户。
- 🔴 **审批 + 时间** — 这些需要一次性验证或所有者的审查，然后API才会返回数据。尽早开始。
| 集成 | Growth OS读取的内容 | 层级 | 指南 |
|---|---|---|---|
| **Google Analytics 4** | 会话，用户，转化，渠道，着陆页性能（数据API） | 🟢 零审批 | [docs/integrations/ga4.md](docs/integrations/ga4.md) |
| **Google Search Console** | 查询，印象，点击，CTR，平均位置，索引（与GA4相同的服务账户） | 🟢 零审批 | [docs/integrations/google-search-console.md](docs/integrations/google-search-console.md) |
| **MailerLite** | 订阅者，活动打开/点击，增长（来自UI的Bearer API密钥） | 🟢 零审批 | [docs/integrations/mailerlite.md](docs/integrations/mailerlite.md) |
| **PageSpeed Insights** | 核心网页生命体征，Lighthouse得分，机会（来自GCP的API密钥） | 🟢 零审批 | [docs/integrations/ga4.md#pagespeed](docs/integrations/ga4.md) |
| **Google Ads** | 活动花费，印象，点击，转化（需要开发者令牌 + MCC；测试/资源管理器开始） | 🔴 审批 | [docs/integrations/google-ads.md](docs/integrations/google-ads.md) |
| **Meta Marketing + Instagram** | 广告账户洞察，页面/IG业务指标（需要商业验证，然后应用审查） | 🔴 审批 | [docs/integrations/meta-instagram.md](docs/integrations/meta-instagram.md) |
> 🔴 类型的集成值得从第一天开始启动。 **Meta Business Verification单独需要~14+天**，而Google Ads需要一个经过MCC（管理器账户）验证的开发者令牌。启动它们，然后使用🟢层级的集成。
## 安装
Growth OS作为Claude Code插件通过NoCodeWork市场发布：
```bash
/plugin marketplace add nocodework/growth-os
/plugin install growth-os
```
这会给你提供`/growth-os:`命令和捆绑的技能。对于读取数据拉取，你还需要安装小型Python CLI：
```bash
git clone https://github.com/nocodework/growth-os
cd growth-os
pip install -e .
cp .env.example .env # 然后填写你的密钥 — 见下面的指南
```
不是Claude Code？见 [在任何代理上运行](#在任何代理上运行) — 核心是可移植的。
## 连接你的账户
每个集成都有一个纯语言指南：你创建的内容，你点击的位置，以及授予的权限。这里没有任何内容要求比读取更多的权限。
- 🟢 [Google Analytics 4](docs/integrations/ga4.md) — 服务账户JSON或OAuth `analytics.readonly`
- 🟢 [Google Search Console](docs/integrations/google-search-console.md) — `webmasters.readonly`，重用GA4服务账户
- 🟢 [MailerLite](docs/integrations/mailerlite.md) — 来自仪表板的Bearer API密钥
- 🟢 [PageSpeed Insights](docs/integrations/ga4.md) — 来自Google Cloud的API密钥
- 🔴 [Google Ads](docs/integrations/google-ads.md) — 开发者令牌 + 管理账户，测试/资源管理器访问权限
- 🔴 [Meta Marketing + Instagram](docs/integrations/meta-instagram.md) — 首先进行商业验证，然后进行应用审查以获取 `ads_read` / `instagram_*`
在`.env`中填写匹配的变量（参见 [.env.example](.env.example)），Growth OS会自动读取它们。
## 使用
编排器位于六个命令后面。典型的第一次运行：
```
/growth-os:onboard https://example.com
```
Growth OS读取网站，起草你的定位信息，并写入 `.agents/product-marketing.md`。然后：
```
/growth-os:audit # 完整的增长审计：SEO，速度，GEO，竞争对手，实时GA4/GSC基准
/growth-os:connect # 连接每个账户的引导式向导
/growth-os:context # 查看或编辑保存的定位信息 + 连接的源
/growth-os:delegate cro # 将特定工作交给专注的营销技能
/growth-os:dashboard # 连接的源的单屏幕快照
```
一些实际例子：
```
/growth-os:audit --focus geo # 仅AI可见性切片 — ChatGPT/Perplexity如何看待你
/growth-os:delegate "编写与<竞争对手>的对比页面"
/growth-os:dashboard --range 28d # 最近28天的GA4 + GSC + MailerLite数据
```
审计发现的所有内容都写入文件中，因此下一次会话 — 或队友 — 都从完整的画面开始，而不是空白提示。
## 在任何代理上运行
Growth OS **运行时无关**。有价值的部分不是Claude Code插件，而是可移植的核心：
- **Markdown技能** (`core/skills/`) — 普通指令，任何有能力的代理都可以读取和遵循。
- **`growth-os` CLI** — 一个Python命令，执行读取数据拉取：`growth-os <adapter> <cmd>`，例如 `growth-os ga4 baseline`，`growth-os gsc queries`，`growth-os pagespeed run <url>`。不需要代理；它只是一个工具。
- **MCP服务器** — 通过模型上下文协议公开相同的适配器和技能，因此任何MCP能力的代理都可以调用它们。
在此核心之上，**薄包装**适用于每个运行时 — 每个只有几行文件，无重复逻辑：
| 运行时 | 包装 |
|---|---|
| **Claude Code** | 插件：`/growth-os:` 命令 + 技能，从市场安装 |
| **Codex** | 一个`AGENTS.md`，指向Codex的技能和`growth-os` CLI |
| **Hermes** （或任何自主代理） | 注册MCP服务器并直接调用适配器 |
| **任何MCP能力** | 连接MCP服务器；工具和技能本机出现 |
更换运行时，保持大脑。就是这个理念。
## 工作原理
六层，每层执行一项工作：
1. **编排器** — `/growth-os:` 命令（`onboard`、`audit`、`connect`、`context`、`delegate`、`dashboard`）按顺序执行所有操作。
2. **技能组合** — `core/skills/`中的原子营销技能根据任务组合，而不是一个巨大的提示。
3. **读取适配器** — Python CLI与GA4、GSC、Google Ads、Meta、MailerLite和PageSpeed通信，并返回干净的数据。
4. **GEO模块** — 检查品牌在ChatGPT、Gemini、Claude和Perplexity等工具中的显示情况，然后将空白转化为内容操作（`geo-content`）。
5. **账户开通向导** — 逐步流程，连接每个API，诚实地说明哪些需要时间。
6. **上下文中心** — `.agents/product-marketing.md`和审计输出，共享内存，每层读取和写入。
数据单向流动：适配器读取 → 上下文中心存储 → 技能推理 → 编排器委托。没有任何内容写入您的广告账户或CMS。
## 隐私和密钥
- **您的密钥，您的机器。** 所有内容都进入您自己的`.env`中。Growth OS永远不会将凭证运送到任何地方。
- **默认自我托管。** 它在本地或您自己的服务器上运行。没有Growth OS后端需要信任。
- **零遥测。** 没有电话回家，没有使用跟踪，没有分析。阅读源代码，它都在这里。
- **设计为只读。** v1适配器仅拉取数据。Growth OS无法花费您的预算或代表您发布。
- **您的代理，您的模型。** 携带您自己的`ANTHROPIC_API_KEY`（或通过您的代理使用的模型运行）。
## 比较
我会坦率地说明Growth OS的优缺点。
| | **Growth OS** | **Supermetrics** | **Profound** | **营销机构** |
|---|---|---|---|---|
| 价格 | 免费，MIT | 付费SaaS，按连接器 | 付费SaaS | $$$/月预留 |
| 数据所有权 | 您的密钥，您的机器 | 他们的云 | 他们的云 | 他们 + 您 |
| GEO / AI可见性 | ✅ 内置 | ❌ | ✅ （他们的核心） | 有时 |
| 定位 + 上下文内存 | ✅ 持久文件 | ❌ | ❌ | 在某人的脑海中 |
| 在您的AI代理内运行 | ✅ 任何代理 | ❌ | ❌ | ❌ |
| 连接到BI / 仪表板 | 基本（CLI + 文件） | ✅ 深入，精致 | ✅ | ✅ |
| 一站式服务 | 粗糙，代码优先 | ✅ | ✅ | ✅ |
| 为您做工作 | 委托给技能 | 否（仅数据） | 否（仅数据） | ✅ （这是重点） |
**Growth OS较弱的地方，诚实地说：** 它是代码优先的，因此假设您熟悉终端和API设置。它没有Supermetrics深入的、经过战斗测试的连接器库，也没有Profound精致的仪表板。而且它不会取代优秀机构的判断或账户操作。相反，它为您提供所有权、持久的上下文、内置GEO和一个实际执行委托工作的代理 — 免费。
如果您需要企业级BI管道，请购买Supermetrics。如果您想要一个属于自己的、可黑客的增长大脑用于您的代理，请使用Growth OS。
## NoCodeWork工具的一部分
Growth OS是我们在 [NoCodeWork](https://nocodework.io) 中构建的一小部分开源、独立的工具：
- [ai-context-kit](https://github.com/nocodework/ai-context-kit) — 为任何AI代理提供持久的项目上下文
- [offline-notes](https://github.com/nocodework/offline-notes) — 一个markdown笔记编辑器，零网络请求
- [offline-sketch](https://github.com/nocodework/offline-sketch) — 一个压力敏感的绘图板，完全离线
- [offline-whiteboard](https://github.com/nocodework/offline-whiteboard) — 一个无限的白板，永远不会打电话回家
所有这些工具都遵循相同的原则：您的数据保留您自己，没有遥测，MIT。
## 贡献
欢迎贡献。好的起点：
- **新的读取适配器** — LinkedIn Ads，TikTok，Bing Webmaster，Plausible，您使用的任何其他工具。遵循 `core/adapters/` 中的适配器模式。
- **新的原子技能** — 小的，单一目的的，可组合的。在 `core/skills/` 中添加它们，并附上清晰的描述。
- **集成指南** — 如果设置流程让您感到困惑，请修复 `docs/integrations/` 中的文档。
在您构建任何较大的内容之前，请先打开一个问题进行讨论。保持所有内容只读且注重隐私 — 没有写入用户账户的核心内容不会在没有充分理由的情况下进入核心。
## 许可证
MIT © [NoCodeWork](https://nocodework.io)。您可以随心所欲地使用它。
Growth OS旨在与**其他营销技能包**配合使用，而不是替换或重新分发它们 — 它组合自己的技能，并且可以引用您已经安装的软件包。这里的所有内容都是原创的。
