# Read Now — URL to clean markdown for AI agents (Lightning L402)

> Fetch a public http(s) URL and get cleaned markdown plus page metadata, discovered agent files (llms.txt, OpenAPI, ai-plugin), and Lightning pay hints. Operator: Hexbox Tools. No KYC. Payments to hexbox@hexbox-ln.hexboxtools.workers.dev.

Website: https://hexbox-read.hexboxtools.workers.dev/
This file: https://hexbox-read.hexboxtools.workers.dev/llms.txt

## Why pay this instead of scraping yourself
Many agent runtimes cannot fetch arbitrary pages (blocked, no browser, short timeouts). Read Now returns a single JSON object an LLM can ingest: title, description, markdown, word/token estimates, same-origin agent discovery files, and any Lightning addresses or bolt11 invoices found on the page.

## Free
- GET https://hexbox-read.hexboxtools.workers.dev/api/preview?url={url}
  Returns title, description, status, first 400 characters of markdown, and the paid endpoint. Use this to decide whether to pay.
- GET https://hexbox-read.hexboxtools.workers.dev/api/v1/read/sample — schema example, not live data
- GET https://hexbox-read.hexboxtools.workers.dev/health
- GET https://hexbox-read.hexboxtools.workers.dev/openapi.json
- GET https://hexbox-read.hexboxtools.workers.dev/api/agent.json

## Paid (L402 Lightning, 21 sats)
GET https://hexbox-read.hexboxtools.workers.dev/api/v1/read?url={url}

How to pay (no human in the loop):
1. GET https://hexbox-read.hexboxtools.workers.dev/api/v1/read?url=https://example.com  → HTTP 402
2. Read WWW-Authenticate: L402 macaroon="...", invoice="lnbc..."
   (JSON body also includes invoice, macaroon, payment_hash, how)
3. Pay the bolt11 invoice with any Lightning wallet / node / agent payer
4. Retry the same URL with header: Authorization: L402 <macaroon>:<preimage>

A GET without url still returns 402 so directory health probes succeed. After payment you must pass ?url=.

## Rules
- Public http/https only. Credentials in URLs, localhost, link-local, private RFC1918, metadata IPs, and non-web ports are rejected.
- We send our own User-Agent (HexboxRead/1.0); we do not forward your cookies or Authorization to the target.
- HTML, markdown, JSON, XML, and plain text are accepted. Binary/PDF is not extracted in this version.
- Markdown is capped at 80000 characters (truncated: true if cut).
- This is not a stealth unblocker, login bypass, or paywall circumvention service.

## Pricing
21 sats per successful paid read (~$0.0210 at $100k/BTC; live BTC price varies). Tips of any amount: hexbox@hexbox-ln.hexboxtools.workers.dev

## Related Hexbox Tools
Fee Now (Bitcoin fee calculator + L402 forecast): https://hexbox-fees.hexboxtools.workers.dev/llms.txt