parse_freshness_signals
Pure parser (no fetching). Given HTML plus optional response headers and a sitemap entry for the same URL, extracts every freshness marker on the page — HTTP Last-Modified, sitemap lastmod, JSON-LD dateModified/datePublished (including @graph), OpenGraph article:modified_time/published_time, meta updated/dc.date.modified/dcterms.modified/itemprop dateModified, and the first labelled visible date (Last updated / Updated / Published). Returns per-source ISO dates, the freshest source, cross-source agreement spread, and heuristic flags (stale year in title, suspicious future date, only-published-not-modified, none-at-all). Powers the geo-aeo-readiness skill's freshness check — Last-Modified headers and dateModified JSON-LD are weighted heavily for AI grounding eligibility.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"html": "<html>"
},
"name": "parse_freshness_signals"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | URL the HTML was fetched from (for context) | |
| html | Yes | Full HTML of the page | |
| headers | No | Response headers as a plain object with lowercased keys (e.g. {"last-modified": "..."}) | |
| sitemapEntry | No | Parsed sitemap entry for this URL, e.g. {"lastmod": "2026-04-15"} |