가이드
모든 웹사이트를 변경 감지 API로 변환하는 방법
여러분이 주시하는 대부분의 웹페이지는 전용 API를 제공하지 않습니다. 경쟁사 요금표, 공급업체 서비스 약관 PDF, 규제 기관 공시, 파트너 변경 로그 등 데이터는 HTML 안에 그대로 존재하지만 호출할 엔드포인트가 없습니다. 현실적인 선택지는 세 가지입니다. 직접 스크레이퍼를 구축하고 잦은 오류를 감수하거나, 스크레이핑 API에 비용을 지불하고 페이지 전체를 요청 시마다 추출하거나, 아니면 페이지를 변경 피드로 전환하는 것입니다. 모니터가 여러분을 대신해 페이지를 주시하다가 실제로 중요한 변경이 발생했을 때만 JSON을 전송합니다. 이 글에서는 Page Deltas를 활용해 이 세 번째 경로를 처음부터 끝까지 구축하는 방법을 설명합니다.
무료 플랜 · 모니터링 URL 또는 사이트맵 10개 · 무제한 확인(best-effort) · AI 필터링 및 요약 · 모든 플랜에서 REST API, MCP, 서명된 웹훅 지원 · 신용카드 불필요
{
"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"
]
}직접 구축한 스크레이퍼 vs 스크레이핑 API vs 변경 피드
실용적인 판단 기준: 데이터 세트 구축을 위해 수천 개의 페이지가 필요하다면 스크레이핑 API를 사용하세요. 단일 공개 페이지가 특정 기준에 맞게 변경되는 시점을 파악해야 한다면 변경 피드가 훨씬 적은 코드와 최소한의 유지 관리로 문제를 해결해 줍니다.
자체 제작 스크레이퍼
제공 결과: 직접 파싱해야 하는 원시 HTML. 특수한 사이트를 완벽히 제어하려는 경우에 적합. 투입 리소스가 매우 큼(선택자, 프록시, 렌더링, 재시도 처리). 사이트 디자인이 개편되면 파서가 조용히 망가집니다. 최신성은 cron 실행 주기에 종속됨. 일반적인 비용: 인프라 비용 및 개발자의 소요 시간.
스크레이핑 API
제공 결과: 요청당 정형화된 데이터 추출. 대량의 페이지를 일괄 추출하는 경우에 적합. 리소스 투입은 낮음에서 중간 수준. 대부분의 레이아웃 변경 오류는 공급업체가 흡수. 최신성은 API를 호출하는 시점에 결정됨. 일반적인 비용: 요청당 크레딧 차감.
변경 피드(본 가이드)
제공 결과: 유의미한 변경이 감지되었을 때 AI 요약이 포함된 JSON 이벤트 수신. "이 페이지가 변경되면 시스템에 알림" 시나리오에 최적. 리소스 최소화: 모니터를 한 번 생성한 뒤 웹훅 또는 폴링만 연결하면 끝. 콘텐츠 추출과 LLM 프롬프트가 무엇이 중요한지 판별. 적응형 확인 수행; 일치 시 엔드포인트로 즉시 전송. 플랜별 모니터링 URL 수에 따른 과금(Page Deltas는 확인 횟수를 별도로 차감하지 않음).
구축하게 될 내용
기본 URL: https://api.pagedeltas.com. 모든 엔드포인트는 /api 하위에 있습니다. 성공 응답은 JSON 형식입니다.
계정 및 API 키
무료 Page Deltas 조직을 생성하고 API 키를 발급받습니다.
지침(Brief)이 포함된 모니터
공개 URL을 대상으로 자연어 지침(필터 조건)을 설정하여 모니터를 생성합니다.
폴링 또는 웹훅
GET /api/monitors/{id}/changes를 정기적으로 폴링하거나 일반 웹훅 채널을 연결하여 조건이 일치할 때마다 서명된 JSON이 애플리케이션으로 POST되도록 설정합니다.
선택적 MCP 연동
동일한 키를 MCP를 통해 Claude, Cursor 또는 VS Code에 연결합니다.
설정: 웹페이지를 변경 피드로 전환하기
API 키 발급부터 서명된 웹훅 수신까지 단 5단계로 완료됩니다. 풀(pull) 방식 대신 푸시(push) 방식을 원한다면 웹훅을 사용하는 것이 좋습니다.
계정 및 API 키 생성
pagedeltas.com/register에서 회원가입하세요. 신용카드가 필요 없습니다. 무료 플랜: 모니터링 URL 또는 사이트맵 10개, 무제한 확인(best-effort 빈도), AI 필터링 및 요약, 팀원 수 무제한, Slack / Discord / Teams / 이메일 / 서명된 웹훅 지원, 14일 기록 보관, REST API 및 MCP. 앱 내에서: Settings → API keys(editor 또는 admin 권한). 키를 생성하고 즉시 복사해 두세요. 키는 단 한 번만 표시됩니다. export PAGEDELTAS_TOKEN="pdt_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx". 키는 조직 범위로 발급되며 해당 조직 내에서 관리자 수준의 권한으로 작동합니다. 특정 팀원 개인에게 귀속되지 않으므로 팀원이 탈퇴해도 키는 유지됩니다. 접근 권한을 취소하려면 키를 삭제하세요. 비밀번호와 동일하게 환경 변수나 보안 저장소에 보관하고 버전 관리 설정 파일에 절대 커밋하지 마세요.
모니터 생성(cURL)
Authorization: Bearer $PAGEDELTAS_TOKEN 헤더와 함께 JSON 본문(url, nl_description(지침), 선택 항목 filter_prompt, channel_ids: [])을 구성하여 POST https://api.pagedeltas.com/api/monitors를 호출합니다. 지침 예시: "경쟁사 요금제 페이지. 플랜 가격이 변경되거나 새 플랜이 추가/삭제되거나 쿼터 및 제한 사항이 변경되면 알림을 보냅니다. 쿠키 배너, A/B 테스트 레이아웃, 롤링 추천사는 무시하세요." 별도의 확인 주기(frequency) 필드는 없습니다. 점검 주기는 적응형입니다(활성 페이지는 더 자주, 정적인 페이지는 덜 자주 확인하며 유료 플랜은 우선 확인 혜택 적용). 온디맨드 즉시 확인은 POST /api/monitors/{id}/check-now를 사용합니다(모니터당 분당 1회로 속도 제한). nl_description은 LLM이 변경 사항의 유의미함을 판별하는 기준 지침입니다. 지침이 모호하면 웹훅으로 불필요한 시각적 차분 데이터가 쏟아지게 됩니다. 선택적 매개변수: filter_prompt, css_selector, xpath_selector, is_pdf, channel_ids(모니터별 채널 재정의, 비워두면 조직 기본값 사용). 공개 웹페이지만 지원됩니다. 로그인 인증이 필요한 페이지는 아직 지원되지 않습니다. 기존 페이지의 수정 여부가 아니라 "완전히 새로운 URL이 생겼는가"를 감지하는 것이 목적이라면 사이트맵 모니터(/api/sitemap-monitors)를 별도 리소스로 사용하세요.
변경 피드 폴링
Bearer 토큰과 함께 GET https://api.pagedeltas.com/api/monitors/{id}/changes?limit=50을 호출합니다. 가장 최근 변경 사항부터 반환됩니다(기본 50개, 최대 100개). 커서는 제공되지 않으므로 이미 처리한 최신 detected_at 타임스탬프를 자체적으로 추적하세요. 각 변경 항목에는 id, detected_at, 그리고 summary가 포함됩니다. summary는 원시 HTML diff가 아니라 지침에 부합하는 변경점을 자연어로 서술한 AI 요약문입니다. summary를 Slack, 티켓팅 시스템 또는 다른 AI 에이전트로 바로 전달할 수 있습니다.
Python으로 모니터 생성 및 폴링 구현
requests 라이브러리를 사용하고 Authorization Bearer 및 Content-Type application/json 헤더를 설정합니다. url, nl_description, channel_ids: []를 담아 POST /api/monitors를 호출합니다. 응답에서 monitor["id"]를 확인합니다. 그 후 GET /api/monitors/{monitor_id}/changes(limit=50)를 호출하여 각 변경점의 detected_at과 summary를 출력합니다. 폴링 방식이 반드시 필요한 경우 스케줄러로 실행하세요. 푸시 형태의 이벤트를 선호한다면 웹훅을 권장합니다.
폴링 없이 푸시형 JSON 수신(HMAC 서명 웹훅)
앱 내에서: Channels → Add a channel → Generic webhook을 선택합니다. 수신할 HTTPS 엔드포인트 URL을 입력하세요. 채널 시크릿(Secret)이 표시되면 즉시 복사합니다(단 한 번만 표시됨). Send test를 클릭하세요. 또는 API를 통해 채널을 생성(POST /api/alert-channels)하고 PUT /api/monitors/{id}/alert-channels로 연결하거나, channel_ids를 비워두어 조직 기본값을 사용하도록 할 수도 있습니다. 조건에 맞는 변경이 감지될 때마다 해당 URL로 Content-Type application/json 및 X-Signature: sha256=<hex> 헤더를 포함한 평면 구조의 JSON이 POST 전송됩니다. 필드에는 event (change.detected), monitor_id, monitor_url, monitor_name, change_id, detected_at, summary, before_screenshot_url, after_screenshot_url, dashboard_url이 포함됩니다. 원시 요청 본문과 채널 시크릿을 사용해 HMAC-SHA256을 계산하여 X-Signature(헤더 형식 sha256=<hex>)를 검증하세요. JSON을 파싱하기 전 원시 바이트 그대로 해시를 계산해야 검증에 실패하지 않습니다. 향후 새 필드가 추가될 수 있으므로 알 수 없는 키는 무시하도록 구현하세요. 전송 시 주의사항: 현재 알림당 채널별 1회 전송만 시도되므로(자동 재시도 없음) 신속하게 응답하고 중복 수신에 대비해 멱등성을 갖추도록 처리하세요. 2xx 이외의 응답이나 네트워크 오류는 전송 실패로 기록되지만, 전송 실패로 인해 모니터 자체가 일시 중지되지는 않습니다. 모든 전송 시도는 서버 측에 감사 로그로 보관됩니다. 코드가 아닌 팀원에게 알리려면 동일한 방식으로 Slack, Discord, Teams 또는 이메일 채널을 구성하세요. Slack 연동 가이드는 "Slack에서 웹사이트 변경 알림을 받는 방법"을 참고하세요.
선택 사항: Claude, Cursor 또는 VS Code에서 모니터 제어(MCP)
동일한 API 키를 사용합니다. 스트리밍 지원 HTTP MCP 엔드포인트: https://api.pagedeltas.com/mcp. 에이전트는 create_monitor, list_monitor_changes, create_alert_channel 및 사이트맵 도구 등을 사용할 수 있습니다. MCP에서는 쿠키 세션 인증이 지원되지 않습니다. 폴링이 불필요한 이벤트 기반 시스템에는 웹훅 채널 사용을 권장합니다.
Cursor mcp.json
~/.cursor/mcp.json 파일에서 mcpServers.pagedeltas.url을 https://api.pagedeltas.com/mcp로 지정하고 headers.Authorization을 Bearer pdt_xxxxxxxx로 설정하세요. Cursor를 재시작하면 도구가 로드됩니다.
클라이언트별 전체 연동 코드
Claude Code, VS Code 및 mcp-remote 기반 Claude Desktop 연동 방법은 MCP 문서에 안내되어 있습니다.
MCP 문서 →자연어 지침이 곧 쿼리 언어입니다
기존 REST API에서는 쿼리 파라미터로 필터링합니다. 변경 피드에서는 모니터에 설정한 자연어 지침(브리프)이 필터 역할을 담당합니다. Page Deltas는 페이지를 수집하여 이전 검사와 비교한 뒤, 변경 사항이 작성한 지침에 부합하는지 LLM에 판별을 요청합니다. 조건에 부합하는 알림은 텍스트 요약문 및 전/후 스크린샷과 함께 전달됩니다. 팀원에게 업무를 인수인계하듯 명확하게 지침을 작성하세요.
가격 변동
요금제 가격이 바뀌거나 새로운 플랜 등급이 신설되었을 때.
입찰 / 제안요청서(RFP)
당사 사업 범위 내에서 새로운 입찰 공고가 게시되었을 때.
API 문서
API 문서에 엔드포인트가 추가, 삭제 또는 지원 중단(deprecated)되었을 때.
채용 공고
시니어 엔지니어 채용 공고가 등록되었을 때(비기술직 직무는 무시).
실제로 고려해야 할 쿼터(신경 쓰지 않아도 되는 쿼터)
Page Deltas에서 플랜 산정의 기준은 모니터링하는 URL(또는 사이트맵)의 개수이며, 월간 확인 횟수가 아닙니다. API 읽기/쓰기 엔드포인트는 합리적인 이용 범위를 벗어나지 않는 한 별도의 호출 요금이 부과되지 않습니다. 유일한 예외는 check-now 엔드포인트로, 모니터당 분당 1회로 제한됩니다(초과 시 429 응답 및 Retry-After 헤더 반환). 플랜의 URL 한도에 도달하면 현재 개수와 한도 정보가 포함된 422 코드가 반환됩니다. 확인 횟수 기반의 기존 도구들처럼 복잡한 계산("페이지 하나를 1시간마다 확인하면 월 약 720회...")을 할 필요가 없습니다. 모니터링할 페이지를 고르고 지침을 작성하기만 하면 확인 주기는 시스템이 알아서 조정합니다.
Free
모니터링 URL 10개 · 14일 기록 보관 · 무제한 확인(best-effort), AI, API, MCP, 5대 알림 채널 전체 지원 · $0
Starter
모니터링 URL 150개 · 30일 기록 보관 · 월 $29 · 우선 확인 혜택
Pro
모니터링 URL 1,000개 · 90일 기록 보관 · 월 $79
Business
모니터링 URL 5,000개 · 365일 기록 보관 · 월 $199
Scale
모니터링 URL 20,000개 · 730일 기록 보관 · 월 $499
Enterprise
맞춤형 URL 수 및 기록 보관 기간 · SSO / SCIM 지원
Visualping 스타일의 변경 API와의 결정적 차이점
Visualping의 개발자용 기능은 고정된 확인 주기, 선택적 CSS/XPath 지정, 월간 확인 횟수 한도, 그리고 픽셀 차분과 중요도 플래그 중심의 무거운 웹훅 페이로드에 의존합니다. "픽셀이 이동했을 때 이벤트를 받고 세부 판단은 자체 코드에 맡긴다"는 요구사항에는 적합합니다. 반면 Page Deltas는 "오직 이 지침에 일치하는 변경이 발생했을 때만 시스템을 깨운다"는 목적에 맞춰 설계되었습니다. 이 글은 기술 연동 가이드이며, 플랜별 세부 비교는 Page Deltas vs Visualping에서 확인하실 수 있습니다.
자연어 지침 우선 원칙
핵심 필터는 자연어 지침입니다. 선택자는 선택 사항일 뿐 필수가 아닙니다.
적응형 점검 주기
주기 문자열을 일일이 입력할 필요가 없습니다. 자주 변경되는 페이지는 더 자주, 잠잠한 페이지는 덜 자주 점검합니다.
간결하고 평면화된 웹훅 데이터
요약 텍스트(summary), 스크린샷 URL, HMAC X-Signature 검증을 중심으로 구성됩니다.
무제한 확인; 모니터링 URL 수에 따른 과금
모든 플랜에 무제한 확인이 포함됩니다. 모니터링하는 URL 개수에 대해서만 요금이 부과됩니다.
동일한 키로 지원되는 MCP
MCP는 REST API와 완전히 동일한 API 키를 공유합니다.
솔직한 서비스 한계 안내
프로덕션 환경과 연동하기 전에 이 변경 피드의 적용 대상과 한계를 명확히 확인하세요.
공개 웹페이지만 지원
마케팅 사이트, 공개 PDF, 공개 채용 게시판, 공개 사이트맵을 지원합니다. 로그인 인증이 필요한 포털은 로드맵에 포함되어 있으나 현재는 지원되지 않습니다.
시각적 회귀 또는 위변조 감지 전용 도구가 아님
"이 픽셀이 20px 이동했는가"를 감지하는 것이 목적이라면 전용 시각적 diff 도구가 더 적합합니다.
LinkedIn 또는 X 활동 모니터링 미지원
Page Deltas는 오픈 웹을 모니터링합니다. 개인 단위의 LinkedIn/X 활동 추적은 MultiFollow를, 소셜 미디어 전반의 키워드 언급 모니터링은 KWatch를 이용하세요.
웹훅 전송은 현재 1회 시도 방식
웹훅 수신 엔드포인트가 멱등성을 갖추도록 구현하세요.
관련 가이드 및 문서
팀을 위한 Slack 심층 설정, 노코드 퀵스타트 및 실시간 API 스펙 안내.
자주 묻는 질문
- API가 없는 웹사이트에서 데이터를 어떻게 가져오나요?
- 세 가지 방법이 있습니다: 직접 스크레이퍼를 제작하거나, 대량 추출용 스크레이핑 API를 사용하거나, 변경 모니터링 API를 페이지에 연결해 JSON 변경 피드를 수신하는 것입니다. "페이지가 변경될 때 시스템에 알림 수신"이 목적인 경우 모니터를 생성하고 웹훅이나 폴링을 연결하는 변경 피드 방식이 가장 적은 코드로 해결됩니다.
- 코드 작성 없이도 설정할 수 있나요?
- 네, 가능합니다. 대시보드에서 모니터를 만들고 Channels에서 일반 웹훅(또는 Slack / Teams / Discord / 이메일)을 추가한 뒤 지침을 작성하고 Send test를 클릭하세요. 노코드 경로는 퀵스타트 가이드에서 확인하실 수 있습니다.
- 스크레이핑 API와 변경 모니터링 API의 차이점은 무엇인가요?
- 스크레이핑 API는 호출할 때마다 전체 페이지 내용을 추출합니다. 변경 모니터링 API는 페이지를 지속적으로 감시하며 사전에 계산된 AI 요약과 함께 오직 발생한 변경점만 전달합니다. 데이터 대량 수집에는 스크레이퍼가 적합하고, "내 지침에 맞는 변화가 있었는가?"를 확인할 때는 변경 피드가 적합합니다.
- API나 웹훅 이용 시 추가 요금이 발생하나요?
- 아닙니다. REST API, MCP 및 서명된 웹훅은 Free 플랜을 포함한 모든 요금제에 기본 제공됩니다. 이용 한도는 플랜의 모니터링 URL 수로만 제한되며, 별도의 API 호출 크레딧은 없습니다.
- AI 에이전트가 저 대신 모니터를 생성해 줄 수 있나요?
- 네. Bearer API 키를 사용하여 MCP 클라이언트를 https://api.pagedeltas.com/mcp 로 지정하면 됩니다. 자세한 내용은 MCP 문서를 확인하세요.
작성자
Julien, Page Deltas 프로덕트 매니저. 평소 수동으로 새로고침하며 확인하던 공개 URL 하나를 골라보세요. 무료 계정을 만들고, API 키를 발급받고, 한 줄 지침으로 모니터를 생성한 뒤 일반 웹훅을 연결하여 HMAC 서명을 한 번 검증하세요. 그 후 실제 변경 알림을 기다리기만 하면 됩니다. 첫 알림 이후 불필요한 내용이 있다면 제외 목록을 다듬으세요. 이것이 변경 API 설정의 전부입니다.
단 하나의 페이지부터 변경 피드로 전환해 보세요
무료 플랜, 신용카드 불필요. 계정을 생성하고 API 키를 발급받은 뒤 확인하려는 URL을 입력하고 필터 가이드의 지침을 추가해 보세요. /changes를 폴링하거나 자체 엔드포인트로 서명된 JSON을 수신할 수 있습니다.