cited-readability
readability
article-extraction
boilerplate-removal
clean-citation
rag
rag-ingest
verifiable-web-fetch
attestation
provenance
verifiable-data-record
llm-ready
agent-web-fetch
scraping
keyless
agent-native

MERCURY Cited Readability

URL → a clean ARTICLE record { title, byline, publishedAt, article text } with boilerplate (nav/header/footer/sidebar/ads/share-bars/comment-forms) stripped via deterministic DOM density heuristics, plus a signed provenance receipt pinning the cleaned article to its source — the clean-citation primitive distinct from raw markdown. Deterministic (no LLM): same URL + same source bytes ⇒ byte-identical output.

get/buy/readability

Request

Query parameters

urlstring required

the article page to extract (http/https)

Response

Delivered after the x402 payment settles on Base mainnet.

okboolean required

true on success; false on an honest failure (503-before-charge — you are NOT billed)

urlstring required

final URL after redirects

statusinteger

upstream HTTP status

textstring

the canonical signed string: JSON.stringify(data, sortedKeys). The EIP-191 attestation signs THIS, so the buyer can prove the WHOLE article record (title+byline+date+body) is exactly what MERCURY extracted from this url at this time.

fetchedAtstring

ISO-8601 fetch time (also folded into the signed receipt)

errorstring

present only when ok:false

attestationobject

EIP-191 provenance receipt over sha256(text)+url+status+time, verifiable OFFLINE by anyone (key pinned at /.well-known/mercury-attestation). Proves THIS article record is exactly what MERCURY extracted from THIS url at THIS time — the wedge a free reader cannot emit.

Changes

No recorded changes to this operation across all 1 revision of this API.