Documentação / Ferramentas (tools)
Ferramentas (tools)
São quatro ferramentas. Você não precisa decorar nada: a IA escolhe sozinha pelo pedido — a referência aqui é para quando você quiser ser específico ou automatizar.
convert_links
Converte um link, ou até 150 de uma vez, em link de afiliado seu.
| Parâmetro | Tipo | Observação |
|---|---|---|
url | string | um link (URL completa, com https://) |
urls | array | vários links; acima de 150 o excedente é descartado |
Devolve por item: affiliate_url, final_url (o que você posta — já com encurtador, se você usa), site, provider e tracking_id. Item que não bate com nenhuma rota volta com ok:false e o motivo, sem derrubar os outros.
"converte esses 12 links pra afiliado" · "afilia e me devolve só a lista de links"
get_product
Detalhe de um produto a partir da URL: título, preço, preço "de", moeda, imagem, estoque, loja, comissão (onde o marketplace informa) — mais o link de afiliado e o histórico de preços.
| Parâmetro | Tipo | Observação |
|---|---|---|
url | string | obrigatório |
history_limit | int | 1 a 50 pontos de histórico (padrão 10) |
"esse preço tá bom mesmo? vê o histórico" · "me dá título, preço e imagem desse produto"
search_products
Busca por palavra-chave nas APIs dos marketplaces que você configurou.
| Parâmetro | Tipo | Observação |
|---|---|---|
query | string | obrigatório |
site | string | shopee, aliexpress, amazon, kabum, magalu. Sem informar, busca nos três primeiros que estiverem ativos e junta. Kabum e Magalu só entram quando pedidos pelo nome |
limit | int | 1 a 50 (padrão 20) |
page | int | 1 a 100 — se count vier igual ao limit, provavelmente há mais |
price_min / price_max | número | faixa de preço |
commission_min | número | fração: 0.05 = 5%. Shopee e AliExpress informam comissão; Amazon não |
official_only | bool | só Shopee Mall / AliExpress TMALL |
key_seller_only | bool | só key sellers da Shopee (menos vendedor de férias e estoque morto) |
sort | string | relevance, price_asc, price_desc, commission_desc, sales_desc, rating_desc, discount_desc |
Marketplace que falhar na busca multi-site aparece em sites_failed — não significa que o produto não existe lá.
"acha air fryer entre 200 e 400, comissão acima de 8%, mais vendidos"
get_bot_info
Sem parâmetros. Diz quais marketplaces você tem ativos para busca, quantos domínios convertem e por qual provedor. É o que a IA consulta sozinha quando uma conversão falha — e o que você deve pedir para conferir se a conexão está certa.
"quais marketplaces eu tenho configurados?"