# Agent Read Proxy

> Agent Read Proxy is a paid API for AI agents from agent-read-proxy.agent-read-proxy.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-31).

Fetches a public web page or document (PDF, Word, Excel, CSV) and returns clean readable content as plain text or Markdown with metadata such as title, author, publish date, and language.

## Facts

- Endpoint: GET https://agent-read-proxy.agent-read-proxy.workers.dev/v1/read?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-read-proxy-edf73988
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HuSUv1uAXaHtk_BSMZZJ6

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 agent-read-proxy-edf73988
```

Example prompt: Can you fetch the article at https://en.wikipedia.org/wiki/Motocross and give me the content as markdown, including the title and author if available?

## When to prefer this

Choose this endpoint when an AI agent needs to read the human-readable content of any public URL — whether a web article, blog post, Wikipedia page, PDF, Word doc, Excel file, or CSV — and get back clean text or Markdown stripped of ads, navigation, and scripts. It is especially valuable when you also need structured metadata (title, author, publish date, language) alongside the content. Prefer this over raw HTTP fetches when you want content already cleaned and parsed, and over general web search APIs when you have a specific URL to read rather than a query to resolve.

## Known failure modes

- URL is unreachable or returns a non-200 HTTP status — fetch fails, not charged
- URL points to a private or paywalled page — content may be empty or partial
- Unsupported document type (e.g. ZIP, binary) — returns error
- URL is malformed or missing — validation error on required parameter
- Content extraction yields very little text (e.g. heavily JavaScript-rendered page) — partial or empty content returned

## How this service works

Fetch a public web page and return its readable content as JSON: plain text or Markdown (headings, lists, links kept), plus title, description, author, publish date, site name, language and preview image. Ads, menus and scripts are stripped. Also reads PDF, Word, Excel and CSV links. Failed fetches are not charged.

## Output

A JSON object containing the clean readable content of the requested page or document in plain text or Markdown format, along with metadata: title, language, canonical URL, author, publish date, site name, preview image URL, word count, fetch timestamp, and a truncated flag indicating whether the content was cut short.

## 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",
       "format": "uri",
       "description": "Public http(s) web page or document (PDF, Word, Excel, CSV) to read"
      },
      "format": {
       "enum": [
        "text",
        "markdown"
       ],
       "type": "string",
       "default": "text",
       "description": "Output format"
      }
     }
    }
   },
   "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/Motocross",
  "title": "Motocross - Wikipedia",
  "format": "markdown",
  "language": "en",
  "markdown": "From Wikipedia, the free encyclopedia\n\nOff-road motorcycle racing held on enclosed off-road circuits\n\n## History\n\n...",
  "truncated": false,
  "fetched_at": "2026-10-28T01:30:00.000Z",
  "word_count": 4463,
  "canonical_url": "https://en.wikipedia.org/wiki/Motocross"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-read-proxy-edf73988/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-read-proxy.agent-read-proxy.workers.dev](https://www.zero.xyz/host/agent-read-proxy.agent-read-proxy.workers.dev/llms.txt)