Page DeltasPage Deltas

FAQ & 문제 해결

일반적인 질문과 가장 자주 발생하는 문제를 디버깅하는 방법으로, 질문 빈도가 높은 순서대로 나열되어 있습니다.

일반

페이지가 변경되었는데 알림을 받지 못한 이유는 무엇인가요?

가장 일반적인 이유는 순서대로 다음과 같습니다:

  • LLM이 설명을 기반으로 변경 사항이 의미 있다고 판단하지 않았습니다. 모니터의 최근 확인 항목을 열어보면 차이점이 처리되었지만 알림을 보낼 가치가 없는 것으로 분류된 것을 볼 수 있습니다. 설명을 더 명확하게 작성하세요 (필터 & 설명 참조).
  • 우리가 추출하는 부분에서 페이지가 변경되지 않았습니다. 해시하기 전에 상용구(내비게이션, 바닥글, 광고)를 제거합니다. 변경 사항이 제거된 콘텐츠에 있었다면 결코 볼 수 없습니다.
  • 모니터가 일시 중지되었습니다. 모니터 세부 정보 페이지를 확인하세요 — 연속으로 10번 확인에 실패한 후 자동으로 일시 중지되는 경우가 많습니다.
  • 채널에 실패했습니다. 전달이 실패할 수 있습니다(잘못된 웹훅 URL, 확인되지 않은 이메일 수신자, 수신기에서의 HTTP 오류). 전달은 자동 재시도 없이 한 번만 시도됩니다.

의미 없는 변경 사항에 대한 알림을 받은 이유는 무엇인가요?

설명이 너무 모호하거나 무시할 항목이 언급되지 않았을 가능성이 큽니다. 알림을 유발한 노이즈 패턴에 대해 명시적인 "X 무시" 조항을 추가하도록 수정하세요. 변경 사항은 다음 확인에 적용됩니다.

알림은 얼마나 최신인가요?

확인을 통해 변경 사항이 감지되면 알림이 수초 내에 전달 대기열에 추가됩니다. 엔드투엔드(페이지 변경 → 알림 확인) 시간은 모니터를 확인하는 빈도에 따라 달라지며 이는 적응형입니다 — 자주 변경되는 페이지는 더 자주 확인되고, 상위 요금제는 더 높은 예약 우선순위를 얻습니다. 즉각적인 확인을 강제해야 하는 경우 지금 확인을 사용하세요.

페이지 콘텐츠를 저장하나요?

추출된 텍스트와 렌더링된 스크린샷을 확인 시마다 저장하며, 요금제의 보존 기간(요금제에 따라 다름) 동안 보관됩니다. 변경 사항 요약은 감지된 각 변경 사항과 함께 보존됩니다. 스크린샷은 Cloudflare R2에서 제공됩니다.

가져오기 & 차단

모니터가 "차단됨"으로 계속 실패합니다.

사이트가 우리의 요청을 감지하고 차단하고 있습니다. 크롤러는 자동으로 헤드리스 브라우저로 에스컬레이션한 다음 가정용 프록시로 전환하지만, 일부 사이트는 세 가지 모두를 차단합니다. 해결 방법:

  • 사이트에서 게시하는 API 또는 피드(/feed.xml, /api/...)를 모니터링하도록 전환하세요 — 이것들은 일반적으로 보호되지 않습니다.
  • 사이트에 사이트맵이 있는 경우 사이트맵을 주시하세요 — 사이트맵은 계속 액세스할 수 있는 경향이 있습니다.
  • 강력한 인증이 적용된 사이트의 경우 내부 상태가 변경될 때 Page Deltas 웹훅에 게시하는 자체 통합을 실행하세요.

모니터가 간헐적으로 403/429를 반환합니다.

이것은 사이트가 자동화된 요청을 제한하거나 차단하고 있다는 신호입니다. 크롤러는 이미 일반 HTTP에서 헤드리스 브라우저로, 그다음에는 가정용 프록시로 에스컬레이션합니다. 페이지가 여전히 간헐적으로 차단되는 경우 렌더링된 페이지보다는 사이트에서 게시하는 피드, API 또는 사이트맵을 주시하는 것이 일반적으로 더 안정적입니다.

API & 연동

API 키를 교체하려면 어떻게 해야 하나요?

새 키를 생성하여 클라이언트에서 교체한 다음 이전 키를 삭제하세요. 키는 독립적입니다 — 새 키를 발급해도 기존 키가 무효화되지는 않습니다.

웹훅 확인이 계속 실패합니다.

확인해야 할 세 가지 사항:

  • 구문 분석된 JSON이 아니라 원시 본문 바이트를 해싱하고 있습니다. JSON을 자동으로 구문 분석하는 프레임워크는 종종 원본 바이트를 삭제합니다.
  • 원시 본문만 서명하고 있습니다 — 타임스탬프도 없고 구분 기호도 없습니다. 헤더는 X-Signature: sha256=<hex>입니다.
  • 일정한 시간 내에 비교하고 있습니다 (Node에서는 timingSafeEqual, Python에서는 hmac.compare_digest).

계정

조직 이름을 변경할 수 있나요?

조직 이름은 등록 시 설정되며(이메일에서 파생됨) 현재는 사용자가 직접 편집할 수 없습니다. 앱의 모든 링크는 불투명한 ID를 사용하므로 앱의 어떤 부분도 이름에 의존하지 않습니다. 변경이 필요한 경우 지원팀에 이메일을 보내주세요.

데이터를 어떻게 내보내나요?

아직 원클릭 내보내기 기능은 없습니다. API를 통해 모니터와 감지된 변경 사항을 가져오거나(API 참조 참조), 지원팀에 이메일을 보내시면 도와드리겠습니다.

FAQ & 문제 해결 · 문서 · Page Deltas