Como usar o Firecrawl pela API da Clickmax
A API da Clickmax faz chamadas ao Firecrawl para buscar na web e ler páginas, com a mesma chave de API da Clickmax que você já usa nas outras chamadas. Você não precisa ter conta no Firecrawl: sem chave própria conectada, a Clickmax faz a chamada pela conta dela. Se preferir usar a sua conta Firecrawl, conecte a chave dela ao workspace, e as chamadas passam a gastar os créditos da sua conta Firecrawl.
Antes de começar, você precisa de:
- uma chave de API do workspace da Clickmax (veja Autenticação na API da Clickmax);
- só para usar a sua conta Firecrawl: uma chave de API do Firecrawl (
fc-...), criada no painel do Firecrawl, e permissão para gerenciar integrações no workspace.
A conexão com o Firecrawl existe só pela API. Ela não aparece na tela de Integrações.
Os exemplos usam o SDK TypeScript. Pela API HTTP, os caminhos são os mesmos, sob /api/v0/firecrawl/.
Usar a sua conta Firecrawl (opcional)
A Clickmax confere a chave com o Firecrawl antes de guardar, sem gastar créditos. Uma chave recusada não é guardada. Conectar de novo troca a chave anterior. Cada workspace tem uma chave Firecrawl.
clickmax.firecrawl.status()mostra se há uma chave conectada. O campobillingdiz qual conta as chamadas usam:own_key(a sua conta Firecrawl) ouclickmax_credits(a conta da Clickmax).clickmax.firecrawl.disconnect()remove a chave. As chamadas seguintes voltam a usar a conta da Clickmax.
Buscar na web
A consulta aceita operadores como site:, -site: e frases entre aspas. Sem scrapeOptions, cada resultado traz só url, title e description. Para receber também o conteúdo de cada página, envie scrapeOptions: { formats: ['markdown'], onlyMainContent: true }. Isso deixa a busca mais lenta e mais cara.
Ler uma página
formatsaceitamarkdownelinks. O padrão é["markdown"].onlyMainContent: falsemantém cabeçalho e rodapé, onde costumam ficar telefone e WhatsApp.- Uma página que respondeu com erro ainda volta com sucesso. Confira
data.metadata.statusCode: 400 ou mais indica página de erro. maxAge,storeInCache,blockAds,removeBase64Imageselocation(country,languages) seguem o comportamento do Firecrawl.
Consultar o saldo da sua conta Firecrawl
A consulta não gasta créditos e serve também para conferir se a chave conectada ainda funciona. Ela só funciona com a sua chave conectada: sem ela, volta o erro firecrawl_not_connected, e as buscas e leituras continuam funcionando pela conta da Clickmax.
Tempo limite
timeout vai de 1000 a 60000 milissegundos, e o padrão é 30000. O Firecrawl para de tentar ao atingir esse tempo. Mantenha o timeout do cliente da Clickmax (padrão de 60000) acima do timeout da chamada, para receber a resposta do Firecrawl em vez de um erro de tempo do SDK.
Erros do Firecrawl
Leia o code do erro para decidir o que fazer.
A Clickmax não repete chamadas ao Firecrawl por conta própria. Os limites de chamadas da API da Clickmax continuam valendo.