SaaS Pricing & Terms Monitor API

Monitor pricing, terms, and feature pages and return structured diffs for growth, ops, legal, and competitive-intelligence workflows.

Store Quickstart

• Start with store-input.example.json for a proven three-page first run.
• If that output fits, switch to store-input.templates.json and pick one of:
• Quickstart Pricing Monitor for the cheapest first success
• Pricing + Terms + Features for broader daily monitoring
• Webhook Alert for Slack, Discord, or internal pipelines

主な用途:

• SaaS料金改定の早期検知
• 利用規約・返金条件の変更監視
• 機能ページ更新の差分追跡

Features

• 複数ターゲット監視 (price|terms|features|general)
• テキスト抽出 + SHA256スナップショット管理
• 変更サマリ（追加/削除行）
• 配信モード
  • dataset (推奨)
  • webhook
  • email (MVPではプレースホルダ)
• Apify KV が使えない環境でもローカル state/ にフォールバック

Project Layout

• src/ 実装本体
• test/ ユニットテスト
• scripts/ クラウド設定・運用スクリプト
• input.example.json 基本入力例
• input.local.json ローカル日次運用向け例

Local Run

cd /volume1/docker/Apify/saas-change-monitor-actor
cp -n .env.example .env
cp -n input.example.json input.json
./scripts/run-with-env.sh
cat output/results.json

ローカル日次実行ログ付き:

cd /volume1/docker/Apify/saas-change-monitor-actor
./scripts/run-local-daily.sh

Store掲載向けの初回入力例は store-input.example.json を使用してください。

Store Listing Ops

Storeメタデータを更新（タイトル/説明/カテゴリ/入力例）:

cd /volume1/docker/Apify/saas-change-monitor-actor
npm run store:optimize

KPIレポート生成（7日成功率 + Store検索順位）:

cd /volume1/docker/Apify/saas-change-monitor-actor
npm run store:kpi

Tests

cd /volume1/docker/Apify/saas-change-monitor-actor
npm test

Reliability Guardrails

Canary check (latest run health validation):

cd /volume1/docker/Apify/saas-change-monitor-actor
set -a && source .env && set +a
CANARY_RUN_TASK_FIRST=true npm run canary:check

Optional env:

• CANARY_LOOKBACK_HOURS (default 36)
• CANARY_MIN_TARGETS (default 1)
• CANARY_MAX_ERRORS (default 0)
• CANARY_ESCALATE_AFTER (default 2)
• DISCORD_WEBHOOK_URL (optional fail/recovery notifications)

Weekly contract test (run status + output schema drift detection):

cd /volume1/docker/Apify/saas-change-monitor-actor
set -a && source .env && set +a
npm run contract:test:live

Optional env:

• CONTRACT_RUN_TASK_FIRST (default true)
• CONTRACT_LOOKBACK_HOURS (default 72)
• CONTRACT_MIN_TARGETS (default 1)
• CONTRACT_NOTIFY_ON_PASS (default false)
• DISCORD_WEBHOOK_URL

Apify Cloud (推奨)

家庭用PC停止リスクを避ける場合は Apify Task + Schedule でクラウド常時運用します。

1. .env に最低限セット

APIFY_TOKEN=...
APIFY_ACTOR_ID=...

2. Task / Schedule 作成 + 公開設定（再実行可能）

$npm run apify:cloud:setup

3. 価格段階調整（必要時）

$NEXT_RESULT_PRICE=0.0002 npm run apify:schedule-price

4. 初期実績づくり（任意）

$SEED_RUNS=2 npm run apify:seed-usage

OpenClaw Daily Trigger Example

OpenClaw 側から日次で Apify Task を起動する例:

• openclaw-cron-example.sh

cd /volume1/docker/Apify/saas-change-monitor-actor
./openclaw-cron-example.sh

Input Highlights

• targets[] 監視対象
  • url か fixtureHtml / fixturePath のいずれか必須
  • includePatterns は絞り込み推奨
• delivery
  • dataset: Apify Datasetへ送信
  • webhook: 任意URLへPOST
• datasetMode
  • changes_only: changed|initial|error のみ
  • all: 全件
• notifyOnNoChange
  • false なら変更なし時の webhook 通知をスキップ

詳細は INPUT_SCHEMA.json を参照。

Output

output/results.json には以下が出力されます:

• meta.totals 監視結果集計
• meta.delivery 配信結果
• results[] 各ターゲットのステータスと差分

Notes

• 初回実行は status=initial が正常です。
• includePatterns が空だとノイズが増えるため、対象セクションに寄せて指定してください。
• scripts/run-with-env.sh は input.json が無い場合でも input.local.json / input.example.json に自動フォールバックします。
• Store掲載時は、説明文に「入力例」「典型ユースケース」「期待出力例」を入れると CVR が上がります。

Related actors

• ai-visibility-monitor-actor — see whether pricing or terms changes correlate with AI/search visibility changes.
• sitemap-analyzer — validate crawl structure on the pages that changed.
• structured-data-validator — check schema quality on pricing and product pages after a change.