/monitor para acompanhar páginas conhecidas, rastrear um site em um agendamento ou executar uma busca contínua na web por novos resultados que correspondam a uma meta.
Todos os tipos de monitor compartilham o mesmo fluxo de trabalho: escolha um ou mais alvos, defina um agendamento, adicione uma meta opcional em linguagem simples e receba notificações por webhook, email ou Slack quando algo importante acontecer. Esta página aborda a configuração compartilhada. Para configurações e exemplos específicos de alvo, acesse a página de monitoramento de Página, Site ou Toda a web em escala.
Monitoramento de páginas
Acompanhe uma ou mais URLs conhecidas, compare cada scraping com o último snapshot e gere alertas para mudanças significativas na página.
Monitoramento de sites
Faça o rastreamento de um site em um agendamento, detecte páginas adicionadas, alteradas ou removidas e notifique seu webhook ou caixa de entrada.
Monitoramento de toda a web em escala
Execute buscas na web recorrentes e gere alertas quando um novo resultado aparecer e corresponder à sua meta.
same, new, changed, removed ou error. Você pode receber um webhook quando cada página monitorada for concluída, um webhook para cada verificação concluída, resumos por email quando houver mudanças ou erros, notificações do Slack em um canal, ou qualquer combinação dessas notificações.
Encerrado: recompensa por feedback sobre /monitor
Todos os participantes elegíveis à recompensa já foram contatados. Fique de olho nas próximas recompensas em nossa documentação!
Alvos
| Alvo | O que monitora | Configuração |
|---|---|---|
scrape | URLs conhecidas que você informa | Monitoramento de páginas |
crawl | Cada página descoberta por um rastreamento | Monitoramento de sites |
search | Novos resultados em toda a web | Monitoramento de toda a web em escala |
retentionDays tem valor padrão de 30 e pode ser definido em até 365.
Cada chamada de criação retorna o novo monitor com o cron normalizado, nextRunAt calculado e estimatedCreditsPerMonth. Quando a avaliação está habilitada, estimatedCreditsPerMonth é uma estimativa de limite superior, porque os créditos de avaliação só são cobrados para páginas alteradas que de fato são avaliadas:
Response
Objetivos e avaliação
goal em linguagem simples quando quiser receber alertas apenas sobre mudanças significativas. Se goal estiver presente e judgeEnabled for omitido, o Firecrawl ativa a avaliação automaticamente. A avaliação é executada nas páginas alteradas e retorna um judgment com meaningful, confidence, reason e meaningfulChanges.
Como a meta é aplicada depende do alvo: monitores de página e site avaliam páginas alteradas, enquanto monitores de toda a web em escala avaliam cada novo resultado de busca.
Use judgeEnabled: false se quiser armazenar uma meta sem avaliar as mudanças ainda. O avaliador só é executado quando o monitor tem judgeEnabled e um goal não vazio.
Um
goal é obrigatório para alvos search (monitoramento de toda a web em escala), a menos que você defina judgeEnabled: false. Ele é opcional para alvos scrape e crawl.Cada verificação sempre cobra pelos scrapings ou rastreamentos subjacentes. Se a avaliação estiver habilitada, o avaliador adiciona 1 crédito para cada página alterada que ele valida. Verificações sem páginas alteradas não usam créditos do avaliador.
monitor.page como este quando uma história correspondente entrar no escopo:
monitor.page
Agendamentos
every 30 minutesevery 15 minutes starting at :07hourlyevery 2 hoursdailydaily at 9:00daily at 9amdaily at 5:30 PMweekly
timezone determina quando expressões como daily at 9am são executadas. Os agendamentos em texto são distribuídos com base no ID do monitor antes de serem convertidos para cron, para que vários monitores não sejam executados todos no mesmo instante.
Rastreamento de mudanças
same, changed, new, removed ou error. Quando quiser detectar mudanças em campos estruturados específicos (preço, manchete, indicador de disponibilidade em estoque, itens de uma lista etc.), habilite o rastreamento de mudanças no modo JSON adicionando um formato changeTracking com modes: ["json"] às scrapeOptions do alvo.
O rastreamento de mudanças se aplica a alvos
scrape e crawl. Monitores de toda a web em escala completos (search) emitem alertas sobre novos resultados em vez de comparar páginas conhecidas. Veja Statuses and dedup.Modo Markdown (padrão)
scrapeOptions.formats é apenas ["markdown"], cada página alterada na resposta da verificação inclui um diff de texto unificado e uma AST no estilo parseDiff:
Markdown-mode diff
Modo JSON
changeTracking com modes: ["json"] junto com um schema JSON (ou um prompt) que descreva os campos que importam para você. O Firecrawl extrai esse JSON em cada verificação e gera um diff por campo identificado pelo caminho do campo, além de um snapshot.json com a extração atual completa, para que os consumidores não precisem buscar novamente o scraping subjacente.
{previous, current}:
JSON-mode diff
Mesmo que nenhum campo rastreado tenha mudado, mas o markdown ao redor tenha sido alterado, os monitores no modo JSON ainda reportam
same, a menos que você também habilite o git-diff (veja o modo misto abaixo). O diff se concentra exclusivamente nos campos do seu schema.Modo misto (JSON + git-diff)
Mixed target (JSON + git-diff)
diff.text (sidecar em markdown) quanto diff.json (diff por campo), junto com a extração snapshot.json:
Mixed-mode diff (JSON + git-diff)
changed sempre que qualquer uma das saídas mudar.
Notificações
Webhooks
webhook, o Firecrawl pode enviar dois eventos do monitor:
monitor.page: Enviado conforme cada scraping monitorado é concluído no worker de scraping.monitor.check.completed: Enviado após a consolidação da verificação completa. Inclui o status da verificação e contagens de resumo. Use os eventosmonitor.pageou a API de verificação do monitor para obter resultados por página.
monitor.page inclui isMeaningful e judgment quando a avaliação de alteração significativa é executada para uma página alterada.
Webhook config
monitor.page:
monitor.page
monitor.check.completed:
monitor.check.completed
success é true quando a verificação é concluída sem erros de página. É false em verificações com falha ou parciais, e error contém o motivo da falha quando disponível.
Email config
recipients for omitido, o Firecrawl enviará para os membros da equipe aptos a receber emails de alerta do sistema.
Você pode configurar até 25 destinatários especificados.
Processo de confirmação do destinatário
Slack
As notificações do Slack são um recurso disponível apenas no painel. Elas só podem ser configuradas pelo painel de monitoramento, não pela API nem pelos SDKs.
- Abra o painel de monitoramento. Você pode adicionar notificações do Slack ao criar um novo monitor ou adicioná-las a um monitor que já existe.
- Durante a criação do monitor ou após selecionar um monitor existente, role até Notificações e selecione Slack.
- Você precisará passar pelo fluxo de OAuth. Conclua o processo e selecione o workspace e o canal em que deseja receber as notificações.
Consultar resultados
GET /v2/monitor/{monitorId}/checks para listar verificações e GET /v2/monitor/{monitorId}/checks/{checkId} para inspecionar uma verificação. Os SDKs fazem paginação automática por padrão.
status da verificação: queued, running, completed, failed, partial ou skipped_overlap.
A resposta de detalhes da verificação inclui estimatedCredits, actualCredits, contagens resumidas e um array pages paginado. estimatedCredits é a reserva no limite máximo para a verificação; actualCredits é o valor final cobrado depois que o Firecrawl determina quantas páginas mudaram e precisaram de avaliação. Use a URL next de nível superior para buscar a próxima página de resultados, seguindo a paginação do rastreamento. Você pode filtrar páginas por status: same, new, changed, removed ou error. Cada página alterada inclui dados de diff inline; páginas de monitores em modo JSON também incluem um snapshot com a extração atual.
- Modo Markdown
- Modo JSON
- Modo misto
Markdown-mode response
Preços
| Componente | Créditos |
|---|---|
| Monitor de scraping | 1 crédito por URL por verificação |
| Monitor de rastreamento | 1 crédito por página descoberta por verificação |
| Monitor web | 2 créditos por 10 resultados por verificação |
| Avaliação do monitor web | 1 crédito por resultado avaliado, quando a avaliação por IA está ativada (cobre o scraping e a avaliação do resultado) |
| Mudança significativa ativada | 1 crédito adicional por página alterada validada pelo avaliador |
| Complementos de formato (JSON, PDF, question, modo aprimorado etc.) | O mesmo que um scrape avulso |

