# Mito.news
> Importance briefs on mitochondria preprints — free to read, x402 for research bots

Version: 1.1.0
Homepage: https://mito.news

## Access policy (critical)
- **Humans:** free. Full importance articles at https://mito.news/articles and https://mito.news/articles/{id} (HTML). Digest at https://mito.news/digest.
- **Bots / agents:** machine-readable **JSON API is x402-paid** (USDC on Base via OpenX402).

Do not scrape HTML when you can pay for stable JSON schemas. HTML is for people; JSON is for agents.

## What the product is
Mito.news finds mitochondria-related preprints on bioRxiv/medRxiv, then writes original **importance articles**.
Humans read free. Bots pay for structured `mitos.article.v1` / `mitos.brief.v1` JSON.

Primary paid fields: `article.body_markdown`, `importance_thesis`, `key_claims`, `agent_takeaways`, etc.
`source.*` is citation context only.

## Free discovery URLs (bots: start here)
- https://mito.news/api/v1/index          ← preferred cold-start JSON index
- https://mito.news/.well-known/x402.json
- https://mito.news/.well-known/agent.json
- https://mito.news/api/v1/catalog        ← teasers with absolute paid_endpoint + free blurb
- https://mito.news/api/v1/manifest
- https://mito.news/api/v1/schemas
- https://mito.news/api/health
- https://mito.news/llms.txt

## Free human URLs
- https://mito.news/
- https://mito.news/articles
- https://mito.news/articles/{id}
- https://mito.news/digest
- https://mito.news/buy  (human MetaMask tester for paid JSON — optional, not for bots)

## Bot purchase path
1. GET https://mito.news/api/v1/index  (or /api/v1/catalog)
2. Read catalog.papers[].paid_endpoint (absolute URL) and blurb / importance_score
3. GET {paid_endpoint} without payment → HTTP 402 + PAYMENT-REQUIRED header + JSON body
4. Sign USDC payment (Base) via OpenX402 facilitator https://facilitator.openx402.ai
5. Retry with PAYMENT-SIGNATURE → 200 JSON mitos.brief.v1

## Paid bot endpoints (x402 exact USDC on Base)
Facilitator: https://facilitator.openx402.ai
Network: eip155:8453
Pay to: 0xe1946c7A27afc4Afc92690cC5c79b2771F85a0c1

| Endpoint | Price | Returns |
|---|---|---|
| GET https://mito.news/api/v1/papers | $0.01 | Batch importance briefs (JSON) |
| GET https://mito.news/api/v1/papers/{id} | $0.005 | One importance article (JSON) |
| GET https://mito.news/api/v1/digest | $0.02 | Nightly digest (JSON) |
| GET https://mito.news/api/v1/search?q= | $0.01 | Search commentary (JSON) |

### Payment flow
1. Call paid JSON endpoint without payment → HTTP 402 + PAYMENT-REQUIRED
2. Sign EIP-3009 USDC authorization on Base
3. Retry with PAYMENT-SIGNATURE
4. Receive application/json

## Deduping
Corpus is deduplicated by normalized DOI (version suffixes stripped), title, and content_hash.

## Docs
- x402: https://docs.x402.org/
- OpenX402: https://openx402.ai/