Guía
Cómo convertir cualquier sitio web en una API de cambios
La mayoría de las páginas que le interesan nunca ofrecerán una API. Precios de competidores, PDF de condiciones de servicio de proveedores, directorios de organismos reguladores, registros de cambios de socios: los datos están ahí en el HTML, pero no hay ningún endpoint al que llamar. Existen tres opciones reales: construir un scraper propio y asumir el mantenimiento constante; pagar una API de scraping para extraer la página entera bajo demanda; o convertir la página en un feed de cambios: un monitor que la vigila por usted y envía JSON únicamente cuando ocurre un cambio relevante. Este artículo explica esa tercera vía de principio a fin con Page Deltas.
Plan gratuito · 10 URL o sitemaps monitorizados · comprobaciones ilimitadas (según disponibilidad / best-effort) · filtrado y resúmenes con IA · API REST, MCP y webhooks firmados en todos los planes · sin tarjeta 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 propio vs. API de scraping vs. feed de cambios
Regla práctica: si necesita miles de páginas para recopilar un conjunto de datos, utilice una API de scraping. Si necesita saber cuándo una página pública ha cambiado según una instrucción concreta, un feed de cambios requiere mucho menos código y mantenimiento.
Scraper propio (DIY)
Lo que obtiene: HTML en bruto que debe procesar usted mismo. Ideal para un control absoluto en sitios web complejos. El esfuerzo es alto (selectores, proxies, renderizado, reintentos). Cuando el sitio rediseña su interfaz, el analizador falla silenciosamente. La frescura depende de la ejecución de sus tareas programadas (cron). Coste típico: infraestructura más su tiempo de desarrollo.
API de scraping
Lo que obtiene: extracción estructurada por petición. Ideal para la extracción masiva de muchas páginas. El esfuerzo es bajo o moderado. El proveedor absorbe la mayor parte de los fallos de maquetación. La frescura depende de cuándo realice la llamada. Coste típico: créditos cobrados por petición.
Feed de cambios (esta guía)
Lo que obtiene: un evento JSON cada vez que ocurre un cambio significativo, acompañado de un resumen generado por IA. Ideal para «avisar a mi sistema cuando esta página cambie». El esfuerzo es mínimo: crear un monitor y luego recibir webhooks o consultar. La extracción de contenido junto con la instrucción evaluada por el LLM determinan qué es importante. Revisiones adaptativas; envío push a su endpoint cuando hay coincidencia. Se tarifica por URL monitorizada en su plan (las revisiones no están limitadas en Page Deltas).
Lo que va a construir
URL base: https://api.pagedeltas.com. Todos los endpoints se encuentran bajo /api. Las respuestas correctas se devuelven en formato JSON.
Cuenta y clave de API
Cree una organización gratuita en Page Deltas y genere una clave de API.
Monitor con instrucción (brief)
Cree un monitor en una URL pública con una instrucción en lenguaje natural (el filtro).
Sondeo (poll) o webhook
Consulte GET /api/monitors/{id}/changes o conecte un canal de webhook genérico para que cada coincidencia envíe un POST en JSON firmado a su aplicación.
MCP opcional
Conecte la misma clave de API a Claude, Cursor o VS Code a través de MCP.
Configuración: convierta una página en un feed de cambios
Cinco pasos desde la clave de API hasta el webhook firmado. Prefiera el webhook cuando desee una entrega push en lugar de consultas periódicas (pull).
Cree una cuenta y una clave de API
Regístrese en pagedeltas.com/register. Sin tarjeta de crédito. Plan gratuito: 10 URL o sitemaps monitorizados, revisiones ilimitadas (frecuencia según disponibilidad / best-effort), filtrado y resúmenes con IA, miembros de equipo ilimitados, canales Slack / Discord / Teams / correo electrónico / webhooks firmados, 14 días de historial, API REST y MCP. En la aplicación: Ajustes → Claves de API (editor o administrador). Cree una clave y cópiela de inmediato; solo se muestra una vez. export PAGEDELTAS_TOKEN="pdt_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx". Las claves pertenecen a la organización y tienen permisos de administrador dentro de ella. No están vinculadas a un usuario individual, por lo que eliminar a un compañero no revoca la clave. Elimine la clave si necesita revocar el acceso. Trátela como una contraseña: variable de entorno o gestor de secretos, nunca en un archivo de configuración versionado.
Cree un monitor (cURL)
POST https://api.pagedeltas.com/api/monitors con el encabezado Authorization: Bearer $PAGEDELTAS_TOKEN y cuerpo JSON: url, nl_description (la instrucción), el campo opcional filter_prompt y channel_ids: []. Ejemplo de instrucción: «Página de precios de la competencia. Notificar cuando cambie el precio de cualquier plan, se añada o elimine un plan, o varíen las cuotas y límites. Ignorar avisos de cookies, pruebas A/B de diseño y testimonios rotativos». No hay campo de frecuencia. La cadencia es adaptativa (páginas activas se revisan con mayor frecuencia, páginas tranquilas con menor frecuencia; los planes de pago tienen prioridad). Utilice POST /api/monitors/{id}/check-now para forzar una comprobación bajo demanda (limitado a 1/minuto/monitor). nl_description es la instrucción que el LLM utiliza para decidir si un cambio importa. Instrucciones ambiguas recrean una avalancha de diffs visuales en su webhook. Campos opcionales: filter_prompt, css_selector, xpath_selector, is_pdf y channel_ids (canales específicos del monitor; omítalos para usar los predeterminados de la organización). Solo web pública; las páginas tras inicio de sesión aún no son compatibles. Los monitores de sitemap son un recurso independiente (/api/sitemap-monitors) cuando el objetivo es «¿ha aparecido una URL totalmente nueva?» en lugar de «¿se ha modificado el contenido de esta página?».
Consulte el feed de cambios (sondeo / polling)
GET https://api.pagedeltas.com/api/monitors/{id}/changes?limit=50 con el token Bearer. Los cambios más recientes se muestran primero (50 por defecto, máximo 100). No hay cursor. Guarde el último valor de detected_at que ya haya procesado. Cada cambio incluye id, detected_at y summary: una descripción en lenguaje claro generada por IA que explica qué coincidió con la instrucción, no un diff en HTML sin procesar. Puede enviar directamente este summary a Slack, a un ticket de soporte o a otro agente.
Misma creación y consulta en Python
Utilice requests con Authorization Bearer y Content-Type application/json. Envíe un POST a /api/monitors con url, nl_description y channel_ids: []. Lea monitor["id"] de la respuesta. Después llame a GET /api/monitors/{monitor_id}/changes con limit=50 e imprima detected_at y summary de cada cambio. Ejecútelo periódicamente si debe recurrir al sondeo. Prefiera un webhook cuando busque una recepción push instantánea.
Evite el sondeo, reciba JSON mediante push (webhooks firmados con HMAC)
En la aplicación: Canales → Añadir canal → Webhook genérico. Pegue la URL HTTPS de su receptor. Copie el secreto del canal cuando se muestre (solo una vez). Haga clic en Enviar prueba. También puede crear el canal vía API (POST /api/alert-channels) y vincularlo con PUT /api/monitors/{id}/alert-channels, o dejar channel_ids vacío para que el monitor use los canales predeterminados de la organización. Cada cambio coincidente envía una petición POST en JSON a su URL con Content-Type application/json y X-Signature: sha256=<hex>. Los campos incluyen event (change.detected), monitor_id, monitor_url, monitor_name, change_id, detected_at, summary, before_screenshot_url, after_screenshot_url y dashboard_url. Verifique X-Signature calculando el HMAC-SHA256 del cuerpo sin procesar de la petición con el secreto de su canal (formato sha256=<hex>). Calcule el hash sobre los bytes exactos antes de parsear el JSON, de lo contrario la comprobación fallará. Pueden añadirse nuevos campos con el tiempo: ignore claves desconocidas. Notas de entrega: actualmente se realiza un único intento por canal y por alerta (sin reintentos automáticos), por lo que debe responder rápidamente y aceptar posibles duplicados de forma defensiva. Las respuestas distintas de 2xx o errores de red marcan la entrega como fallida, pero el monitor continúa funcionando. Cada intento queda registrado en el servidor. Para personas en lugar de código, utilice canales de Slack, Discord, Teams o correo electrónico de la misma manera. El tutorial de integración con Slack está disponible en Cómo recibir alertas de cambios en páginas web en Slack.
Opcional: gestione monitores desde Claude, Cursor o VS Code (MCP)
La misma clave de API. Endpoint HTTP MCP con soporte de streaming: https://api.pagedeltas.com/mcp. Los agentes disponen de herramientas como create_monitor, list_monitor_changes, create_alert_channel y utilidades para sitemaps. Las sesiones basadas en cookies no se admiten en MCP. Utilice canales webhook para sistemas orientados a eventos que no deban realizar consultas periódicas.
Archivo mcp.json en Cursor
En ~/.cursor/mcp.json configure mcpServers.pagedeltas.url con https://api.pagedeltas.com/mcp y headers.Authorization con Bearer pdt_xxxxxxxx. Reinicie Cursor para que aparezcan las herramientas.
Fragmentos completos de configuración
Las configuraciones para Claude Code, VS Code y Claude Desktop mediante mcp-remote se encuentran en la documentación de MCP.
Documentación de MCP →Su instrucción (brief) es su lenguaje de consulta
En una API REST clásica se filtra mediante parámetros de consulta. Con un feed de cambios, el filtro es la instrucción en lenguaje natural configurada en el monitor. Page Deltas extrae la página, la compara con la comprobación anterior y pregunta a un LLM si la variación encaja con su instrucción. Las alertas coincidentes llegan con un resumen redactado y capturas de pantalla de antes y después. Escriba la instrucción tal como se la explicaría a un compañero de equipo.
Precios
El precio de un plan cambia o aparece un nuevo nivel de tarifas.
Licitaciones / RFP
Se publica una nueva licitación dentro de nuestro ámbito de actividad NAICS.
Documentación de API
La documentación de la API añade, elimina o declara obsoleto (deprecates) un endpoint.
Contrataciones
Se publica una vacante de ingeniería sénior; ignorar puestos no técnicos.
Guía general de monitorización
Misma filosofía que nuestra guía general de monitorización y la guía de filtros y descripciones.
Cómo monitorizar cambios en sitios web →Guía de filtros
Ejemplos prácticos de lo que funciona y errores que deben evitarse al redactar la instrucción.
Filtros y descripciones →Límites que realmente importan (y los que no)
En Page Deltas, el límite sobre el que planifica es cuántas URL (o sitemaps) supervisa, no una cuota mensual de comprobaciones. Los endpoints de lectura y escritura de la API no tienen tarifas por clave más allá de un uso razonable. La excepción es check-now: 1 petición / minuto / monitor (devuelve 429 con Retry-After si se sobrepasa). Alcanzar el límite de URL de su plan devuelve un error 422 indicando el uso actual y el límite permitido. Las herramientas tradicionales basadas en comprobaciones le obligan a calcular («una revisión horaria en una página ≈ 720 revisiones/mes»). Aquí usted elige las páginas y redacta la instrucción. La cadencia se adapta sola.
Gratuito
10 URL monitorizadas · 14 días de historial · comprobaciones ilimitadas (según disponibilidad), IA, API, MCP, los cinco canales de alerta · 0 $
Starter
150 URL monitorizadas · 30 días de historial · 29 $/mes · comprobaciones prioritarias
Pro
1.000 URL monitorizadas · 90 días de historial · 79 $/mes
Business
5.000 URL monitorizadas · 365 días de historial · 199 $/mes
Scale
20.000 URL monitorizadas · 730 días de historial · 499 $/mes
Enterprise
Volumen de URL e historial a medida · SSO / SCIM
En qué se diferencia esto de una API de cambios al estilo de Visualping
Las publicaciones para desarrolladores de Visualping se basan en intervalos fijos, selectores CSS/XPath opcionales, una cuota mensual de comprobaciones y una gran cantidad de campos de webhook sobre diffs e indicadores de importancia. Eso funciona cuando el requerimiento es «avisa cuando los píxeles se muevan y deja que mi código decida». Page Deltas está diseñado para «despierta a mi sistema solo cuando el cambio coincida con esta instrucción». Este artículo es la guía técnica de integración; la comparativa detallada entre planes se encuentra en Page Deltas vs. Visualping.
La instrucción en lenguaje natural como base
El filtro primordial es la instrucción redactada. Los selectores son opcionales, no obligatorios.
Cadencia adaptativa
Sin necesidad de definir intervalos fijos. Las páginas activas se revisan con mayor frecuencia; las estables, con menos.
Estructura de webhook simplificada
Centrada en el resumen (summary), las URL de las capturas de pantalla y la firma HMAC X-Signature.
Comprobaciones ilimitadas; pago por número de URL
Todos los planes incluyen revisiones ilimitadas. Solo paga por la cantidad de URL que supervisa.
MCP con las mismas claves de API
El protocolo MCP utiliza exactamente las mismas claves de API que la interfaz REST.
Comparativa completa de producto
Comparación plan por plan entre Page Deltas y Visualping.
Page Deltas vs. Visualping →Límites transparentes del servicio
Conozca con precisión qué ofrece este feed de cambios y qué queda fuera de su alcance antes de conectar clientes en producción.
Solo páginas públicas
Sitios web comerciales, PDF públicos, bolsas de trabajo abiertas y sitemaps públicos. Las páginas que requieren inicio de sesión están en nuestra hoja de ruta, no disponibles actualmente.
No es una herramienta de regresión visual ni de defacement
Si la tarea consiste en detectar si «este píxel se ha movido 20 px», una herramienta de diff visual tradicional sigue siendo la mejor opción.
No monitoriza actividad en LinkedIn ni X
Page Deltas supervisa la web abierta. La actividad individual en LinkedIn o X corresponde a MultiFollow. El seguimiento de menciones de palabras clave en LinkedIn, X, Reddit y otras redes corresponde a KWatch.
Entrega de webhook con un único intento actualmente
Diseñe receptores idempotentes.
No invente nombres de campos en la respuesta
Copie las estructuras de la referencia de API en vivo e ignore claves desconocidas en el JSON.
Referencia de API →Guías y documentación relacionadas
Configuración avanzada para equipos en Slack, la guía rápida sin código y las estructuras de datos reales de la API.
Alertas de cambios en Slack
Conecte el mismo monitor a un webhook entrante de Slack para personas en lugar de código.
Cómo recibir alertas de cambios en páginas web en Slack →Guía rápida
El camino sin código: pegue una URL, escriba la instrucción, elija un canal y envíe una prueba.
Guía rápida →Referencia de API
Estructuras reales de petición y respuesta. Copie los campos desde aquí e ignore claves desconocidas.
Referencia de API →Documentación de MCP
Fragmentos de configuración para Claude Code, Cursor, VS Code y Claude Desktop.
Documentación de MCP →Preguntas frecuentes
- ¿Cómo obtengo datos de un sitio web que no tiene API?
- Tres opciones: construir un scraper, utilizar una API de scraping para extracción masiva, o apuntar una API de monitorización de cambios a la página y consumir el feed de cambios en JSON. Para «notificar a mi sistema cuando esta página cambie», el feed de cambios suele requerir mucho menos código: cree un monitor y luego reciba webhooks o realice sondeos.
- ¿Puedo hacer esto sin escribir código?
- Sí. Cree el monitor en el panel de control, añada un webhook genérico (o Slack / Teams / Discord / correo electrónico) en Canales, redacte la instrucción y haga clic en Enviar prueba. La guía rápida describe todo el proceso sin código.
- ¿Cuál es la diferencia entre una API de scraping y una API de monitorización de cambios?
- Una API de scraping extrae el contenido completo de la página cada vez que se le llama. Una API de monitorización de cambios vigila la página periódicamente y solo emite las modificaciones, con el resumen de IA ya procesado. Los problemas de extracción requieren scrapers; la pregunta «¿ha cambiado algo que coincida con mi instrucción?» requiere un feed de cambios.
- ¿El acceso a la API o a los webhooks tiene un coste adicional?
- No. La API REST, MCP y los webhooks firmados están incluidos en todos los planes, incluido el gratuito. El uso está limitado por su cupo de URL monitorizadas, sin medidores independientes de créditos de API.
- ¿Pueden los agentes de IA crear monitores por mí?
- Sí. Conecte un cliente MCP a https://api.pagedeltas.com/mcp mediante una clave de API Bearer. Consulte la documentación de MCP.
Autor
Julien, Responsable de Producto en Page Deltas. Elija una URL pública que ya actualice manualmente. Cree una cuenta gratuita, genere una clave de API, cree el monitor con una instrucción de una sola frase, conecte un webhook genérico, verifique la firma HMAC una vez y espere a la primera coincidencia real. Ajuste la lista de exclusiones tras la primera alerta con ruido. Por lo general, eso es todo lo que requiere una API de cambios.
Comience convirtiendo una primera página en un feed de cambios
Plan gratuito, sin tarjeta de crédito. Cree una cuenta, genere una clave de API, pegue la URL que ya supervisa manualmente, aplique una instrucción de la guía de filtros y elija entre consultar /changes o recibir JSON firmado en su propio endpoint.