tynk-track — Meta CAPI do Zero

Skill + runbook + instalador guiado-executável para configurar o tracking Meta (Pixel + Conversions API) num funil: 4 eventos via hub sGTM (Stape) e Purchase exclusivo do Cloudflare Worker (webhook do checkout). Um comando instala, configura e — com os tokens — automatiza DNS, sGTM, deploy e webhook.

Instalação (um comando)

npx tynk-track          # sempre a latest do npm
npx [email protected]    # fixar versão (opcional)
npx tynk-track update   # atualiza skill já instalada (preserva config)

O wizard (8 etapas, interface visual com setas) pergunta idioma, onde instalar, pixel, domínio e credenciais — e executa o que der:

| Etapa | O que acontece | |---|---| | 0 · Credenciais | Coleta e valida tokens (Cloudflare, Stape, Meta CAPI) — inválido cai pro caminho guiado | | 1 · Instalação | Copia a skill pros seus agentes (76 suportados — Claude Code, Codex, Cursor, Hermes, Antigravity...) no projeto ou global | | 2 · Site e Meta | Pixel + domínio; cria a zona na Cloudflare via API (só nameserver é manual fora da CF) | | 3 · Verificação de domínio | 3 métodos no BM (DNS TXT / metatag SSR / arquivo /CODE.html). Com token CF: cola CODE, linha facebook-domain-verification=… ou até a metatag — o wizard normaliza e cria/corrige o TXT canônico (nunca grava HTML no DNS). Sem token: guia + checagem DNS (detecta TXT sujo) | | 4 · sGTM | Stape API: cria container, conecta o domínio, ativa Custom Loader — e o CNAME alimenta a Cloudflare sozinho | | 5 · Worker | Cloudflare API: deploy do worker + secrets + URL — sem wrangler login | | 6 · Webhook | Kiwify: cadastra via API; Lastlink/Hotmart: guia clicável (sem API pública) | | 7 · Snippets | Gera snippet-head.html / snippet-body.html com seus valores — e o modelo "um domínio, vários produtos" (preço/checkout por meta tag da LP) | | 8 · Validação | Prova de fogo no Test Events |

Sem tokens, cada etapa degrada graciosamente pro passo a passo guiado (o runbook completo vai junto na skill).

Alternativa (só os arquivos, ecossistema de skills):

npx skills@latest add grupo-ecom/meta-capi-do-zero -g -y

Conteúdo

skills/tynk-track/      ← a skill (SKILL.md + LEIA-ME + runbook/ + plataformas/ + worker/)
src/                    ← instalador: wizard, i18n, guias, APIs (cloudflare, stape, kiwify, meta-domain)
docs/                   ← pesquisas de API + desenhos arquivados

Desenvolvimento

npm install
npm run test   # worker + doctrine-grep + meta-domain

Licença

MIT — veja LICENSE.