AgentFirstStack Mail

AgentFirstStack

AI エージェントが自らセットアップする、アナリティクス、タグ管理、メール受信箱、セッションリプレイです。
サインアップフォームも、確認メールも、クリックして進むダッシュボードもありません。無料で利用でき、オープンソースです。

agentfirststack.com · マニュアル · セルフホスト · アーキテクチャ

---

新しいウェブサイトには、いつも同じインフラが必要です。アナリティクス、コンバージョントラッキング付きのタグマネージャー、そしてほかのサービスへのサインアップに使うメールアドレスです。一般的なツールはどれも、サインアップフォーム、確認メール、ダッシュボードから始まります。コーディングエージェントだけでは、こうした手順を先に進められません。

AgentFirstStack は、エージェントがすべての作業を行えるように再構築したインフラです。

• 一度のリクエストでアカウントを取得できます。 POST /v1/signup を呼び出すと、すべてのサービスで使えるキーが返されます。
• すべてが API 呼び出しか MCP ツールです。 設定ページの奥に隠された機能はありません。
• マニュアルはテキストファイルです。 各サービスは、すべてのエンドポイント、ツール、フィールドを記載した /llms.txt を提供します。
• すべての手順を検証できます。 エージェントは推測する代わりに、自分の作業を確認します。
• 人間は任意です。 作業が完了すると、エージェントはユーザーにクレームリンクを渡します。ユーザーは Google でサインインして、ダッシュボードでプロジェクトを確認し、キーやチームメイトを管理し、OAuth 経由で Claude や ChatGPT を接続できます（docs/accounts.md）。

サービス

	機能	代替対象
アナリティクス	Cookie を使わないウェブアナリティクス。Cloudflare のエッジから取得する国、地域、市区町村の情報、AI アシスタントを含むチャネル、UTM と広告クリック ID、目標、収益、ファネル、リアルタイムデータ、サーバーサイドイベント、読み取り専用 SQL	Google Analytics、Plausible
タグ	タグマネージャー兼サーバーサイドコンバージョンルーター。コンバージョンを一度定義すると、ブラウザのピクセルとサーバーの両方から、1 つのイベント ID を使って GA4、Google Ads、Meta、TikTok に送信されるため、各プラットフォームでの計測は 1 回だけです。スキャン、検証、プレビュー、テスト、公開ができます	Google Tag Manager、サーバーサイド GTM
メール	1 回のリクエストで受信箱を作成できます。wait_for_email はメッセージが届くとすぐに結果を返し、確認コードとリンクも抽出済みです。メールの閲覧、返信、送信、カスタムドメイン、ウェブフックに対応しています	プロジェクトごとの Gmail アカウント、AgentMail
リプレイ	デフォルトでブラウザ上でマスキングされるセッション録画。セッションは読みやすい文字起こしとして表示されます。苛立ち、無反応、エラーのクリック、ヒートマップ、JavaScript エラーはデータとして確認でき、共有リンクから人間向けのプレーヤーを開けます	Hotjar、Microsoft Clarity

クイックスタート

ホステッド版（無料）

agentfirststack.com のプロンプトを Claude Code、Cursor、Codex、または HTTP リクエストを実行できる任意のエージェントにコピーします。手動で行うこともできます。

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 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をご覧ください。

構成

Cloudflare Workers 上で、Hono と zod を使用した TypeScript 製です。ストレージ：

• D1： 設定と共有 ID データベース。
• SQLite Durable Objects： エンティティごとの頻繁にアクセスされるデータ（サイトのイベント、コンテナの訪問者、受信トレイの待機者）。
• R2： メールの blob とリプレイ録画のチャンク。
• Queues： 広告プラットフォームや Webhook への再試行付き配信。
• Email Routing and 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 では、 稼働中のデプロイにおけるリリース、マイグレーション、シークレット、モニタリング、不正利用への対応について説明しています。

貢献

Issue とプルリクエストを歓迎します。まず CONTRIBUTING.md をお読みください。短い内容です。 セキュリティ上の問題は、SECURITY.md の説明に従って非公開で報告してください。

ライセンス

サービスは AGPL-3.0 です。ウェブサイトが読み込むブラウザースクリプト（分析トラッカー、タグマネージャーのランタイム、リプレイ録画ツール、アンケートウィジェット）は MIT なので、サイトに追加してもサイトに義務は生じません。どちらのライセンスでもセルフホストは無料です。変更したバージョンをサービスとして提供する場合は、変更内容を公開してください。詳細：LICENSING.md。StartGlobal が開発およびホスティングを行っています。