iron-edge 2.10.0 → 2.12.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +10 -6
- package/bin/iron-edge.js +2 -2
- package/installer/cofre.js +26 -3
- package/installer/doctor.js +1 -1
- package/installer/install.js +13 -4
- package/installer/office.js +1 -1
- package/package.json +2 -2
- package/skills/anuncios/SKILL.md +114 -0
- package/skills/loja/SKILL.md +1 -0
- package/skills/loja/templates/PROJETO.md +2 -1
- package/skills/rastreamento-pixel/SKILL.md +2 -0
- package/skills/trilha/SKILL.md +3 -3
- package/skills/trilha/steps/conta_anuncio.md +1 -1
- package/skills/trilha/steps/loja.md +2 -1
- package/skills/trilha/steps/nicho.md +39 -0
- package/skills/trilha/steps/nome.md +61 -0
- package/skills/trilha/steps/pixel.md +1 -1
- package/skills/trilha/steps/pixel_duplo.md +1 -1
- package/skills/trilha/steps/velocidade.md +4 -3
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Iron Edge — Ecossistema de Agentes para Claude Code
|
|
2
2
|
|
|
3
|
-
**44 agentes de topo, 18 squads,
|
|
3
|
+
**44 agentes de topo, 18 squads, 20 skills e memória entre sessões.**
|
|
4
4
|
|
|
5
5
|
Uma equipe completa de IA para marketing, vendas, conteúdo, Shopify, vídeo e crescimento — tudo dentro do Claude Code.
|
|
6
6
|
|
|
@@ -31,7 +31,7 @@ São arquivos `.md` comuns — abrem no Obsidian, no VS Code ou em qualquer edit
|
|
|
31
31
|
Existem **duas coisas diferentes** aqui, e elas se chamam de jeitos diferentes. Confundir as duas
|
|
32
32
|
é o erro mais comum de quem acabou de instalar.
|
|
33
33
|
|
|
34
|
-
**Skills — essas viram comando de barra.** São
|
|
34
|
+
**Skills — essas viram comando de barra.** São 20, e o Claude Code as reconhece por `/nome`:
|
|
35
35
|
|
|
36
36
|
```
|
|
37
37
|
/gate → auditoria de qualidade antes de entregar
|
|
@@ -42,6 +42,7 @@ Existem **duas coisas diferentes** aqui, e elas se chamam de jeitos diferentes.
|
|
|
42
42
|
/loja → a ficha da sua loja no cofre (lê a Shopify)
|
|
43
43
|
/trilha → a próxima etapa da sua loja, medida (no Iron Office: botão "Pedir ao Iron")
|
|
44
44
|
/rastreamento-pixel → a Meta recebendo as vendas da loja, sem contar em dobro
|
|
45
|
+
/anuncios → o retrato dos seus anúncios da Meta e o que corrigir hoje (no Iron Office: aba Anúncios)
|
|
45
46
|
```
|
|
46
47
|
(As outras: `navegador` (regras do Iron no seu Chrome), `anotar`, `faxina`, `conectar-mcp`, `roteiro-video`, `lp-cinematico`, `clone-site`,
|
|
47
48
|
`clone-inventory`, `clone-distill`, `clone-organize`, `clone-transplant`.)
|
|
@@ -175,8 +176,9 @@ npx iron-edge verify
|
|
|
175
176
|
# Iron Office aceita, o resultado acende o checklist da página de Setup do site.
|
|
176
177
|
npx iron-edge doctor
|
|
177
178
|
|
|
178
|
-
#
|
|
179
|
-
|
|
179
|
+
# O cofre nasce junto com a instalação: sem cofre apontado no ~/.iron/config.yaml, o install cria ~/Iron Cofre
|
|
180
|
+
# (pronto pro Obsidian, nunca sobrescreve). Já tem cofre apontado: não cria nada. --cofre força; --sem-cofre pula.
|
|
181
|
+
npx iron-edge install --sem-cofre
|
|
180
182
|
|
|
181
183
|
# Ligar o Iron Office: depois do install (ou update), no Mac/Linux, o comando curto é
|
|
182
184
|
ironoffice # = npx iron-edge@2 office (o install pergunta antes de criar; sem terminal interativo, cria; abra um terminal novo na primeira vez)
|
|
@@ -241,11 +243,13 @@ O que esperar:
|
|
|
241
243
|
|
|
242
244
|
0. **Na primeira vez** (ou quando o texto mudar), ele mostra em poucas linhas o que o canal faz, o que sai da máquina e o que atualiza sozinho, e pergunta `Continuar?`. Não (ou sem terminal interativo) = nada é ligado, nem as flags `--sem-feed`/`--com-feed`. O aceite fica em `~/.iron/office-consent.json`.
|
|
243
245
|
1. O comando confere a sua chave (formato `iok_…` e aceita pelo site) **antes** de abrir o Claude Code. Chave trocada ou fora do formato: ele para e manda refazer o passo 2, em vez de abrir uma sessão que nunca fica online.
|
|
244
|
-
2. Instala (ou atualiza) o plugin de canal `iron-office` e liga o conector oficial do **Meta Ads** (`claude mcp add --scope user --transport http meta-ads https://mcp.facebook.com/ads`; desde a 2.5.0, melhor-esforço: se falhar, o Iron abre normal). O login na Meta é seu: no Iron, digite `/mcp`, escolha `meta-ads` e entre com o seu Facebook. Depois abre o Claude Code com o canal ligado, **dentro do seu cofre** (desde a 2.8.1): o caminho vem do `vault_path` do `~/.iron/config.yaml` (ou `obsidian_vault_path` / `obsidian.vault_path`, de instalações antigas); se ele aponta pra uma pasta dentro do cofre, o Iron sobe até a raiz (a pasta com `.obsidian`). Sem cofre, abre onde você estava e avisa: `npx iron-edge install
|
|
246
|
+
2. Instala (ou atualiza) o plugin de canal `iron-office` e liga o conector oficial do **Meta Ads** (`claude mcp add --scope user --transport http meta-ads https://mcp.facebook.com/ads`; desde a 2.5.0, melhor-esforço: se falhar, o Iron abre normal). O login na Meta é seu: no Iron, digite `/mcp`, escolha `meta-ads` e entre com o seu Facebook. Depois abre o Claude Code com o canal ligado, **dentro do seu cofre** (desde a 2.8.1): o caminho vem do `vault_path` do `~/.iron/config.yaml` (ou `obsidian_vault_path` / `obsidian.vault_path`, de instalações antigas); se ele aponta pra uma pasta dentro do cofre, o Iron sobe até a raiz (a pasta com `.obsidian`). Sem cofre, abre onde você estava e avisa: `npx iron-edge install` (desde a 2.11.0 o cofre nasce na instalação).
|
|
245
247
|
3. O Claude Code mostra um **aviso de tela cheia**: canais ainda são recurso em teste. Aceite.
|
|
246
248
|
4. Abra a página **Iron** do dashboard. Em até 1 minuto aparece "Iron online". Escreva ali e o Iron responde ali.
|
|
247
249
|
5. **Ficha da loja** (skill `loja`, desde a 2.8.0): no site, "Começar com a loja X" (ou diga "monta a ficha"). O Iron lê a Shopify da loja, aponta o que está errado, pergunta só o que falta e grava `Projetos/<loja>/PROJETO.md` e `brand.json` no seu cofre; pro site vai só um resumo de até 600 caracteres (sem sócio, fornecedor, conta de anúncio nem pedido). Daí em diante todo pedido daquela loja chega com a ficha. Desde a 2.9.0, no site as perguntas vêm uma por vez, com botões.
|
|
248
|
-
**Trilha da loja** (skill `trilha`, desde a 2.9.0): no chat, o botão da loja mostra "4/13 etapas" e o atalho **Trilha** (o primeiro, acima da caixa de mensagem) abre a lista (marca, idioma, imagens, velocidade, página de obrigado, pixel, WhatsApp, Instagram, conta de anúncio, compra teste…). "Pedir ao Iron" manda a etapa; o Iron mede na loja e na Meta, faz o que dá e grava a prova que mediu. Etapa que só você pode fazer (login, cartão, configuração no admin) vira um passo no AGORA VOCÊ. Desde a 2.10.0 o Iron conduz todas as etapas de quem já tem loja (skills `rastreamento-pixel` e `navegador`).
|
|
250
|
+
**Trilha da loja** (skill `trilha`, desde a 2.9.0): no chat, o botão da loja mostra "4/13 etapas" e o atalho **Trilha** (o primeiro, acima da caixa de mensagem) abre a lista (marca, idioma, imagens, velocidade, página de obrigado, pixel, WhatsApp, Instagram, conta de anúncio, compra teste…). "Pedir ao Iron" manda a etapa; o Iron mede na loja e na Meta, faz o que dá e grava a prova que mediu. Etapa que só você pode fazer (login, cartão, configuração no admin) vira um passo no AGORA VOCÊ. Desde a 2.10.0 o Iron conduz todas as etapas de quem já tem loja (skills `rastreamento-pixel` e `navegador`). Desde a 2.11.0 conduz também o caminho de quem ainda não tem loja: produto e nicho (com 3 concorrentes que anunciam agora) e nome com domínio e @ livres (medidos); a ficha do projeto nasce no cofre.
|
|
251
|
+
|
|
252
|
+
**Anúncios** (skill `anuncios`, desde a 2.12.0): na aba Anúncios do site, o botão **Atualizar agora** (ou no chat "como estão meus anúncios") faz o Iron medir os últimos 7 dias da sua conta da Meta e mostrar gasto, resultados, custo por resultado e o que corrigir hoje: peça nova que não aparece há mais de 48 h, data vencida ainda no ar, dinheiro indo pra peça vencida e peça recusada. O Iron só lê; pausar uma peça ele pergunta antes. A Meta tem que estar ligada no seu Iron (`/mcp` → `meta-ads` → Authenticate).
|
|
249
253
|
6. **Deixe essa aba do terminal aberta.** É ela que faz o Iron responder no site.
|
|
250
254
|
7. **Pra fechar:** Ctrl+C duas vezes ou `/exit`, e o escritório anoitece em 1 a 2 segundos. No **Warp**, fechar a aba pelo X demora cerca de 1 minuto: o Warp guarda a aba fechada pra poder reabrir, e nesse tempo o canal ainda está vivo. Feche com Ctrl+C antes do X, ou desligue a reabertura de abas fechadas nas configurações do Warp.
|
|
251
255
|
|
package/bin/iron-edge.js
CHANGED
|
@@ -21,7 +21,7 @@
|
|
|
21
21
|
* plugin, cofre, atalho) e, com a chave aceita, manda o resultado
|
|
22
22
|
* pra pagina de Setup do Iron Office
|
|
23
23
|
*
|
|
24
|
-
* install
|
|
24
|
+
* install cria ~/Iron Cofre/ quando nenhum cofre esta apontado (--cofre forca, --sem-cofre pula)
|
|
25
25
|
* install/update --sem-atalho nao cria o alias ironoffice (= office) no ~/.zshrc ou ~/.bashrc
|
|
26
26
|
*
|
|
27
27
|
* uninstall [--dry-run] desfaz a instalacao pelo manifesto (onda 21): tira so' o que
|
|
@@ -174,6 +174,6 @@ if (cmd === 'install') {
|
|
|
174
174
|
process.exit(r.status ?? 1);
|
|
175
175
|
|
|
176
176
|
} else {
|
|
177
|
-
console.log('uso: iron-edge <install|update|verify|office|doctor|uninstall> [--dry-run] [--source <dir>] [--cofre] [--safe] [--sem-feed|--com-feed] [--json]');
|
|
177
|
+
console.log('uso: iron-edge <install|update|verify|office|doctor|uninstall> [--dry-run] [--source <dir>] [--cofre|--sem-cofre] [--safe] [--sem-feed|--com-feed] [--json]');
|
|
178
178
|
process.exit(cmd && cmd !== '--help' && cmd !== '-h' ? 1 : 0);
|
|
179
179
|
}
|
package/installer/cofre.js
CHANGED
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
/**
|
|
3
|
-
* cofre.js —
|
|
4
|
-
*
|
|
3
|
+
* cofre.js — cria um cofre vazio em ~/Iron Cofre/, pronto pro Obsidian. Roda no fim do
|
|
4
|
+
* `npx iron-edge install` quando o config.yaml nao aponta cofre nenhum (onda 27c: o padrao cria;
|
|
5
|
+
* `--cofre` forca, `--sem-cofre` pula; o update nunca cria). Tambem roda sozinho, pra teste.
|
|
5
6
|
*
|
|
6
7
|
* Regras:
|
|
7
8
|
* - copia os 4 itens de installer/cofre/ SO' se nao existirem. Nunca sobrescreve: o cofre e' do
|
|
@@ -36,6 +37,22 @@ function barraNormal(p) { return p.split(path.sep).join('/'); }
|
|
|
36
37
|
// 'gravado' | 'ja-tinha' | 'sem-config' | 'falhou'.
|
|
37
38
|
// "Ninguem apontou" = vault_path ausente, vazio, null ou ~ E sem obsidian_vault_path preenchido
|
|
38
39
|
// (o nome antigo do campo, que o Iron tambem le). Ausente: acrescenta a linha no fim.
|
|
40
|
+
// O cofre que o ~/.iron/config.yaml aponta (vault_path ou o nome antigo obsidian_vault_path), ou null.
|
|
41
|
+
// Vazio, "", null e ~ contam como nao apontado; sem o arquivo tambem.
|
|
42
|
+
function cofreApontado(home) {
|
|
43
|
+
let txt;
|
|
44
|
+
try { txt = fs.readFileSync(path.join(homeReal(home), '.iron', 'config.yaml'), 'utf8'); } catch (_) { return null; }
|
|
45
|
+
for (const nome of ['vault_path', 'obsidian_vault_path']) {
|
|
46
|
+
const m = txt.match(new RegExp('^' + nome + ':(.*)$', 'm'));
|
|
47
|
+
if (!m) continue;
|
|
48
|
+
const v = m[1].replace(/\s+#.*$/, '').trim().replace(/^(["'])(.*)\1$/, '$2').trim();
|
|
49
|
+
if (v && v !== 'null' && v !== '~') return v;
|
|
50
|
+
}
|
|
51
|
+
return null;
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
function vaultApontado(home) { return cofreApontado(home) !== null; }
|
|
55
|
+
|
|
39
56
|
function gravarVaultPath(home, cofre) {
|
|
40
57
|
const cfg = path.join(home, '.iron', 'config.yaml');
|
|
41
58
|
let txt;
|
|
@@ -87,7 +104,13 @@ function criarCofre(opts) {
|
|
|
87
104
|
return { destino, criados, pulados, vault };
|
|
88
105
|
}
|
|
89
106
|
|
|
90
|
-
|
|
107
|
+
// Onda 27c: a decisao do install, isolada pra teste. --sem-cofre vence; --cofre forca; sem flag, cria so quando
|
|
108
|
+
// o config nao aponta cofre nenhum (quem tem Obsidian proprio nao ganha pasta vazia).
|
|
109
|
+
function deveCriarCofre({ home, cofre = false, semCofre = false }) {
|
|
110
|
+
return !semCofre && (cofre || !vaultApontado(home));
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
module.exports = { criarCofre, vaultApontado, cofreApontado, deveCriarCofre, ITENS, NOME };
|
|
91
114
|
|
|
92
115
|
if (require.main === module) {
|
|
93
116
|
criarCofre({ dryRun: process.argv.includes('--dry-run') });
|
package/installer/doctor.js
CHANGED
|
@@ -110,7 +110,7 @@ function checkAtalho(home) {
|
|
|
110
110
|
|
|
111
111
|
function checkCofre(home) {
|
|
112
112
|
const ok = fs.existsSync(path.join(home, 'Iron Cofre', 'CLAUDE.md'));
|
|
113
|
-
return item(ok, ok ? '~/Iron Cofre' : 'sem cofre pronto (
|
|
113
|
+
return item(ok, ok ? '~/Iron Cofre' : 'sem cofre pronto (rode npx iron-edge install)');
|
|
114
114
|
}
|
|
115
115
|
|
|
116
116
|
async function medir(opts) {
|
package/installer/install.js
CHANGED
|
@@ -16,7 +16,7 @@
|
|
|
16
16
|
* - Manifesto com SHA-256 (gerados marcados generated:true).
|
|
17
17
|
* - shopify.yaml nasce desativado. config em branco (sem PII).
|
|
18
18
|
*
|
|
19
|
-
* Uso: node install.js [--dry-run] [--source <dir>] [--cofre] [--sem-atalho]
|
|
19
|
+
* Uso: node install.js [--dry-run] [--source <dir>] [--cofre] [--sem-cofre] [--sem-atalho]
|
|
20
20
|
*/
|
|
21
21
|
|
|
22
22
|
'use strict';
|
|
@@ -41,7 +41,11 @@ function abort(msg) {
|
|
|
41
41
|
|
|
42
42
|
const args = process.argv.slice(2);
|
|
43
43
|
const DRY_RUN = args.includes('--dry-run');
|
|
44
|
-
|
|
44
|
+
// onda 27c: o cofre nasce junto com a instalacao (~/Iron Cofre/, installer/cofre.js) quando o config.yaml
|
|
45
|
+
// nao aponta cofre nenhum. --cofre forca (como antes), --sem-cofre pula.
|
|
46
|
+
const COFRE = args.includes('--cofre');
|
|
47
|
+
const SEM_COFRE = args.includes('--sem-cofre');
|
|
48
|
+
const criaCofre = () => require('./cofre').deveCriarCofre({ home: HOME, cofre: COFRE, semCofre: SEM_COFRE });
|
|
45
49
|
const SEM_ATALHO = args.includes('--sem-atalho'); // nao cria o alias ironoffice (installer/atalho.js)
|
|
46
50
|
const srcIdx = args.indexOf('--source');
|
|
47
51
|
let SOURCE = srcIdx >= 0 && args[srcIdx + 1] ? path.resolve(args[srcIdx + 1]) : __dirname;
|
|
@@ -337,7 +341,7 @@ if (DRY_RUN) {
|
|
|
337
341
|
if (payloadPlan.length > 10) log(` ... e mais ${payloadPlan.length - 10} arquivos`);
|
|
338
342
|
log('\n--- arquivos que SERAO gerados ---');
|
|
339
343
|
for (const g of GENERATED) log(' ' + g.dest);
|
|
340
|
-
if (
|
|
344
|
+
if (criaCofre()) require('./cofre').criarCofre({ home: HOME, dryRun: true });
|
|
341
345
|
log('\n--- atalho ---');
|
|
342
346
|
log(' ' + require('./atalho').atalhoNoFim({ HOME, dryRun: true, semAtalho: SEM_ATALHO }));
|
|
343
347
|
log('\nDRY-RUN concluido. Nada foi copiado.');
|
|
@@ -579,10 +583,15 @@ log(' Os outros 43 agentes se chamam PEDINDO ("usa o iron-copy").');
|
|
|
579
583
|
const nSkills = (() => { try { return fs.readdirSync(path.join(SOURCE, 'skills')).filter((d) => !d.startsWith('.')).length; } catch (_) { return null; } })();
|
|
580
584
|
log(` As ${nSkills || ''} SKILLS sao de barra: /gate /salvar /brandkit /escada ...`.replace(' ', ' '));
|
|
581
585
|
log('');
|
|
582
|
-
if (
|
|
586
|
+
if (criaCofre()) {
|
|
583
587
|
log('3. Memoria: o cofre (detalhes abaixo).');
|
|
588
|
+
log(' O cofre e uma pasta de arquivos .md na SUA maquina, onde o Iron guarda quem voce e,');
|
|
589
|
+
log(' seus projetos e o que ficou pendente. Abra ela no Obsidian. (Nao quer? --sem-cofre)');
|
|
584
590
|
require('./cofre').criarCofre({ home: HOME });
|
|
585
591
|
log('');
|
|
592
|
+
} else if (!SEM_COFRE) {
|
|
593
|
+
log('3. Memoria: o cofre ja esta apontado em ' + require('./cofre').cofreApontado(HOME) + '.');
|
|
594
|
+
log('');
|
|
586
595
|
} else {
|
|
587
596
|
log('3. Ligue a memoria. Diga a ele:');
|
|
588
597
|
log('');
|
package/installer/office.js
CHANGED
|
@@ -331,7 +331,7 @@ async function main(argv) {
|
|
|
331
331
|
console.log('Pra fechar: Ctrl+C duas vezes (no Warp, antes do X).');
|
|
332
332
|
const cofre = resolveCwd();
|
|
333
333
|
if (cofre.cwd) console.log('Abrindo dentro do cofre: ' + cofre.cwd);
|
|
334
|
-
else console.log(' [aviso] cofre nao encontrado' + (cofre.configured ? ' em ' + cofre.configured : '') + ': rode npx iron-edge install
|
|
334
|
+
else console.log(' [aviso] cofre nao encontrado' + (cofre.configured ? ' em ' + cofre.configured : '') + ': rode npx iron-edge install');
|
|
335
335
|
console.log('');
|
|
336
336
|
|
|
337
337
|
const abrir = (cwd) => spawnSync(claude, buildClaudeArgs(argv), {
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "iron-edge",
|
|
3
|
-
"version": "2.
|
|
4
|
-
"description": "Ecossistema de agentes para Claude Code: 44 agentes de topo, 18 squads e
|
|
3
|
+
"version": "2.12.0",
|
|
4
|
+
"description": "Ecossistema de agentes para Claude Code: 44 agentes de topo, 18 squads e 20 skills, com quality gate, memoria, instalador que nunca sobrescreve o comando office (chat do Iron Office no dashboard; confere a chave com o site antes de abrir o Claude) e o doctor (mede a maquina e acende o Setup do site).",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"claude",
|
|
7
7
|
"claude-code",
|
|
@@ -0,0 +1,114 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: anuncios
|
|
3
|
+
description: Fotografa a conta de anúncios da Meta do projeto (últimos 7 dias), acha os 3 problemas que a Meta não avisa (peça nova que não aparece, data vencida no ar, dinheiro na peça errada) e mais a peça recusada, e grava o retrato na aba Anúncios do Iron Office. Use quando chegar `anúncios: atualizar` (botão do site) ou o aluno disser "como estão meus anúncios", "meus anúncios", "quanto gastei", "o anúncio parou", "por que meu anúncio não roda".
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# anuncios — o retrato da conta da Meta, com o que fazer hoje
|
|
7
|
+
|
|
8
|
+
O aluno abre a aba Anúncios do projeto e vê gasto, resultados, custo por resultado e os alertas. Quem tira esse retrato é você, com a conta dele, no computador dele. O site só guarda o que você mediu (ferramenta `ads_status`): nunca token, nunca login, nunca nome de pessoa nem telefone.
|
|
9
|
+
|
|
10
|
+
**Regras que não mudam:**
|
|
11
|
+
- Nunca invente número. Todo número da resposta e do retrato saiu de uma chamada desta vez.
|
|
12
|
+
- Só lê. Pausar peça é UMA pergunta pela `ask` antes, e só no "Sim". Criar campanha, mudar verba ou público não é desta skill: diga que é pelo chat, com aprovação, e pare.
|
|
13
|
+
- **Zero alerta é resultado válido.** Diga em 1 linha e grave o retrato do mesmo jeito.
|
|
14
|
+
|
|
15
|
+
Palavras de aluno: "conjunto de anúncios" vira **grupo**; "CPA" vira **custo por resultado**; "impressões" vira **vezes que apareceu**; status técnico (`effective_status`, `ACTIVE`) nunca aparece: diga "no ar" ou "pausada".
|
|
16
|
+
|
|
17
|
+
## 0. Antes
|
|
18
|
+
|
|
19
|
+
Leia a ficha do projeto (o `PROJETO.md` da linha `[loja: …]`): a linha **Anúncios** (conta de anúncio), país e moeda, e se houver, a data que vale agora (turma, promoção, "vagas preenchidas").
|
|
20
|
+
|
|
21
|
+
## 1. Sem a Meta nesta sessão
|
|
22
|
+
|
|
23
|
+
Se as ferramentas `mcp__meta-ads__*` não existem: não diga "não dá". Uma linha ("pra eu ler os seus anúncios, o Iron precisa estar ligado na sua conta do Facebook; é uma vez só") e os 3 passos, os mesmos da skill `rastreamento-pixel`:
|
|
24
|
+
|
|
25
|
+
AGORA VOCÊ
|
|
26
|
+
1. No terminal onde o Iron roda, digite `/mcp` e aperte Enter.
|
|
27
|
+
2. Com as setas, vá até `meta-ads` e aperte Enter; escolha **Authenticate**. Abre uma página no navegador: entre com o Facebook que anuncia a loja e autorize.
|
|
28
|
+
3. Feche o Iron (Ctrl+C duas vezes), abra de novo com `ironoffice` e peça "anúncios: atualizar".
|
|
29
|
+
|
|
30
|
+
Pare aqui. **Não grave retrato** (a aba já mostra esses passos sozinha).
|
|
31
|
+
|
|
32
|
+
## 2. Qual conta
|
|
33
|
+
|
|
34
|
+
`ads_get_ad_accounts` (a lista vem em páginas de 50: com `next_cursor`, chame de novo com ele até acabar). Só servem as com `is_ads_mcp_enabled: true` **e** `is_queryable: true`; conta do projeto com `is_queryable: false`: diga em 1 linha o `not_queryable_reason` (é a Meta explicando: conta desativada, pagamento pendente…) e pare.
|
|
35
|
+
- A conta da linha Anúncios da ficha, se está na lista: é ela.
|
|
36
|
+
- Sem ficha e uma conta só: é ela. Várias: `ask` "Qual conta anuncia este projeto?" (opções = os nomes, até 6; `skip: true`) e grave a escolha na linha **Anúncios** da tabela da ficha (bloco `<!-- iron:ficha -->`, mesclando, como na skill `loja`).
|
|
37
|
+
- A conta do projeto veio com `is_ads_mcp_enabled: false`: diga em 1 linha que a Meta ainda não liberou a leitura dessa conta pro Iron (está liberando aos poucos) e pare. Nunca troque por outra conta em silêncio.
|
|
38
|
+
- Moeda da conta diferente da moeda da loja: diga em 1 linha (a etapa `conta_anuncio` da trilha trata) e siga medindo.
|
|
39
|
+
|
|
40
|
+
Nas ferramentas, `ad_account_id` é só o número (sem `act_`).
|
|
41
|
+
|
|
42
|
+
**Fuso e "hoje":** `ads_get_ad_entities` com `level: "ad_account"` e `fields: ["timezone_name"]`. "Hoje" é a data **nesse fuso** (calcule no terminal, vale no Mac e no Windows; devolve hoje, hoje − 6 e hoje − 2, em AAAA-MM-DD, sem conta de cabeça na virada do mês: `node -e "const z='<timezone_name>',d=n=>new Date(Date.now()-n*864e5).toLocaleDateString('sv',{timeZone:z});console.log(d(0),d(6),d(2))"`), e todas as janelas abaixo partem dele. Hora pro aluno, sempre nesse fuso e com "há N h".
|
|
43
|
+
|
|
44
|
+
## 3. Medir (7 dias, com hoje)
|
|
45
|
+
|
|
46
|
+
⛔ **Nunca `date_preset: "last_7d"` nem `last_3d`.** Eles deixam o dia de hoje de fora: a peça ligada ontem aparece com zero enquanto já está aparecendo, e você acusaria uma peça boa. Sempre `time_range` explícito, como texto JSON: `'{"since":"<hoje − 6 dias>","until":"<hoje>"}'`.
|
|
47
|
+
|
|
48
|
+
Antes de passar um campo novo em `fields`, confira com `ads_get_field_context` (a ferramenta recusa campo que não existe naquele nível). Os desta skill, conferidos em 30/10/2026.
|
|
49
|
+
|
|
50
|
+
**Como os números chegam (medido):** `amount_spent` vem como `{"value": "152.40", "unit": "BRL"}`: texto, já na moeda da conta (não é centavo). `results` vem como `{"indicator": "...", "value": "6"}` e, sem resultado, `"value": "Not available"`. `cost_per_result` igual, às vezes com o texto do tipo entre parênteses. Regra: converta `value` pra número; `"Not available"`, vazio ou campo ausente = **0**. O `indicator` diz o tipo de resultado (ex.: `reach` = alcance, `...messaging_conversation_started...` = conversa iniciada, `...purchase...` = compra).
|
|
51
|
+
|
|
52
|
+
a) **Por peça, 7 dias:** `ads_get_ad_entities` com `level: "ad"`, `time_range` dos 7 dias, `fields: ["name","campaign_name","adset_name","adset_id","effective_status","amount_spent","impressions","clicks","results","updated_time","created_time","creative_id"]`. Siga `pagination.next_cursor` até o fim (repetindo todos os outros parâmetros). **Campo ausente = 0**: peça sem gasto volta sem `amount_spent` e sem `impressions`, não com zero. O **gasto de cada grupo nos 7 dias** é a soma das peças dele (junte por `adset_id`, nunca pelo nome).
|
|
53
|
+
b) **Por campanha, 7 dias:** a mesma chamada com `level: "campaign"` e `fields: ["name","effective_status","objective","amount_spent","impressions","clicks","results","cost_per_result"]`, até a última página. **Os totais do retrato (`spend`, `impressions`, `clicks`, `results`) são a soma de TODAS as campanhas lidas**, não só das 10 que vão pro retrato.
|
|
54
|
+
c) **Por peça, 3 dias** (só pro alerta C): `level: "ad"`, `time_range` `'{"since":"<hoje − 2>","until":"<hoje>"}'`, `fields: ["name","campaign_name","adset_id","effective_status","amount_spent"]`, até a última página. O gasto do grupo nos 3 dias = soma das peças dele por `adset_id`. Pro rótulo do resultado, `level: "adset"` com `fields: ["name","optimization_goal"]` (7 dias).
|
|
55
|
+
d) **Erros:** `ads_get_errors` com `entity_ids: ["<número da conta>"]` (traz os erros das peças dela).
|
|
56
|
+
e) **Texto das peças:** `ads_get_creatives` com `creative_ids` (os do passo a, em lotes) e `fields: ["body","title"]`.
|
|
57
|
+
|
|
58
|
+
**Resultado** = o que a campanha busca (compra, conversa, cadastro): leia o `indicator` do `results`, o `objective` da campanha e o `optimization_goal` do grupo e escreva o rótulo em palavra de aluno ("compras", "conversas no WhatsApp", "cadastros"). Campanhas com tipos de resultado diferentes: some `results` mesmo assim e use "resultados" no rótulo, dizendo na resposta quais tipos entraram. Em dúvida, "resultados".
|
|
59
|
+
|
|
60
|
+
## 4. Os alertas
|
|
61
|
+
|
|
62
|
+
A, B e C só olham peça no ar (`effective_status` `ACTIVE`). A **recusada** olha qualquer situação: peça recusada aparece como `DISAPPROVED` ou `WITH_ISSUES`, nunca como `ACTIVE`.
|
|
63
|
+
|
|
64
|
+
**A · nova_em_zero (peça nova sem aparecer).** Impressões = 0 nos 7 dias **e** passaram mais de 48 h desde `updated_time` **e** o grupo dela gastou mais que 0 nos 7 dias (a soma do passo 3a). Conta-se do `updated_time`, não do `created_time`: a peça que foi editada volta pra fila de entrega da Meta, então a rampa recomeça na edição. No `detail`, escreva "desde a última mudança, em <data e hora>". Com menos de 48 h a peça está **em rampa**: não é alerta, vai pra lista `ramp` com `until` = `updated_time` + 48 h ("reconferir em"). A Meta leva horas pra distribuir entre peças novas; acusar antes disso ensina o aluno a ignorar o alerta.
|
|
65
|
+
- **recusada:** peça com erro no `ads_get_errors` (reprovação, revisão, texto ou imagem recusados) ou com `effective_status` `DISAPPROVED` entra como `recusada` **com qualquer idade e qualquer situação**: não é rampa, é peça que nunca vai entregar. Rode `ads_get_errors` justamente pra separar as duas.
|
|
66
|
+
|
|
67
|
+
**B · data_vencida (data vencida no ar).** Data no nome da peça ou no texto (`body`/`title`) anterior a hoje. Formatos: `DD/MM`, `DD e DD/MM`, `até DD/MM`, "dia 25 de outubro", e `turma MM/AA` (mês inteiro: só vence depois do último dia do mês). Só conta como data o que é data de verdade: dia de 1 a 31 e mês de 1 a 12, perto de palavra de data ("dia", "até", "turma", "em", um mês por extenso) ou no formato da convenção do nome; "24/7", "50/50", "3/4" e proporção não são data. Com mais de uma data, vale a **última** (se a última ainda não passou, não é alerta). Ano: o corrente; se a data no ano corrente ficou mais de 6 meses pra trás, é do ano seguinte. Em dúvida se é data, não acuse: diga na resposta "a peça X tem '<trecho>', não sei se é data". Antes de acusar, leia `campaign_name`: a mesma data pode ser de turma futura numa campanha e de atendimento passado em outra. Se a ficha tem a data que vale agora ou "vagas preenchidas", cruze com ela. Peça sem data não entra no B (só no A).
|
|
68
|
+
|
|
69
|
+
**C · gasto_na_peca_errada (dinheiro na peça errada).** Nos últimos 3 dias, mais de 80 % do gasto de um grupo foi em peças com data vencida (B). O `detail` diz a porcentagem e o valor.
|
|
70
|
+
|
|
71
|
+
**O que não dá pra ler:** a arte (texto dentro da imagem ou do vídeo) e a mensagem de boas-vindas do WhatsApp. No retrato `checked.art` é sempre `false`, e a resposta diz "conferi o texto de N peças; a arte não".
|
|
72
|
+
|
|
73
|
+
Cada alerta leva a peça, a campanha, o número que o sustenta (`detail`, até 160 caracteres) e o que fazer (`action`, até 160): ex. `detail` "no ar desde 27/10 14h, 0 vezes que apareceu, grupo gastou R$ 48 no período"; `action` "confira se o público do grupo é grande o bastante ou pause e suba a peça num grupo próprio". Nada de nome de pessoa, telefone ou e-mail nesses textos.
|
|
74
|
+
|
|
75
|
+
## 5. Gravar
|
|
76
|
+
|
|
77
|
+
`ads_status` com o `project_id` (o `id:` da linha `[loja: …]`) e o `snapshot`:
|
|
78
|
+
|
|
79
|
+
```json
|
|
80
|
+
{ "v": 1, "at": "<agora, ISO com fuso>", "account_id": "<número da conta>", "account_name": "<nome da conta, até 60>",
|
|
81
|
+
"currency": "<moeda da conta, 3 letras>", "window_days": 7,
|
|
82
|
+
"spend": 0, "impressions": 0, "clicks": 0, "results": 0, "result_label": "compras", "cpa": null,
|
|
83
|
+
"campaigns": [{ "name": "…", "status": "ACTIVE", "spend": 0, "results": 0 }],
|
|
84
|
+
"top_ads": [{ "name": "…", "campaign": "…", "spend": 0, "impressions": 0, "results": 0 }],
|
|
85
|
+
"alerts": [{ "kind": "data_vencida", "ad": "…", "campaign": "…", "since": "<ISO, opcional>", "detail": "…", "action": "…" }],
|
|
86
|
+
"checked": { "ads": 0, "copy": 0, "art": false },
|
|
87
|
+
"ramp": [{ "ad": "…", "until": "<ISO>" }] }
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
- `campaigns`: até 10, as que gastaram mais primeiro. `status` = o `effective_status` como veio (`ACTIVE`, `PAUSED`, `ARCHIVED`, `CAMPAIGN_PAUSED`…): o site mostra `ACTIVE` como "no ar" e o resto como "pausada". `top_ads`: as 5 peças que mais gastaram. `alerts` e `ramp`: até 10 cada. `cpa` = gasto ÷ resultados (`null` sem resultado). `checked.ads` = peças medidas; `checked.copy` = peças com texto lido.
|
|
91
|
+
- Até 8 kB: nomes longos, encurte. Nome com telefone, e-mail ou `@perfil` chega no site como `[removido]` (o filtro protege o aluno); é esperado.
|
|
92
|
+
- A ferramenta recusou (`O site recusou o retrato: …`)? Corrija o que ela disse e mande de novo uma vez. Recusou de novo: responda os números no chat e diga que o retrato não foi gravado.
|
|
93
|
+
|
|
94
|
+
Na ficha: a linha Anúncios com a conta (se faltava) e 1 linha no Histórico: `AAAA-MM-DD: anúncios medidos pelo Iron: gasto <valor>, <N> alertas`.
|
|
95
|
+
|
|
96
|
+
## 6. Responder
|
|
97
|
+
|
|
98
|
+
Até 4 linhas:
|
|
99
|
+
1. "Últimos 7 dias: <gasto> e <N> <rótulo> (custo por resultado <valor>)."
|
|
100
|
+
2. "<N> alertas" ou "Nada pra corrigir hoje."
|
|
101
|
+
3. "Conferi o texto de <N> peças; a arte não."
|
|
102
|
+
4. "O retrato está na aba Anúncios."
|
|
103
|
+
|
|
104
|
+
Com alerta, termine com o AGORA VOCÊ: o clique certo (no Gerenciador de Anúncios, a peça X → desligar) ou a oferta de pausar:
|
|
105
|
+
- `ask` "Quer que eu pause a peça <nome>?" (opções Sim / Não). Só no **Sim**: `ads_update_entity` com `entity_type: "ad"`, `entity_id` da peça, `fields: '{"status":"PAUSED"}'`. Não chame `ads_activate_entity` depois. Confira lendo de volta (`ads_get_ad_entities` `level: "ad"` com `object_ids` = a peça): só diga "pausada" se o `effective_status` voltou pausado. Depois do sim, tire o retrato de novo (passos 3 a 5) pra aba ficar certa.
|
|
106
|
+
- Uma pergunta por mensagem; uma peça por vez.
|
|
107
|
+
|
|
108
|
+
## Teste do instrumento (pra quem for mexer nesta skill)
|
|
109
|
+
|
|
110
|
+
Os dois lados, sempre:
|
|
111
|
+
- **Acusa:** peça no ar há mais de 48 h (por `updated_time`), zero vezes que apareceu, grupo gastando → `nova_em_zero`. Peça com data `25/10` no nome, no ar em 30/10 → `data_vencida`.
|
|
112
|
+
- **Não acusa:** peça de 27 h com zero (vai pra `ramp`); peça pausada com data vencida; peça com `— 11 e 12/12` em 30/10 (data futura); `turma 10/26` em 30/10/2026 (o mês ainda não acabou); "atendimento 24/7"; peça ligada ontem que já apareceu hoje (é o caso que o `last_7d` erra: por isso ele é proibido).
|
|
113
|
+
- **Recusada com qualquer situação:** peça `DISAPPROVED` com data futura → `recusada` (o filtro "só no ar" não vale pra ela).
|
|
114
|
+
Mudou uma regra e um dos dois lados deixou de bater? A skill quebrou, não a conta.
|
package/skills/loja/SKILL.md
CHANGED
|
@@ -115,6 +115,7 @@ Sem domínio, ou se o `clone-inventory` falhar (sem navegador, site fora do ar):
|
|
|
115
115
|
- Existe: **nunca sobrescreva o arquivo.** Só o trecho entre `<!-- iron:ficha -->` e `<!-- /iron:ficha -->` é do Iron, e mesmo ele é **mesclado**:
|
|
116
116
|
- valor que já estava preenchido continua (só troca se a Shopify ou o aluno trouxe um valor NOVO pra ele);
|
|
117
117
|
- nunca troque um valor preenchido por "(a preencher)";
|
|
118
|
+
- linha da tabela que o modelo tem e o arquivo não (ficha antiga, ex.: `Concorrentes`): acrescente a linha no lugar dela; nunca apague uma linha que já está lá;
|
|
118
119
|
- item de **Em aberto** já marcado com `[x]` fica marcado; pergunta respondida sai de **Em aberto**;
|
|
119
120
|
- **Achados** e **Catálogo** são da leitura de hoje: podem ser trocados inteiros.
|
|
120
121
|
- Arquivo sem os marcadores: acrescente o bloco no FIM do arquivo, sem apagar nada.
|
|
@@ -14,7 +14,7 @@ atualizado: AAAA-MM-DD
|
|
|
14
14
|
|
|
15
15
|
| | |
|
|
16
16
|
|---|---|
|
|
17
|
-
| Tipo | Loja Shopify · Cliente ·
|
|
17
|
+
| Tipo | Loja Shopify · Cliente · Ainda não tenho loja |
|
|
18
18
|
| Site | <domínio público ou (a preencher)> |
|
|
19
19
|
| Shopify | <loja.myshopify.com ou não tem> |
|
|
20
20
|
| País / moeda | <país> · <moeda> |
|
|
@@ -22,6 +22,7 @@ atualizado: AAAA-MM-DD
|
|
|
22
22
|
| Nicho | <nicho> |
|
|
23
23
|
| Oferta | <a oferta em 1 frase> |
|
|
24
24
|
| Público | <quem compra> |
|
|
25
|
+
| Concorrentes | <3 páginas com anúncio ativo> |
|
|
25
26
|
| Ticket | <ticket médio> |
|
|
26
27
|
| Pagamento | <COD, cartão, os dois> |
|
|
27
28
|
| Sócio / time | <quem decide o quê> |
|
|
@@ -20,6 +20,8 @@ AGORA VOCÊ
|
|
|
20
20
|
2. Com as setas, vá até `meta-ads` e aperte Enter; escolha **Authenticate** (ou "Entrar"). Abre uma página no navegador: entre com o Facebook que anuncia a loja e autorize.
|
|
21
21
|
3. Volte ao terminal, feche o Iron (Ctrl+C duas vezes) e abra de novo com `ironoffice`. Enquanto ele estiver fechado, o chat do site fica sem resposta.
|
|
22
22
|
|
|
23
|
+
O retrato dos anúncios (gasto, resultados e alertas na aba Anúncios do site) é a skill `anuncios`; esta cuida só do pixel.
|
|
24
|
+
|
|
23
25
|
Se `meta-ads` nem aparece na lista do `/mcp`: "rode `npx iron-edge office` no terminal (ele instala a ligação com a Meta) e depois faça os passos acima" (a skill `conectar-mcp` tem o detalhe). Grave a etapa da trilha como `em_andamento` e pare.
|
|
24
26
|
|
|
25
27
|
## Ato 1 · Medir
|
package/skills/trilha/SKILL.md
CHANGED
|
@@ -36,7 +36,7 @@ Abra `steps/<id>.md` (nesta pasta) e siga. Cada arquivo diz **o que medir** (fer
|
|
|
36
36
|
- **Quem faz:** o que dá pra fazer pela ferramenta, você faz. O que é do aluno por segurança (login, código, cartão, aceitar termo, trocar configuração no admin) vai pro AGORA VOCÊ com o clique exato.
|
|
37
37
|
- **Pergunta:** UMA por mensagem, pela ferramenta `ask`, com opções quando a resposta é fechada (até 6) e `skip: true`. Espere a resposta antes da próxima. Nunca mande lista de perguntas.
|
|
38
38
|
|
|
39
|
-
**Etapa com `v27a: false`** (
|
|
39
|
+
**Etapa com `v27a: false`** (se um dia o `trail_status` trouxer alguma): o Iron ainda não conduz sozinho. Explique em até 6 linhas o que é e por que importa (use o `why` e o `proof_rule`), diga "essa o Iron ainda não conduz sozinho; quando fizer, me diga 'já fiz' que eu marco" e pare. Quando o aluno disser "já fiz" sobre ela: `trail_update` com `status: "feita"` (sem prova) e responda em 1 linha.
|
|
40
40
|
|
|
41
41
|
**Etapa que precisa do Chrome** (tela sem API: admin da Shopify, app de pagamento na entrega, Meta Business, página do Facebook): carregue a skill `navegador` ANTES de qualquer ferramenta do navegador. Sem a extensão: o caminho da tela vai pro AGORA VOCÊ e a etapa fica `em_andamento`.
|
|
42
42
|
|
|
@@ -46,7 +46,7 @@ Abra `steps/<id>.md` (nesta pasta) e siga. Cada arquivo diz **o que medir** (fer
|
|
|
46
46
|
|
|
47
47
|
**Etapa derivada** (`derived: true`, hoje `loja` e `ficha`): o site calcula. Nunca chame `trail_update` nela (o aluno pode pular pelo site, por exemplo numa loja de cliente sem Shopify).
|
|
48
48
|
|
|
49
|
-
**Palavras de aluno:** o `proof_rule` e os `steps/` são escritos pra você. Pro aluno, traduza: "brand.json" vira "o arquivo da marca no seu cofre", "CDN da Shopify" vira "as fotos guardadas dentro da sua Shopify", "PageSpeed" vira "a nota de velocidade do Google", "evento do servidor" vira "a Meta recebendo a venda direto da loja", "dataset" vira "o pixel", "conta de anúncio" fica, "BM"/"portfólio empresarial" vira "o portfólio da sua empresa no Facebook". Nada de nome de ferramenta, campo ou API na resposta.
|
|
49
|
+
**Palavras de aluno:** o `proof_rule` e os `steps/` são escritos pra você. Pro aluno, traduza: "brand.json" vira "o arquivo da marca no seu cofre", "CDN da Shopify" vira "as fotos guardadas dentro da sua Shopify", "PageSpeed" vira "a nota de velocidade do Google", "evento do servidor" vira "a Meta recebendo a venda direto da loja", "dataset" vira "o pixel", "conta de anúncio" fica, "BM"/"portfólio empresarial" vira "o portfólio da sua empresa no Facebook", "RDAP" vira "o registro de domínios", "Biblioteca de Anúncios" fica, "handle" vira "@". Nada de nome de ferramenta, campo ou API na resposta.
|
|
50
50
|
|
|
51
51
|
**"Já fiz" pelo site:** etapa que o Iron ainda não conduz tem o botão "Já fiz" no painel; ela chega `feita` no `trail_status` sem passar por você. Não refaça nem desconfie: siga pra próxima.
|
|
52
52
|
|
|
@@ -62,7 +62,7 @@ A prova vai pro site. **Nada de e-mail, telefone, nome de cliente, chave ou toke
|
|
|
62
62
|
|
|
63
63
|
## 5. Responda curto
|
|
64
64
|
|
|
65
|
-
No chat, em até 4 linhas: o que você mediu, o que mudou e "Próxima: <título da próxima
|
|
65
|
+
No chat, em até 4 linhas: o que você mediu, o que mudou e "Próxima: <título da próxima, como está no `trail_status`>". Sempre o **título**, nunca o id (nada de "a próxima é pixel_duplo"). Depois, um `ask`: "Seguir pra <título da próxima>?" com as opções `Sim` e `Depois` (`skip: false`). Se ficou ação do aluno, o AGORA VOCÊ vem antes do `ask`, em texto normal:
|
|
66
66
|
|
|
67
67
|
AGORA VOCÊ
|
|
68
68
|
1. <o clique exato, onde fica>
|
|
@@ -4,7 +4,7 @@ Moeda errada na conta de anúncio não se troca depois. Sem forma de pagamento,
|
|
|
4
4
|
|
|
5
5
|
## Medir
|
|
6
6
|
1. Moeda da loja: `shop_query` `query { shop { currencyCode } }`.
|
|
7
|
-
2. Conta de anúncio: `ads_get_ad_accounts` (só as com `is_ads_mcp_enabled: true`). Mais de uma: a da ficha; sem ela, `ask` "Qual conta anuncia esta loja?" (opções = os nomes, até 6) e grave na ficha (
|
|
7
|
+
2. Conta de anúncio: `ads_get_ad_accounts` (só as com `is_ads_mcp_enabled: true`). Mais de uma: a da ficha; sem ela, `ask` "Qual conta anuncia esta loja?" (opções = os nomes, até 6) e grave na ficha (linha Anúncios da tabela). Campos: `currency`, `has_payment_method`, `account_status`.
|
|
8
8
|
Sem as ferramentas da Meta nesta sessão: os 3 passos do `/mcp` (skill `rastreamento-pixel`, "Sem a Meta nesta sessão") e `em_andamento`.
|
|
9
9
|
|
|
10
10
|
## Fazer
|
|
@@ -3,5 +3,6 @@
|
|
|
3
3
|
Derivada: o site marca sozinho quando a Shopify da loja está conectada. Nunca chame `trail_update` aqui.
|
|
4
4
|
|
|
5
5
|
- Não conectada: "Pra eu ler e mexer na loja, conecte a Shopify dela no site: Integrações → cartão da Shopify → Conectar. Leva 2 minutos." AGORA VOCÊ com esse caminho.
|
|
6
|
-
- Ainda não tem Shopify:
|
|
6
|
+
- Ainda não tem Shopify: se o site mostra o botão **Criar minha loja na Shopify** na etapa Loja (painel da trilha ou chat vazio), mande o aluno usar esse botão (é o link do Iron Office). Sem o botão, diga "crie a sua loja no site da Shopify". Nunca escreva uma URL de criação de loja na resposta.
|
|
7
|
+
- Criou a loja e o projeto é do tipo "Ainda não tenho loja": em Integrações, o cartão do projeto tem **Mudar pra Loja Shopify e conectar** (a trilha e a ficha continuam as mesmas). AGORA VOCÊ com esse caminho.
|
|
7
8
|
- Já conectada: diga em 1 linha e siga pra próxima.
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
# Etapa: nicho (Produto e nicho escolhidos)
|
|
2
|
+
|
|
3
|
+
Caminho de quem ainda não tem loja. Produto escolhido no chute vira loja sem venda; produto com concorrente anunciando agora mostra que alguém já compra.
|
|
4
|
+
|
|
5
|
+
Uma pergunta por mensagem, pela `ask`, com `skip: true`.
|
|
6
|
+
|
|
7
|
+
## 1. Onde o aluno está
|
|
8
|
+
Ficha com `Nicho` e `Oferta` já preenchidos: não pergunte, vá pro bloco 3.
|
|
9
|
+
Senão, `ask` "Você já tem um produto ou nicho em mente?" com as opções `Sim, já sei o produto` / `Tenho o nicho, falta o produto` / `Ainda não, quero ajuda pra escolher`.
|
|
10
|
+
- **Já sei o produto:** peça o produto (`ask`, `free: true`) e vá pro bloco 3.
|
|
11
|
+
- **Falta o produto** ou **quero ajuda:** bloco 2.
|
|
12
|
+
|
|
13
|
+
## 2. Ajuda pra escolher
|
|
14
|
+
1. Mercado: o país da ficha; sem ele, `ask` "Pra qual país você vai vender?" com `BR` / `CO` / `MX` / `outro`.
|
|
15
|
+
2. Chame o subagente `iron-research` com o país (e o nicho, se o aluno já disse). Peça **3 candidatos**, cada um com: nicho, 1 produto e 1 linha de por quê (procura, ticket, dá pra entregar no país).
|
|
16
|
+
3. `ask` "Qual desses?" com os 3 produtos + `Nenhum, outra rodada`. No máximo 2 rodadas; depois disso peça ao aluno que diga o produto (`ask`, `free: true`).
|
|
17
|
+
|
|
18
|
+
## 3. Três concorrentes com anúncio ativo
|
|
19
|
+
Vá pelas fontes nesta ordem. Uma fonte que não existe nesta sessão, deu erro (ex.: a Meta pediu login) ou trouxe menos de 3 páginas boas: siga pra próxima e complete com ela. `fonte` = a lista das que contribuíram (ex.: `["meta", "aluno"]`).
|
|
20
|
+
- **(a) Meta:** a ferramenta `mcp__meta-ads__ads_library_search` existe → `search_terms` = o produto, `countries` = [país do mercado], `ad_active_status` = ativos, `limit` 50. Junte por `page_id` (a mesma página aparece várias vezes) e fique com 3 páginas diferentes **que vendem o produto** (o texto ou o título do anúncio fala dele). Na dúvida se a página vende o produto (o título vem vazio ou genérico), abra o `ad_snapshot_url` do anúncio ou não conte a página. `fonte: "meta"`.
|
|
21
|
+
- **(b) Chrome:** sem a Meta, carregue a skill `navegador` e abra `https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=<CC>&q=<produto>` (não pede login). Leia 3 nomes de página com anúncio "Ativo". `fonte: "chrome"`. Sem a extensão do Chrome, vá pra (c).
|
|
22
|
+
- **(c) Apify:** `test -n "$APIFY_TOKEN" && echo tem` diz `tem` (nunca imprima o valor) → agente `iron-spy`, pedindo SÓ os 3 nomes de página que vendem o produto, sem dashboard. `fonte: "apify"`.
|
|
23
|
+
- **(d) O aluno:** `ask` (uma por vez, até 3) "Me diga o nome de uma página ou loja que anuncia esse produto (procure 'anúncios' no Instagram ou na Biblioteca de Anúncios do Facebook)", `free: true`. `fonte: "aluno"`.
|
|
24
|
+
|
|
25
|
+
Em todas as fontes: descarte página com nome de pessoa, curso, mentoria ou "ofertas" genéricas, e página que não vende o produto.
|
|
26
|
+
⛔ **Nunca complete com nome inventado.** Passou pelas 4 fontes e ainda tem menos de 3: grave `em_andamento` dizendo quantos faltam.
|
|
27
|
+
Nome de página ou loja é empresa e pode ir na prova. Nome de pessoa, telefone, e-mail: nunca.
|
|
28
|
+
|
|
29
|
+
## 4. Gravar
|
|
30
|
+
1. **Ficha** `Projetos/<pasta>/PROJETO.md` no cofre (onde a sessão está e qual é a pasta: skill `loja`, seções 0 e 2; mescla sem apagar: seção 7). Não existe: crie pelo `skills/loja/templates/PROJETO.md` com o `project_id` e `Tipo` = "Ainda não tenho loja". Preencha `Nicho`, `Oferta` (o produto em 1 frase) e a linha `| Concorrentes | <as 3 páginas> (fonte: <fonte>) |` (acrescente a linha se não existir). O que ficou sem resposta vai em **Em aberto**.
|
|
31
|
+
2. `store_update` com `project_id`, `ficha_path` e `summary` (até 600: nicho · produto · público, se souber · país). É ele que marca sozinha a etapa `ficha`.
|
|
32
|
+
3. `trail_update` `provada` com a prova abaixo.
|
|
33
|
+
|
|
34
|
+
## Prova
|
|
35
|
+
`provada` com `{ "nicho": "...", "produto": "...", "concorrentes": ["Página A", "Página B", "Página C"], "fonte": ["meta"] }` (`fonte` = as que contribuíram, entre `meta`, `chrome`, `apify`, `aluno`).
|
|
36
|
+
Menos de 3 concorrentes, ou produto sem decisão: `em_andamento`.
|
|
37
|
+
|
|
38
|
+
## Responder
|
|
39
|
+
Até 4 linhas: o produto, os 3 concorrentes e de onde vieram, "a ficha do projeto está no seu cofre". Depois "Próxima: <título da próxima etapa, como vem no `trail_status`>" e `ask` "Seguir pra <esse título>?" (Sim / Depois).
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
# Etapa: nome (Nome com domínio e @ livres)
|
|
2
|
+
|
|
3
|
+
Caminho de quem ainda não tem loja. Nome bom é curto, fácil de falar e de escrever, e tem o domínio e o @ do Instagram livres no mesmo dia.
|
|
4
|
+
|
|
5
|
+
Leia a ficha antes (nicho, produto, país). Uma pergunta por mensagem, pela `ask`, com `skip: true`.
|
|
6
|
+
|
|
7
|
+
## 1. O nome
|
|
8
|
+
`ask` "Já tem um nome em mente? Se já tem, é só digitar." com `free: true` e a opção `Me sugere` (o `free` vale pra pergunta inteira: o aluno digita o nome no campo ou clica em Me sugere).
|
|
9
|
+
- **Me sugere:** 5 nomes curtos, fáceis de falar e escrever, sem acento, sem o nome do produto ao pé da letra e sem marca registrada conhecida. `ask` com os 5 + `Nenhum, outra leva` (no máximo 2 levas; depois peça que ele digite).
|
|
10
|
+
O nome vira o `handle`: minúsculo, sem espaço nem acento (ex.: "Casa Lume" → `casalume`).
|
|
11
|
+
⛔ O `handle` só segue se casar com `^[a-z0-9]{3,30}$` (só letras sem acento e números, de 3 a 30). Não casou (ponto, hífen, símbolo, curto ou longo demais): mostre a versão limpa ou peça outro nome. Ele vai dentro de um comando e de um endereço: nada fora disso entra.
|
|
12
|
+
|
|
13
|
+
## 2. Domínio (medido)
|
|
14
|
+
Terminações pelo mercado: BR → `.com.br` e `.com` · CO → `.com.co` e `.com` · outro → `.com`.
|
|
15
|
+
Cada terminação tem o registro oficial dela (medido em 30/10: o atalho `rdap.org` responde 404 pra QUALQUER `.co`, até pra google.com.co, e dá 429 depois de umas 8 consultas):
|
|
16
|
+
|
|
17
|
+
| Terminação | Endereço (troque `<d>` pelo domínio inteiro) |
|
|
18
|
+
|---|---|
|
|
19
|
+
| `.com.br` | `https://rdap.registro.br/domain/<d>` |
|
|
20
|
+
| `.com` | `https://rdap.verisign.com/com/v1/domain/<d>` |
|
|
21
|
+
| `.com.co` e `.co` | `https://rdap.registry.co/co/domain/<d>` (redireciona: o `-L` segue) |
|
|
22
|
+
|
|
23
|
+
```bash
|
|
24
|
+
curl -sL -o /dev/null -w '%{http_code}' "<endereço da tabela>"
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
1. **Controle primeiro**, uma vez por terminação: o mesmo comando com `google<terminação>` tem que dar `200`. Não deu `200`: esse registro não está medindo; essa terminação fica "não consegui medir".
|
|
28
|
+
2. Depois o nome: `404` = livre · `200` = ocupado · `429` = espere 5 segundos e tente uma vez de novo · outro código = "não consegui medir esse".
|
|
29
|
+
3. **Meça as duas terminações do mercado** (BR: `.com.br` E `.com`; CO: `.com.co` E `.com`) antes de dizer "livre". Só diga livre quando as duas foram medidas; uma ocupada = diga qual ("o .com.co está livre, o .com já é de outra empresa") e deixe o aluno escolher, ou proponha outro nome.
|
|
30
|
+
4. Terminação fora da tabela (MX e outras): não tem registro medido; não diga livre nem ocupado. Fica "não consegui medir": o aluno confere no registrador quando for comprar.
|
|
31
|
+
|
|
32
|
+
Sem nenhum domínio livre medido: `ask` "Não consegui conferir o <domínio> daqui. Confira no site onde você vai registrar: ele está livre?" (`Livre` / `Ocupado`), `domain_source: "aluno"`.
|
|
33
|
+
Nunca abra registrador nem a Shopify pra "testar" nome.
|
|
34
|
+
|
|
35
|
+
## 3. @ do Instagram
|
|
36
|
+
Carregue a skill `navegador` e abra `https://www.instagram.com/<handle>/`:
|
|
37
|
+
- a página diz "não está disponível" (ou "Sorry, this page isn't available") → livre, `handle_source: "chrome"`;
|
|
38
|
+
- o perfil carregou → ocupado;
|
|
39
|
+
- pediu login, não deu pra ler, ou não há extensão do Chrome → `ask` "Confira no app do Instagram: o @<handle> está livre?" (`Livre` / `Ocupado`), `handle_source: "aluno"`.
|
|
40
|
+
|
|
41
|
+
## 4. Ocupado
|
|
42
|
+
Domínio ou @ ocupado: volte pra lista ou peça outro nome. No máximo 3 rodadas; depois grave `em_andamento` dizendo o que falta.
|
|
43
|
+
|
|
44
|
+
## 5. Gravar
|
|
45
|
+
- Ficha (skill `loja`, seção 7, mescla sem apagar): `Site` = "<domínio> (a registrar)", `Canais` = "@<handle> (a criar)", e 1 linha no **Histórico**.
|
|
46
|
+
- `trail_update` `provada` com a prova abaixo.
|
|
47
|
+
|
|
48
|
+
## Prova
|
|
49
|
+
`provada` com `{ "name": "...", "domain": "<handle><terminação>", "domain_free": true, "domain_source": "rdap" | "aluno", "handle": "<handle>", "handle_free": true, "handle_source": "chrome" | "aluno" }`.
|
|
50
|
+
Sem domínio livre medido ou sem @ livre: `em_andamento`.
|
|
51
|
+
|
|
52
|
+
## Responder
|
|
53
|
+
Até 4 linhas: o nome, o domínio livre e o @ livre. Depois, em texto normal:
|
|
54
|
+
|
|
55
|
+
AGORA VOCÊ
|
|
56
|
+
1. Registre o domínio <domínio> onde preferir (dá pra comprar pela Shopify depois, quando criar a loja).
|
|
57
|
+
2. Crie o @<handle> no Instagram.
|
|
58
|
+
3. No site, no seletor de projeto → Editar o projeto → troque o nome provisório por "<nome>".
|
|
59
|
+
|
|
60
|
+
E "Próxima: <título da próxima etapa, como vem no `trail_status`>" + `ask` "Seguir pra <esse título>?" (Sim / Depois).
|
|
61
|
+
O @ só fica garantido quando a conta é criada: diga isso em meia linha se ele for deixar pra depois.
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# Etapa: pixel_duplo (
|
|
1
|
+
# Etapa: pixel_duplo (Pixel sem contar em dobro)
|
|
2
2
|
|
|
3
3
|
Venda contada duas vezes faz a campanha parecer melhor do que é e gasta errado. O comum é dois apps mandando a mesma compra (o de pagamento na entrega e o Facebook & Instagram, ou código colado no tema e um app).
|
|
4
4
|
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
Quem chega pelo anúncio está no celular. Página lenta = clique pago que sai antes de ver o produto.
|
|
4
4
|
|
|
5
5
|
## Medir
|
|
6
|
-
A ferramenta `store_speed` com o `project_id` (o site mede a vitrine no celular pelo PageSpeed, com a chave do Google que fica no servidor; leva até 1 minuto). Devolve `{ url, score, top3: [{ id, title, savings_ms }] }
|
|
6
|
+
A ferramenta `store_speed` com o `project_id` (o site mede a vitrine no celular pelo PageSpeed, com a chave do Google que fica no servidor; leva até 1 minuto). O site mede **2 vezes** ao mesmo tempo e vale a maior, porque a nota oscila de uma medida pra outra. Devolve `{ url, score, scores: [a, b], top3: [{ id, title, savings_ms }] }`: `score` é a maior, `scores` traz as que deram certo (uma ou duas) e o `top3` é da medida que valeu.
|
|
7
7
|
Nunca chame o PageSpeed por `curl` daqui: sem a chave, o Google recusa.
|
|
8
8
|
|
|
9
9
|
- Erro "a nota de velocidade ainda não está ligada no site": diga "a nota de velocidade ainda não está ligada no site (falta uma chave do dono do Iron Office)" e grave `em_andamento`.
|
|
@@ -12,9 +12,10 @@ Nunca chame o PageSpeed por `curl` daqui: sem a chave, o Google recusa.
|
|
|
12
12
|
- Nunca invente nota.
|
|
13
13
|
|
|
14
14
|
## Fazer
|
|
15
|
+
- Diga as duas notas e qual valeu (ex.: "nota 56 e 71: vale 71"); veio só uma, diga só ela.
|
|
15
16
|
- Nota ≥ 70: grave a prova.
|
|
16
|
-
- Nota < 70: use o `top3` (já vem ordenado pela economia, em milissegundos) e explique cada uma em 1 linha de aluno (ex.: "imagens grandes demais: dá pra cortar 2 segundos"). Diga o que dá pra você fazer (comprimir imagem pela loja, tirar app que não usa) e o que é dele.
|
|
17
|
+
- Nota < 70: use o `top3` (já vem ordenado pela economia, em milissegundos) e explique cada uma em 1 linha de aluno, em português (os títulos vêm em inglês do Google; ex.: "imagens grandes demais: dá pra cortar 2 segundos"). Diga o que dá pra você fazer (comprimir imagem pela loja, tirar app que não usa) e o que é dele.
|
|
17
18
|
|
|
18
19
|
## Prova
|
|
19
|
-
≥ 70: `provada` com `{ "url": "<url medida>", "score": <nota> }`.
|
|
20
|
+
≥ 70: `provada` com `{ "url": "<url medida>", "score": <nota>, "scores": [<a>, <b>] }`.
|
|
20
21
|
< 70: `em_andamento`.
|