FAQとトラブルシューティング

よくある質問と頻出する問題の解決策を、発生頻度の高い順に掲載しています。

全般

ページが変更されたのに、なぜアラートが届かないのですか？

よくある理由は以下の通りです（多い順）:

LLMが、入力された説明文に照らして意味のある変更ではないと判断した。 モニターの最近のチェック履歴を確認してください。差分は処理されたものの、アラートを送る価値がないと分類されたことがわかります。説明文をより具体的にしてください（詳細はフィルターと説明文を参照）。
抽出対象外の部分が変更された。 ハッシュ化する前に定型文（ナビ、フッター、広告）を削除しています。削除されたコンテンツ内で変更があった場合、システムはそれを検出しません。
モニターが一時停止している。 モニター詳細ページを確認してください。10回連続でチェックに失敗すると自動的に一時停止されるため、驚かれることがよくあります。
通知チャネルが失敗した。 配信に失敗することがあります（Webhook URLの誤り、未確認のメール受信者、受信側でのHTTPエラーなど）。配信は1回のみ試行され、自動再試行はありません。

重要ではない変更に対して、なぜアラートが届くのですか？

説明文が曖昧すぎるか、無視すべき内容が記載されていない可能性があります。ノイズとなった内容について「Xを無視してください」という明示的な項目を追加して編集してください。変更は次回のチェックから適用されます。

アラートの鮮度はどのくらいですか？

チェックで変更が検出されると、数秒以内にアラートが配信キューに入れられます。エンドツーエンド（ページの変更からアラート表示まで）は、モニターのチェック頻度に依存します。チェック頻度は適応型で、頻繁に変わるページほど頻繁にチェックされ、上位プランほど優先度が高くなります。強制的に今すぐチェックしたい場合は 今すぐチェック を使用してください。

ページのコンテンツを保存していますか？

チェックごとに抽出されたテキストとレンダリングされたスクリーンショットを、プランの保存期間（プランにより異なります）に従って保存します。変更サマリーは検出された各変更とともに保持されます。スクリーンショットはCloudflare R2から配信されます。

取得とブロック

モニターが「blocked」で失敗し続けます。

対象サイトが弊社のリクエストを検出してブロックしています。取得機能は自動的にヘッドレスブラウザ、次にレジデンシャルプロキシへとエスカレーションしますが、一部のサイトはこれらすべてをブロックします。回避策:

サイトが公開しているAPIやフィード（/feed.xml, /api/... など）の監視に切り替えてください。これらは通常、保護されていません。
サイトにサイトマップがある場合は、それを監視してください。サイトマップはアクセス可能な状態に保たれる傾向があります。
強固な認証があるサイトの場合は、内部状態が変化したときにPage Deltasのウェブフックにポストする独自の統合機能を実行してください。

モニターが断続的に403/429を返します。

これらは、サイトが自動リクエストを制限またはブロックしている兆候です。取得機能はすでに通常のHTTPからヘッドレスブラウザ、次にレジデンシャルプロキシへとエスカレーションしています。それでも断続的にブロックされる場合は、レンダリングされたページよりも、サイトが公開しているフィード、API、またはサイトマップを監視する方が通常は信頼性が高くなります。

APIと統合

APIキーを更新（ローテーション）するにはどうすればよいですか？

新しいキーを作成し、クライアント側で差し替えてから、古いキーを削除してください。キーは独立しており、新しいものを発行しても既存のものが無効になることはありません。

ウェブフックの検証が失敗し続けます。

以下の3点を確認してください:

パースされたJSONではなく、生のボディバイトでハッシュ化しているか。JSONを自動パースするフレームワークでは、元のバイトデータが破棄されることがよくあります。
生のボディのみ を署名しているか。タイムスタンプやセパレーターはありません。ヘッダーは X-Signature: sha256=<hex> です。
定数時間比較（Nodeなら timingSafeEqual、Pythonなら hmac.compare_digest）を使用しているか。

アカウント

組織名を変更できますか？

組織名は登録時に設定され（メールアドレスから派生）、現在はユーザー自身で編集することはできません。リンクには不透明なIDが使用されているため、アプリ内で名前に依存する部分はありません。変更が必要な場合は、サポートまでメールでお問い合わせください。

データをエクスポートするにはどうすればよいですか？

ワンクリックでのエクスポート機能はまだありません。モニターとその変更履歴はAPIを通じて取得できます（詳細は APIリファレンスを参照）。またはサポートまでメールをいただければお手伝いいたします。