WebDoppler

Monitor any URL for changes, describe what data you want to capture in plain English, and receive structured webhook alerts automatically on every future change. WebDoppler is domain-agnostic — regulatory filings, competitor pricing, medical guidance updates, zoning notices — any public URL, any extraction intent.

{ "ok": false, "code": "forbidden", "error": "WebDoppler is not enabled for this workspace..." }

Use this when

• You need to know the moment a specific page changes — not just that it changed, but what changed and what the new data contains.
• You want structured data extracted from a page automatically on each change, without manual review or re-entry.
• You're monitoring IR pages, regulatory notice boards, or any site that posts time-sensitive documents.
• You want webhook delivery to your own system when a monitored URL changes.

How it works

1. Register a URL with optional keywords and a plain-English extraction intent.
2. Preview — Gyrence fetches the page and Claude extracts a structured preview based on your intent. You refine until it's right, then approve.
3. Monitor — Gyrence checks the URL on your configured schedule. When content changes, it runs the locked extraction automatically.
4. Receive — a signed webhook fires to your endpoint with the change signal and extracted fields.

Endpoints

Example

curl -X POST https://www.gyrence.com/api/v1/monitor/register \
  -H "Authorization: Bearer $GYRENCE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://bip.brookfield.com/distribution-history",
    "label": "BIP Distribution Matrix",
    "channels": ["ir_page"],
    "check_interval_hours": 24,
    "discovery_keywords": ["distribution matrix", "withholding", "1446"],
    "extract_intent": "PTP distribution matrix — extract per unit class: CUSIP, currency, record date, payment date, and per-source withholding amounts for both US and Canadian withholding."
  }'

{ "ok": true, "data": { "monitor_id": "uuid", "status": "active" } }

Returns current monitor status.

Returns paginated run history. Query params: limit (default 20, max 100), before (ISO timestamp cursor).

Removes the monitor. Returns { "ok": true, "data": { "deleted": true } }.

Configure webhook delivery for your workspace. Accepts { webhook_url, webhook_secret }. Pass null to clear.

Alert channels

Alerts can be delivered via webhook, email, SMS, or Slack. Configure defaults per workspace or override per monitor.

Slack uses a standard Incoming Webhook URL. Paste the URL into your alert settings — no OAuth flow required.

Fetch the monitored URL and run Claude extraction against your intent. Returns a structured preview for you to review. Optionally pass { refinement: "..." } in the body to iterate.

Lock the extraction template. Pass { extracted_sample, locked_prompt }. Once approved, every future alert runs the same extraction automatically. Returns { "ok": true, "data": { "approved": true } }.

Webhook payload

Gyrence signs every webhook with HMAC-SHA256 over the raw body using your webhook_secret. Verify the X-Gyrence-Signature header before processing.

{
  "monitor_id": "uuid",
  "caller_id": "crescentic_subscriber_id",
  "url": "https://bip.brookfield.com/distribution-history",
  "detected_at": "2026-06-28T14:22:00Z",
  "outcome": "changed",
  "top_score": 84.2,
  "channel": "ir_page",
  "change_signal": [
    { "field": "attr:href", "from": null, "to": "/files/distribution-matrix-q2-2026.pdf", "ratio": 0 },
    { "field": "text", "from": "Q1 2026", "to": "Q2 2026", "ratio": 0.67 }
  ],
  "pdf_links": ["https://bip.brookfield.com/files/distribution-matrix-q2-2026.pdf"],
  "extracted_fields": {
    "found": true,
    "data": [
      {
        "unit_class": "Regular LP Units",
        "cusip": "G16252101",
        "currency": "USD",
        "periods": [
          {
            "record_date": "2026-05-29",
            "payment_date": "2026-06-30",
            "quarter_label": "Q2",
            "total_distribution": 0.4550,
            "us_withholding": { "total_subject_to_us_withholding": 0.0474 },
            "canadian_withholding": { "total_subject_to_canadian_withholding": 0.3754 }
          }
        ]
      }
    ]
  },
  "content_preview": "Distribution Matrix Q2 2026 — Brookfield Infrastructure Partners L.P..."
}

Outcomes

Extraction intent

When you register a monitor with extract_intent, WebDoppler opens an iterative preview loop:

1. Gyrence fetches the page and scopes content to your discovery_keywords matches.
2. Claude reads the scoped content and extracts structured data based on your intent.
3. You see the result in the WebDoppler UI — rendered as a labeled tree, not raw JSON.
4. Refine if anything is missing or wrong. Claude sees your original intent plus each refinement.
5. Approve to lock the template. Every future alert runs the locked extraction automatically.

The approved extraction is bespoke to your monitor. There are no fixed schemas — Claude interprets your plain-English intent and produces whatever structure fits the data it found. Your approval is the quality gate.

"extract_intent": "1099-DIV box percentages by share class for the full tax year.
  I need box 1a (ordinary dividend), 1b (qualified), 2a (capital gains),
  3 (return of capital), and 5 (Section 199A) as decimals summing to 1.0."

Errors