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.

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 preço de agora e o que já foi registrado

Peça:

me dá o preço de agora desse produto e o histórico,
se tiver: <link>

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

O que volta: o preço de hoje, o preço "de" que o marketplace mostra e os preços que este servidor já registrou para o produto. O histórico começa vazio e cresce a cada consulta: produto que ninguém consultou por aqui volta só com o preço de agora. Antes de anunciar desconto pro seu grupo, confira se o "de R$ X" bate com o que ficou registrado.

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?".