Guia
Como transformar qualquer site em uma API de alterações
A maioria das páginas que você acompanha nunca terá uma API. Preços de concorrentes, PDFs de Termos de Serviço de fornecedores, índices regulatórios, changelogs de parceiros: os dados estão disponíveis diretamente no HTML, sem nenhum endpoint para chamar. Você tem três opções viáveis: criar um scraper e lidar com as quebras frequentes; pagar uma API de scraping para extrair a página inteira sob demanda; ou transformar a página em um feed de alterações: um monitor que a acompanha e envia JSON apenas quando algo realmente relevante muda. Este artigo mostra esse terceiro caminho, do início ao fim, com o Page Deltas.
Plano gratuito · 10 URLs ou sitemaps monitorados · verificações ilimitadas (melhor esforço) · filtragem e resumos com IA · API REST, MCP e webhooks assinados em todos os planos · sem necessidade de cartão de crédito
{
"event": "sitemap.new_urls",
"monitor": "https://www.hubspot.com/sitemap.xml",
"detected_at": "2026-06-15T19:30:00Z",
"new_urls": [
"https://www.hubspot.com/case-studies/workleap",
"https://www.hubspot.com/products/artificial-intelligence/use-cases/sales-meeting-prep-and-follow-up",
"https://www.hubspot.com/email-signature-generator/create-rules-gmail"
]
}Scraper próprio vs API de scraping vs feed de alterações
Regra prática e transparente: se você precisa de milhares de páginas como conjunto de dados, use uma API de scraping. Se você precisa saber quando uma página pública mudou de acordo com um critério específico, um feed de alterações exige menos código e muito menos manutenção.
Scraper próprio
O que você recebe: HTML bruto que você mesmo analisa. Ideal para controle total em sites complexos. O esforço é alto (seletores, proxies, renderização, novas tentativas). Quando o site muda de layout, seu analisador quebra silenciosamente. Atualização depende do seu agendamento (cron). Custo típico: infraestrutura mais seu tempo.
API de scraping
O que você recebe: extração estruturada por requisição. Ideal para extração em massa de muitas páginas. O esforço é baixo a médio. O fornecedor absorve a maioria das quebras de layout. Atualização apenas quando você faz a chamada. Custo típico: créditos por requisição.
Feed de alterações (este guia)
O que você recebe: um evento JSON quando algo relevante muda, acompanhado de um resumo com IA. Ideal para "avise meu sistema quando esta página mudar". O esforço é baixo: crie um monitor e use webhooks ou polling. A extração de conteúdo combinada com o briefing do LLM define o que realmente importa. Verificações adaptativas e envio ao seu endpoint quando houver correspondência. Cobrança por URL monitorada no seu plano (as verificações não são limitadas no Page Deltas).
O que você vai construir
URL base: https://api.pagedeltas.com. Todos os endpoints ficam em /api. Respostas bem-sucedidas retornam JSON.
Conta e chave de API
Crie uma organização gratuita no Page Deltas e gere uma chave de API.
Monitor com briefing
Crie um monitor em uma URL pública com um briefing em linguagem natural (o filtro).
Polling ou webhook
Consulte GET /api/monitors/{id}/changes periodicamente ou conecte um canal de webhook genérico para que cada correspondência envie JSON assinado via POST para sua aplicação.
MCP opcional
Conecte a mesma chave ao Claude, Cursor ou VS Code via MCP.
Configuração: transforme uma página em um feed de alterações
Cinco etapas da chave de API ao webhook assinado. Dê preferência a webhooks quando quiser notificações ativas (push) em vez de consultas contínuas (pull).
Criar uma conta e uma chave de API
Cadastre-se em pagedeltas.com/register. Sem necessidade de cartão de crédito. Plano gratuito: 10 URLs ou sitemaps monitorados, verificações ilimitadas (frequência de melhor esforço), filtragem e resumos com IA, colegas de equipe ilimitados, Slack / Discord / Teams / e-mail / webhooks assinados, histórico de 14 dias, API REST e MCP. No aplicativo: Configurações → Chaves de API (editor ou admin). Crie uma chave e copie-a imediatamente; ela é exibida apenas uma vez. export PAGEDELTAS_TOKEN="pdt_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx". As chaves têm escopo de organização e permissões de nível de administrador dentro dela. Elas não estão vinculadas a um membro individual, portanto a remoção de um colega não revoga a chave. Exclua a chave para revogar o acesso. Guarde-a como uma senha: em variáveis de ambiente ou gerenciadores de segredos, nunca em arquivos de configuração commitados no repositório.
Criar um monitor (cURL)
POST https://api.pagedeltas.com/api/monitors com Authorization: Bearer $PAGEDELTAS_TOKEN e corpo JSON: url, nl_description (o briefing), filter_prompt opcional e channel_ids: []. Exemplo de briefing: "Página de preços de concorrente. Alertar quando o preço de qualquer plano mudar, um plano for adicionado ou removido, ou cotas e limites forem alterados. Ignorar banners de cookies, layouts de teste A/B e depoimentos rotativos." Não há campo de frequência. A cadência é adaptativa (páginas ativas são verificadas com mais frequência, páginas estáveis com menos; planos pagos têm prioridade). Use POST /api/monitors/{id}/check-now para uma verificação sob demanda (com limite de taxa de 1/minuto/monitor). nl_description é o briefing usado pelo LLM para avaliar a relevância da alteração. Briefings vagos transformam seu webhook em um fluxo excessivo de diferenças visuais. Parâmetros opcionais: filter_prompt, css_selector, xpath_selector, is_pdf e channel_ids (substituições de canais por monitor; omita para usar os padrões da organização). Apenas páginas públicas. Páginas protegidas por login ainda não são suportadas. Monitores de sitemap são um recurso separado (/api/sitemap-monitors) quando o objetivo é identificar se novas URLs surgiram, em vez de reescritas em uma página específica.
Consultar o feed de alterações (polling)
GET https://api.pagedeltas.com/api/monitors/{id}/changes?limit=50 com o token Bearer. As alterações mais recentes aparecem primeiro (padrão 50, máximo 100). Não há cursor. Acompanhe o último detected_at já processado por você. Cada alteração inclui id, detected_at e summary: uma descrição em linguagem natural gerada por IA sobre o que correspondeu ao briefing, sem diffs brutos de HTML. Encaminhe summary para o Slack, crie um chamado ou envie para outro agente.
Mesma criação e consulta em Python
Use a biblioteca requests com Authorization Bearer e Content-Type application/json. Faça POST em /api/monitors com url, nl_description e channel_ids: []. Obtenha monitor["id"] da resposta. Em seguida, chame GET /api/monitors/{monitor_id}/changes com limit=50 e exiba detected_at e summary de cada alteração. Execute isso periodicamente se precisar fazer polling. Prefira um webhook quando desejar recebimento ativo (push).
Evite polling, receba JSON via push (webhooks assinados por HMAC)
No aplicativo: Canais → Adicionar canal → Webhook genérico. Cole a URL HTTPS do seu receptor. Copie o segredo do canal assim que ele for exibido (apenas uma vez). Clique em Enviar teste. Você também pode criar o canal via API (POST /api/alert-channels) e vinculá-lo com PUT /api/monitors/{id}/alert-channels, ou deixar channel_ids vazio para usar as configurações padrão da organização. Cada alteração correspondente envia um POST com JSON plano para sua URL, com Content-Type application/json e cabeçalho X-Signature: sha256=<hex>. Os campos incluem event (change.detected), monitor_id, monitor_url, monitor_name, change_id, detected_at, summary, before_screenshot_url, after_screenshot_url e dashboard_url. Valide o X-Signature calculando o HMAC-SHA256 do corpo bruto da requisição com o segredo do canal (formato do cabeçalho: sha256=<hex>). Calcule o hash nos bytes exatos antes de fazer o parse do JSON para evitar falhas na verificação. Novos campos podem surgir com o tempo: ignore chaves desconhecidas. Detalhes de entrega: atualmente há apenas uma tentativa por canal por alerta (sem novas tentativas automáticas); responda rapidamente e trate duplicidades defensivamente. Respostas diferentes de 2xx ou falhas de rede marcam a entrega como malsucedida, mas o monitor não é pausado por falhas no webhook. Todas as tentativas são registradas no servidor. Para alertar pessoas em vez de sistemas, utilize canais do Slack, Discord, Teams ou e-mail da mesma forma. O passo a passo para o Slack está em Como receber alertas de alterações de sites no Slack.
Opcional: controle monitores pelo Claude, Cursor ou VS Code (MCP)
Mesma chave de API. Endpoint HTTP com suporte a streaming MCP: https://api.pagedeltas.com/mcp. Agentes recebem ferramentas como create_monitor, list_monitor_changes, create_alert_channel e utilitários para sitemaps. Sessões baseadas em cookies não são aceitas no MCP. Prefira canais de webhook para sistemas orientados a eventos que não devem fazer polling.
Cursor mcp.json
No arquivo ~/.cursor/mcp.json, configure mcpServers.pagedeltas.url como https://api.pagedeltas.com/mcp e headers.Authorization como Bearer pdt_xxxxxxxx. Reinicie o Cursor para carregar as ferramentas.
Snippets completos de clientes
Exemplos para Claude Code, VS Code e Claude Desktop via mcp-remote estão na documentação do MCP.
Documentação do MCP →Seu briefing é a linguagem de consulta
Em uma API REST tradicional, os filtros são definidos por parâmetros de consulta. Em um feed de alterações, o filtro é o briefing em linguagem natural do monitor. O Page Deltas extrai a página, compara com a última verificação e pergunta a um LLM se a diferença corresponde ao seu briefing. Alertas confirmados chegam com resumo em texto e capturas de tela de antes e depois. Redija o briefing exatamente como orientaria um colega de equipe.
Preços
O preço de um plano mudou ou uma nova opção de plano apareceu.
Licitações e concorrências
Um novo edital foi publicado dentro do nosso escopo de atuação.
Documentação de API
A documentação da API adicionou, removeu ou descontinuou um endpoint.
Contratação
Uma vaga sênior de engenharia foi aberta; ignore vagas que não sejam de engenharia.
Guia geral de monitoramento
A mesma metodologia explicada em nosso guia geral de monitoramento e no guia de filtros e descrições.
Como monitorar alterações em sites →Guia de filtros
Exemplos do que funciona e do que evitar ao redigir o briefing.
Filtros e descrições →Cotas que realmente importam (e as que não importam)
No Page Deltas, o limite de planejamento é a quantidade de URLs (ou sitemaps) acompanhadas, não uma franquia mensal de verificações. Endpoints de leitura e escrita da API não têm cobranças por requisição além do uso responsável. A única exceção é o check-now: 1 requisição / minuto / monitor (retornando 429 com cabeçalho Retry-After ao atingir o limite). Exceder o limite de URLs do plano retorna 422 com a contagem atual e o limite permitido. Ferramentas tradicionais com cobrança por verificação obrigam a fazer cálculos complicados ("uma verificação por hora em uma página ≈ 720 verificações/mês"). Aqui você escolhe as páginas e define o briefing. A frequência se adapta.
Free
10 URLs monitoradas · histórico de 14 dias · verificações ilimitadas (melhor esforço), IA, API, MCP, todos os 5 canais de alerta · US$ 0
Starter
150 URLs monitoradas · histórico de 30 dias · US$ 29/mês · verificações prioritárias
Pro
1.000 URLs monitoradas · histórico de 90 dias · US$ 79/mês
Business
5.000 URLs monitoradas · histórico de 365 dias · US$ 199/mês
Scale
20.000 URLs monitoradas · histórico de 730 dias · US$ 499/mês
Enterprise
URLs e histórico personalizados · SSO / SCIM
Diferenças em relação a uma API no estilo do Visualping
Os conteúdos para desenvolvedores do Visualping baseiam-se em intervalos fixos, delimitação opcional por CSS/XPath, limites mensais de verificações e payloads extensos com foco em diffs de pixels e níveis de importância. Essa abordagem funciona quando o objetivo é "dispare se pixels mudarem e deixe meu código analisar". O Page Deltas foi criado para "notifique meu sistema apenas quando a alteração corresponder a este briefing". Este artigo é o guia de integração técnica; o comparativo detalhado plano a plano está em Page Deltas vs Visualping.
Briefing em linguagem natural em primeiro lugar
O briefing é o filtro principal. Seletores são opcionais, não obrigatórios.
Frequência adaptativa
Sem precisar configurar intervalos manuais. Páginas dinâmicas são verificadas com mais frequência; páginas estáveis, com menos.
Payload de webhook direto e enxuto
Focado em summary, URLs de capturas de tela e cabeçalho HMAC X-Signature.
Verificações ilimitadas; pague pelo número de URLs
Todos os planos contam com verificações ilimitadas. Você paga pela quantidade de URLs acompanhadas.
MCP com as mesmas credenciais
O MCP utiliza as mesmas chaves de API da interface REST.
Comparativo completo de produtos
Comparação detalhada plano a plano entre o Page Deltas e o Visualping.
Page Deltas vs Visualping →Limitações transparentes
Entenda com clareza o que este feed de alterações é e o que não é antes de integrar sistemas de produção.
Apenas páginas públicas
Sites institucionais, PDFs públicos, páginas públicas de vagas, sitemaps abertos. Portais com autenticação estão em nosso planejamento, mas não disponíveis hoje.
Não é uma ferramenta de regressão visual ou integridade de layout
Se a demanda for identificar "este pixel se moveu 20px", ferramentas especializadas em diferenças visuais ainda são a escolha certa.
Sem suporte para atividade no LinkedIn ou X
O Page Deltas acompanha a web pública aberta. O acompanhamento de perfis no LinkedIn ou X deve ser feito pelo MultiFollow. O monitoramento de termos no LinkedIn, X, Reddit e outras redes é atendido pelo KWatch.
Entrega de webhooks em tentativa única atualmente
Desenvolva endpoints receptores idempotentes.
Não invente nomes de campos de resposta
Consulte as estruturas na documentação da API em tempo real e desconsidere chaves JSON desconhecidas.
Referência da API →Guias e documentações relacionadas
Configurações para equipes no Slack, início rápido sem código e especificações completas da API.
Alertas de alterações no Slack
Conecte o mesmo monitor a um webhook de entrada do Slack para notificar equipes em vez de sistemas.
Como receber alertas de alterações de sites no Slack →Início rápido
Fluxo sem código: informe uma URL, redija o briefing, escolha um canal e clique em Enviar teste.
Início rápido →Referência da API
Estruturas ativas de requisição e resposta. Copie os campos daqui e desconsidere chaves JSON desconhecidas.
Referência da API →Documentação do MCP
Exemplos prontos para Claude Code, Cursor, VS Code e Claude Desktop.
Documentação do MCP →Perguntas frequentes
- Como obtenho dados de um site que não possui API?
- Existem três alternativas: programar um scraper próprio, utilizar uma API de scraping para extração em lote, ou apontar uma API de monitoramento de alterações para a página e consumir o feed JSON gerado. Para o cenário "notifique meu sistema quando esta página mudar", o feed de alterações normalmente exige menos código: basta criar o monitor e usar webhooks ou polling.
- Consigo configurar isso sem escrever código?
- Sim. Crie o monitor no painel, configure um webhook genérico (ou Slack / Teams / Discord / e-mail) em Canais, escreva o briefing e clique em Enviar teste. O guia de início rápido apresenta o caminho sem código.
- Qual é a diferença entre uma API de scraping e uma API de monitoramento de alterações?
- Uma API de scraping extrai todo o conteúdo da página a cada chamada. Uma API de monitoramento acompanha a página continuamente e envia somente as mudanças ocorridas, já com o resumo de IA gerado. Problemas de extração demandam scrapers. A necessidade "algo correspondente ao meu briefing mudou?" pede um feed de alterações.
- O acesso à API ou a webhooks tem custo adicional?
- Não. A API REST, o MCP e os webhooks com assinatura estão inclusos em todos os planos, inclusive no Free. O uso é balizado apenas pelo limite de URLs monitoradas do plano, sem contadores adicionais de créditos de API.
- Agentes de IA podem criar monitores para mim?
- Sim. Basta apontar um cliente MCP para https://api.pagedeltas.com/mcp informando uma chave de API Bearer. Veja a documentação do MCP.
Autor
Julien, Gerente de Produto no Page Deltas. Escolha uma URL pública que você costuma atualizar manualmente. Crie uma conta gratuita, gere uma chave de API, configure o monitor com um briefing de uma frase, adicione um webhook genérico, valide a assinatura HMAC uma vez e aguarde a primeira alteração real. Ajuste as regras de exclusão após os primeiros alertas ruidosos. Na maioria dos casos, isso é tudo o que uma API de alterações exige.
Comece com uma página como feed de alterações
Plano gratuito, sem cartão de crédito. Crie sua conta, gere uma chave de API, informe a URL que você já acompanha, adicione um briefing com base no guia de filtros e faça consultas em /changes ou receba JSON assinado via POST no seu próprio endpoint.