🚀 CDP Edge - Quantum Tracking

Padrão Quantum Tracking: 100% Cloudflare Edge. Sem GTM. Sem Stape. Sem cookies de terceiros.

v1.2.2 — Cloudflare Queue + KV + Workers AI · Meta CAPI v22.0 · GA4 MP · TikTok Events API v1.3

• Precisão Máxima: Meta CAPI v22.0+, GA4 MP e TikTok Events API v1.3.
• Identity Graph: Persistência de leads e eventos via Cloudflare D1.
• Anti-Adblock: Endpoint Same-Domain indetectável.
• Human-Behavior Engine: Score de engajamento (0-100) em tempo real.
• Queue Retry: Zero perda de conversão — eventos com falha reenfileirados automaticamente.
• Geo Intelligence: Cidade, estado e CEP em todos os eventos (Workers Paid).

🏗️ ARQUITETURA QUANTUM (CLOUDFARE NATIVE)

O CDP Edge não é um "script de rastreio", é uma Content Delivery Network (CDN) com inteligência de dados acoplada.

graph TD
    User((Usuário)) -->|Interação| SDK[cdpTrack SDK + Behavior Engine]
    SDK -->|Edge Fetch| Worker[Cloudflare Worker Agent]
    Worker -->|Identity Graph| D1[(D1 SQL Database)]
    Worker -->|Background Job| Queue[Cloudflare Queues]
    Queue -->|Server Dispatch| Meta[Meta CAPI v22.0]
    Queue -->|Server Dispatch| Google[GA4 / Google Ads]
    Queue -->|Server Dispatch| TikTok[TikTok API v1.3]
    D1 -->|Retention Reports| Dash[Dashboard Agent]

🖱 CATÁLOGO DE AGENTES ESPECIALISTAS

O sistema é composto por mais de 30 agentes coordenados pelo Master Orchestrator. Cada um possui uma função técnica específica:

🧠 Núcleo de Inteligência

🚀 Despachantes de Plataforma

🛡️ Módulos Enterprise (Premium)

💻 INSTALAÇÃO E USO

Instalar Globalmente

npm install -g cdp-edge
cdp-edge --version

📋 COMANDOS DISPONÍVEIS

install — Instalar CDP Edge em um projeto cliente

O comando principal. Configura o CDP Edge em qualquer projeto e habilita o /cdp no Claude Code.

# Instalar no diretório atual
cdp-edge install .

# Instalar em outro diretório
cdp-edge install ./meu-projeto

# Com nome do projeto
cdp-edge install ./meu-projeto --name "Landing Page XYZ"

# Incluir .cursorrules para Cursor IDE
cdp-edge install ./meu-projeto --cursor

O que cria na raiz do projeto:

Fluxo após install:

# 1. Criar e instalar
mkdir meu-projeto
cdp-edge install ./meu-projeto

# 2. Abrir no Claude Code
claude ./meu-projeto

# 3. Ativar o Orchestrator
/cdp

Outros Comandos

setup — Wizard interativo

cdp-edge setup
cdp-edge setup ./meu-projeto

O que faz:

• Pergunta plataformas (Meta, TikTok, GA4, etc.)
• Pergunta tipo de produto (lead, checkout, webinar, etc.)
• Gera código de tracking (Browser + Server)
• Cria schema D1 SQL e configuração Wrangler

analyze — Analisar páginas

cdp-edge analyze .
cdp-edge analyze ./meu-projeto

O que faz:

• Detecta CTAs e formulários
• Identifica nicho do negócio
• Sugere micro-eventos comportamentais

server — Gerar infraestrutura Cloudflare

cdp-edge server .
cdp-edge server ./meu-worker

Arquivos gerados:

• worker.js — Cloudflare Worker completo
• schema.sql — Schema D1
• wrangler.toml — Configuração Wrangler

validate — Auditar tracking existente

cdp-edge validate tracking.js

O que verifica:

• event_id para deduplicação
• SHA256 para PII (e-mail, telefone)
• Detecção de GTM/Stape
• Conformidade com APIs

infra — Guia de infraestrutura Cloudflare

cdp-edge infra

🔄 CICLO DE VIDA DO SETUP (/setup)

1. FASE 0 — Checkpoint: Sincronização de contexto via Memory Agent.
2. FASE 1 — Análise: Detecção automática de nicho e estrutura da página.
3. FASE 2 — Mapeamento: Identificação de CTAs, Forms e Gateways de venda.
4. FASE 3 — Geração: Código paralelo para Browser (cdpTrack), Worker e D1 SQL.
5. FASE 4 — Auditoria: Validação rigorosa e correções automáticas (Validator).
6. FASE 5 — Deploy: Publicação instantânea via wrangler deploy.

📁 ESTRUTURA DO REPOSITÓRIO

CDP Edge/
├── README.md                        # Você está aqui.
├── CLAUDE.md                        # Guia de desenvolvimento e padrões.
├── extracted-skill/                 # O motor da IA (Agentes e Knowledge Base).
│   └── tracking-events-generator/
│       ├── agents/                  # 39+ agentes especialistas
│       ├── cdpTrack.js              # SDK Browser (window.cdpTrack)
│       └── micro-events.js          # Scroll, vídeo, hover, click tracking
├── server-edge-tracker/             # Cloudflare Worker (Infra de Borda)
│   ├── worker.js                    # Handler principal + Queue consumer
│   ├── schema.sql                   # D1 Schema (Identity Graph)
│   └── wrangler.toml                # Bindings: D1 + Queue + KV + AI
├── bin/                             # CLI Executável (cdp-edge)
├── dist/commands/                   # Implementação dos comandos CLI
│   └── install.js                   # cdp-edge install
├── templates/
│   ├── install/
│   │   ├── CLAUDE.md                # Template de auto-ativação para projetos
│   │   └── .claude/commands/
│   │       └── cdp.md               # Define /cdp no Claude Code
│   ├── vsl-page.md                  # Template VSL / vídeo de vendas
│   └── afiliado-sem-landing.md      # Template bridge page afiliado
└── docs/
    ├── quick-start.md               # Do zero ao deploy
    ├── events-reference.md          # Catálogo completo de eventos
    ├── sdk-reference.md             # API pública do cdpTrack.js
    └── installation.md              # Instalar CDP Edge em projetos clientes

📚 EXEMPLOS DE USO

Cenário 1: Novo projeto com Claude Code

# 1. Criar projeto e instalar CDP Edge
mkdir landing-page-lead
cdp-edge install ./landing-page-lead --name "Landing Page Lead"

# 2. Abrir no Claude Code
claude ./landing-page-lead

# 3. Ativar o Orchestrator
/cdp
# → CDP Edge inicia, faz perguntas, gera toda a infraestrutura

Cenário 2: Apenas Infraestrutura Cloudflare

# 1. Gerar infraestrutura Worker + D1
cdp-edge server ./meu-worker

# 2. Deploy
cd meu-worker
wrangler deploy

# 3. Configurar secrets
wrangler secret put META_ACCESS_TOKEN
wrangler secret put TIKTOK_ACCESS_TOKEN

Cenário 3: Validar Código Existente

cdp-edge validate tracking.js

# Status: PASS | Score: 85/100
# ⚠  Hashing não detectado para PII

Cenário 4: Análise de Projeto

cdp-edge analyze ./meu-projeto-web

# 📊 Eventos detectados: leads: 2 | purchases: 1 | views: 3
# 🎯 Nicho identificado: E-commerce

⚡ COMANDOS RÁPIDOS (CLI)

🔧 SOLUÇÃO DE PROBLEMAS

Erro: "Cannot find module dist/commands/install.js"

O npm ainda tem a versão antiga em cache. Instale direto do GitHub para ter a versão mais recente:

npm uninstall -g cdp-edge
npm install -g github:ricardosoli777/CDP-Edge-Premium
cdp-edge --version

Erro: "cdp-edge não é reconhecido"

# Instalar globalmente
npm install -g cdp-edge

# Ou instalar direto do repositório
npm install -g github:ricardosoli777/CDP-Edge-Premium

Erro: "Permissão negada ao escrever arquivos"

Execute o terminal como Administrador (Windows) ou use sudo (Mac/Linux).

Erro: "Módulo não encontrado" (outros módulos)

npm cache clean --force
npm uninstall -g cdp-edge
npm install -g cdp-edge

🖱️ HUMAN-BEHAVIOR ENGINE (O MOTOR DE INTENÇÃO)

A joia da coroa do CDP Edge. Capturamos o que o usuário sente e faz, e não apenas onde ele clica.

🌡️ Engagement Scoring Engine (0-100)

Cada ação do usuário soma (ou subtrai) pontos em tempo real:

• Scroll (25-90%): +5 a +15 pontos.
• VSL Watch (25-100%): +10 a +50 pontos.
• Copy Intent: +20 pontos ao copiar cupons ou chaves PIX.
• Form Interaction: +10 pontos por campo preenchido.
• Rage Click: -10 pontos (sinal de frustração técnica).
• Gatilho Hot Lead: Ao atingir 80 pontos, disparar High_Intent_Lead para as plataformas.

🎥 VSL & Video Tracker

Monitoramento nativo de retenção em vídeos YouTube e Vimeo sem necessidade de scripts externos pesados.

📞 SUPORTE

• Documentação: Verifique CLAUDE.md para padrões de desenvolvimento
• Issues: https://github.com/ricardosoli777/CDP-Edge-Premium/issues
• Releases: https://github.com/ricardosoli777/CDP-Edge-Premium/releases

CDP Edge — By Rica Soares

"Dados sem inteligência são apenas ruído. No Quantum Tier, transformamos dados em ROAS."

© 2026 CDP Edge Premium. Todos os direitos reservados.