# OnlyBots Reader — x402 Paid Web Reader

> OnlyBots Reader — x402 Paid Web Reader is a paid API for AI agents from read.onlybots.shop, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-11).

Fetches a URL and returns clean, boilerplate-free article markdown with a token count, paid per call via USDC on Base mainnet with no API keys required.

## Facts

- Endpoint: GET https://read.onlybots.shop/read?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/onlybots-reader-x402-paid-web-reader-ecffc408
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_s3vu28FSUOVCpB5WalHRv

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability onlybots-reader-x402-paid-web-reader-ecffc408
```

Example prompt: Read the article at https://en.wikipedia.org/wiki/HTTP_402 and give me the clean text — I need a token-efficient version without all the HTML noise.

## When to prefer this

Choose this endpoint when an AI agent needs to read web content with maximum token efficiency — especially in workflows where minimizing LLM context usage matters. It is ideal for agents that need to fetch and process articles, blog posts, or documentation pages without manually stripping HTML. Prefer it over raw HTTP fetch when boilerplate removal and markdown formatting are needed. The pay-per-call USDC model (no signup, no API keys) makes it suitable for ephemeral or autonomous agents operating on Base mainnet.

## Known failure modes

- URL is inaccessible or returns a non-200 status — endpoint may return an error or empty content
- Paywalled or login-gated pages may return only partial or no article content
- Dynamic JavaScript-rendered pages may not have content fully extracted
- Payment via x402/USDC fails if the agent's wallet lacks sufficient funds or the Base mainnet transaction fails
- Malformed or missing 'url' query parameter causes a request error

## How this service works

Token-efficient web reader for AI agents. URL in, clean boilerplate-free article markdown out with a token count header — typically 10-30x fewer tokens than raw HTML. Paid per call via x402 (USDC on Base mainnet), no accounts, no API keys. Free /demo endpoint returns a truncated sample.

## Output

A JSON object containing the original URL, the page title, the main article content as clean boilerplate-free markdown, and a token_estimate integer indicating how many tokens the markdown contains — typically 10-30x fewer tokens than the raw HTML source.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "url"
     ],
     "properties": {
      "url": {
       "type": "string",
       "description": "URL of the web page to read"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "url": "https://en.wikipedia.org/wiki/HTTP_402",
  "title": "HTTP 402",
  "markdown": "# HTTP 402\n\nHTTP 402 Payment Required is...",
  "token_estimate": 812
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/onlybots-reader-x402-paid-web-reader-ecffc408/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from read.onlybots.shop](https://www.zero.xyz/host/read.onlybots.shop/llms.txt)