MCP do Afiliado MCP Server

Mostra o que ESTE bot suporta: marketplaces com busca ativa (search_sites, usados por search_products), catálogos públicos (Kabum/Magalu, com flag de monetização), redes/domínios com conversão de link ativa (convertible_routes, agrupados por provider com amostra de domínios) e módulos (ex.: cupons). Use quando uma busca/conversão falhar por site não suportado, ou quando o usuário perguntar o que o bot consegue fazer. Para saber se um domínio específico converte, basta chamar convert_links com ele.

Converte um ou vários links (URLs de produtos/lojas) em links de afiliado do seu bot. OBRIGATÓRIO informar "url" (um único link) ou "urls" (vários, até 150 por chamada). Link sem https:// e pontuação colada ao copiar de um texto são corrigidos; o que não for URL volta em "invalid_urls" e o resto do lote converte normalmente. Retorna JSON com affiliate_url e final_url por item (final_url é o link a publicar).

Dados de um produto a partir da URL: título, preço, moeda, imagem, o link de afiliado (affiliate_url), o link final (final_url) e o histórico de preços. Quando a loja informa, vêm também estoque (availability), preço "de" (original_price), descrição, URL canônica, loja (shop_name), faixa de preço (price_min/price_max) e comissão (commission_rate). No AliExpress vem também moedas_url, o link da promoção de moedas do mesmo produto. Kabum e Magalu têm catálogo público: sem credencial cadastrada, devolvem os dados com affiliate_url e final_url null e monetized:false. Fontes: Shopee Affiliate Open API (affiliate.shopee.com.br/open_api), AliExpress Affiliate API (openservice.aliexpress.com), o catálogo público da Kabum e da Magalu e, nas outras lojas, a página pública do produto; o histórico vem do banco deste serviço. Amazon: só o link de afiliado (com a Partner Tag); busca e dados de produto da Amazon ainda não estão disponíveis neste serviço.

Busca produtos por palavra-chave nas APIs dos marketplaces do bot (Shopee, AliExpress, Amazon; Kabum e Magalu quando informados em "site"). Filtre por faixa de preço (price_min/price_max) e ordene (sort: price_asc = mais barato primeiro). Cada item traz image_url, a URL da foto do produto, e price como número na moeda de "currency" (ex.: 274.99). Paginação: a resposta traz "count" e "page"; com count igual a limit, normalmente há mais resultados na página seguinte (com filtros ativos, count menor que limit não garante o fim do catálogo). Na busca multi-site, os marketplaces que falharam aparecem em "sites_failed"; a falha não quer dizer que o produto não exista neles.