Documentação / Receitas

Receitas

Cada receita tem o pedido pronto pra colar, o que roda por baixo e o que volta. Tudo em linguagem normal — você não precisa citar ferramenta nenhuma.

Não existe uma ferramenta "montar post": o texto é escrito pela IA com os dados que as ferramentas devolvem (título, preço, preço "de", link). Na prática isso é melhor — você pede no seu formato e ele sai do seu jeito. Salve o formato preferido numa instrução do seu app e não precisa repetir.

1 · Post de oferta pronto pro grupo

Peça:

monta o post dessa oferta pro meu grupo: <link>
formato: título em caixa alta, preço agora, preço de antes, % de desconto,
nota e vendidos, link no fim e um aviso de que o preço muda

O que roda: get_product (título, preço, preço "de", nota, imagem) e a conversão do link no mesmo passo.

O que volta:

🔥 AIR FRYER MONDIAL FAMILY 5L

💰 R$ 349,90 no Pix
📉 De R$ 449,90 (-22%)
⭐ 4.8 · +2 mil vendidos

👉 https://s.shopee.com.br/9zQwErTy

⚠️ Preço muda a qualquer hora

Variações que valem: "faz três versões desse post, uma curta pro Stories", "escreve sem emoji", "inclui o cupom XYZ na chamada".

2 · Comparar o mesmo produto entre marketplaces

Peça:

esse produto tá mais barato em qual dos meus marketplaces? <link>
me mostra preço e comissão de cada um e diz onde vale mais a pena

O que roda: get_product no link que você mandou e search_products pelo título nos outros marketplaces configurados.

O que volta: uma tabela com preço, comissão (Shopee e AliExpress informam; Amazon não) e o link de afiliado de cada um — mais a conclusão de qual paga melhor no fim.

Comparação é por título, então confira o modelo antes de postar: "5L" e "5,5L" do mesmo fabricante viram produtos diferentes com preços parecidos. Peça "confirma que é o mesmo modelo" e a IA compara as fichas.

3 · O desconto é real?

Peça:

olha o histórico desse produto e me diz se o preço de agora
é o menor do ano ou é encenação: <link>

O que roda: get_product com history_limit alto (até 50 pontos).

O que volta: o preço de hoje contra os pontos anteriores — quando esteve mais barato, quanto, e se o "de R$ X" bate com algum preço praticado de verdade. É o filtro que evita anunciar falso desconto pro seu grupo.

4 · Caçar oferta por comissão

Peça:

acha produtos de casa e cozinha entre R$ 50 e R$ 200
com comissão acima de 10%, só loja oficial, os mais vendidos

O que roda: search_products com commission_min: 0.10, price_min/price_max, official_only e sort: sales_desc.

O que volta: a lista já filtrada, com imagem, preço, comissão e link seu. Peça "me dá o link de todos" e a conversão sai no mesmo passo.

5 · Fila do dia: um lote de links

Peça:

converte todos esses links e me devolve um por linha, na mesma ordem:
<cole a lista, até 150>

O que roda: convert_links com urls — um item por link, em paralelo.

O que volta: a lista convertida. Link que não bateu com nenhuma rota volta marcado com o motivo, sem derrubar o resto — peça "lista à parte os que falharam".

Serve também pra reaproveitar post antigo: cole o texto inteiro e peça "troca os links desse post pelos meus".

6 · Curadoria por público e faixa de preço

Peça:

monta 5 sugestões de presente de dia das mães até R$ 150,
variando as categorias, com imagem, preço e o link de afiliado —
e escreve uma linha de porque cada um vale a pena

O que roda: várias search_products (uma por categoria) e a conversão de cada escolhido.

O que volta: a seleção pronta pra virar carrossel, lista de Stories ou post de blog.

7 · Quando a IA não usa as ferramentas

Nas primeiras conversas, cite o servidor: "usa o MCP do Afiliado pra converter". Se ela responder com uma URL crua ou disser que não consegue gerar link, quase sempre é isso — ou o conector está desligado naquela conversa (ver Conectar).

Para conferir a ligação a qualquer momento: "quais marketplaces eu tenho configurados?".