Buscar produtos nos marketplaces
search_productsRead-only
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.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Página de resultados (padrão 1) — use para ver mais itens. | |
| site | No | Marketplace a consultar. Se omitido, busca em Shopee/AliExpress/Amazon (com conversor ativo — veja get_bot_info) e junta os resultados (cada item traz "site"). "kabum" e "magalu" são opt-in: só buscam quando informados explicitamente (link de afiliado gerado via conversor ativo do bot). | |
| sort | No | Ordenação: relevance (padrão), price_asc (mais barato), price_desc (mais caro), commission_desc (maior comissão de afiliado), sales_desc (mais vendidos), rating_desc (melhor avaliados), discount_desc (maior desconto). | |
| limit | No | Máximo de resultados (1 a 50; padrão 20). | |
| query | Yes | Palavra-chave / título a buscar. | |
| price_max | No | Preço máximo (na moeda do site, geralmente BRL). | |
| price_min | No | Preço mínimo (na moeda do site, geralmente BRL). | |
| site_filters | No | Filtros ESPECÍFICOS do marketplace (use só com "site" fixado). Shopee: { isKeySeller: bool }. AliExpress: { category_ids: "100,200", ship_to_country: "BR", delivery_days: "7" }. Amazon: { searchIndex: "Computers", condition: "New", brand: "Sony", deliveryFlags: ["Prime"], minReviewsRating: 4, minSavingPercent: 20 }. | |
| official_only | No | Se true, retorna só lojas oficiais (Shopee Mall / AliExpress TMALL). Onde o site não informa, o item é mantido. | |
| commission_min | No | Comissão mínima, em fração (0.05 = 5%). Filtra produtos que pagam pelo menos essa comissão de afiliado. Shopee e AliExpress retornam comissão; Amazon não. | |
| key_seller_only | No | Se true, filtra apenas "key sellers" da Shopee — vendedores de alto desempenho selecionados pela própria plataforma. Eles têm menos probabilidade de estar em férias ou com estoque inativo. Use quando a busca retornar muitos produtos de vendedores indisponíveis. Shopee: filtro nativo (isKeySeller). Outros sites: ignorado. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | ||
| count | No | ||
| items | No | Produtos: title, price (número), currency, image_url, affiliate_url, site. | |
| success | No | ||
| sites_failed | No |