AgentFirstStack

AgentFirstStack

AI Agent 可自行配置分析、标签管理、电子邮件收件箱和会话回放。
无需注册表单、验证邮件，也无需在仪表板中逐项操作。免费使用，且为开源项目。

agentfirststack.com · 手册 · 自托管 · 架构

---

每个新网站都需要相同的基础设施：分析、带转化跟踪的标签管理器，以及用于注册其他服务的电子邮件地址。常见工具都要求先填写注册表单、验证邮件，再进入仪表板。编码 Agent 无法独自完成这些步骤。

AgentFirstStack 重构了这些基础设施，让 Agent 能独立完成所有工作：

• 一次请求即可创建账户。 POST /v1/signup 会返回一个适用于所有服务的密钥。
• 所有功能都通过 API 调用和 MCP 工具提供。 没有任何功能藏在设置页面后面。
• 手册是一个文本文件。 每项服务都通过 /llms.txt 提供包含所有端点、工具和字段的说明。
• 每个步骤都可以验证。 Agent 会检查自己的操作，而不是靠猜。
• 无需人工参与。 完成后，Agent 会把认领链接交给用户。用户可通过 Google 登录，在仪表板中查看项目、管理密钥和团队成员，并通过 OAuth 连接 Claude 或 ChatGPT（docs/accounts.md）。

服务

	功能	可替代
分析	无 Cookie 的网站分析。通过 Cloudflare 边缘节点获取国家、地区和城市信息；包括 AI 助手在内的流量渠道；UTM 和广告点击 ID；目标、收入、漏斗、实时数据；服务端事件；只读 SQL	Google Analytics、Plausible
标签	标签管理器和服务端转化路由器。只需定义一次转化，浏览器像素和服务端就会使用同一个事件 ID，将事件发送到 GA4、Google Ads、Meta 和 TikTok，因此每个平台只会统计一次。支持扫描、验证、预览、测试和发布	Google Tag Manager、服务端 GTM
邮件	一次请求即可创建收件箱。wait_for_email 会在收到消息时立即返回，并已提取验证码和链接。支持读取、回复、发送、自定义域名和 Webhook	每个项目一个 Gmail 账户、AgentMail
回放	默认在浏览器中遮蔽会话录制内容。会话会以易读的文字记录形式呈现；将狂点、无效点击和错误点击、热图及 JS 错误作为数据提供；分享链接可让用户打开播放器	Hotjar、Microsoft Clarity

快速开始

托管版（免费）

将 agentfirststack.com 上的提示词复制到 Claude Code、Cursor、Codex 或任何可发送 HTTP 请求的 Agent 中。也可以手动操作：

curl -X POST https://agentfirststack.com/v1/signup
# { "api_key": "afs_...", "mcp": { ... }, "next_steps": [ ... ] }

curl -X POST https://analytics.agentfirststack.com/v1/sites \
  -H "Authorization: Bearer $AGENTFIRSTSTACK_API_KEY" -H 'content-type: application/json' \
  -d '{"domain":"example.com"}'

为每项服务添加一个 MCP 服务（工具前缀为 analytics_、tags_、mail_、replay_）：

claude mcp add --transport http afs https://agentfirststack.com/mcp --header "Authorization: Bearer $AGENTFIRSTSTACK_API_KEY"

也可以为每项服务分别添加：

claude mcp add --transport http afs-analytics https://analytics.agentfirststack.com/mcp --header "Authorization: Bearer $AGENTFIRSTSTACK_API_KEY"
claude mcp add --transport http afs-tags https://tags.agentfirststack.com/mcp --header "Authorization: Bearer $AGENTFIRSTSTACK_API_KEY"
claude mcp add --transport http afs-mail https://mail.agentfirststack.com/mcp --header "Authorization: Bearer $AGENTFIRSTSTACK_API_KEY"
claude mcp add --transport http afs-replay https://replay.agentfirststack.com/mcp --header "Authorization: Bearer $AGENTFIRSTSTACK_API_KEY"

托管版设有合理使用限额，详见手册。

自托管版

所有服务都运行在你自己的 Cloudflare 账户中的 Cloudflare Workers 上：

git clone https://github.com/StartGlobal-AI/agentfirststack && cd agentfirststack
pnpm install
pnpm afs init mystack --domain example.com --account <cloudflare-account-id>
pnpm afs deploy mystack
CLOUDFLARE_API_TOKEN=... pnpm afs email mystack     # inbound + outbound mail
pnpm afs check mystack

有关要求、注册模式、限额和更新，请参阅 docs/self-hosting.md。

构建方式

使用 TypeScript、Cloudflare Workers、Hono 和 zod 构建。存储：

• **D1：**配置和共享身份数据库。
• **SQLite Durable Objects：**按实体存储的热数据（网站的事件、容器的访客、收件箱的等待者）。
• **R2：**邮件内容和回放录制片段。
• **Queues：**向广告平台和 Webhook 重试投递。
• **Email Routing 和 Email Sending：**收发邮件。

site/        landing page, platform manual, platform signup      agentfirststack.com
analytics/   web analytics                                        analytics.agentfirststack.com
tags/        tag manager + conversion APIs                        tags.agentfirststack.com
mail/        inboxes, sending, domains, webhooks                  mail.agentfirststack.com
replay/      session replay, signals, heatmaps, share player          replay.agentfirststack.com
shared/      @afs/shared: auth, signup, errors, MCP handler
scripts/     pnpm afs: the deployment tool
deploy/      deployment profiles (yours; the agentfirststack.com one is kept private)
docs/        architecture, self-hosting, operations, development

更多信息请参阅 docs/architecture.md。

开发

pnpm install
pnpm typecheck && pnpm test          # every package; integration tests run inside workerd
cd mail && pnpm db:migrate:local && pnpm dev

docs/development.md 介绍了如何在本地运行服务、进行测试，以及添加端点、迁移和标签目标。docs/operations.md 介绍了运行中的部署所涉及的发布、迁移、密钥、监控和滥用处理。

贡献

欢迎提交问题和拉取请求。请先阅读 CONTRIBUTING.md，内容很简短。请按照 SECURITY.md 中的说明私下报告安全问题。

许可证

服务采用 AGPL-3.0；网站加载的浏览器脚本（分析追踪器、标签管理器运行时、回放记录器和调查组件）采用 MIT，因此将它们添加到网站不会产生任何义务。无论采用哪种许可证，自托管都是免费的；如果将修改后的版本作为服务提供，请公开你的修改。详情请参阅 LICENSING.md。由 StartGlobal 构建并托管。