AgentReader

Convierte cualquier URL o PDF en Markdown/JSON limpio para agentes de IA. MCP remoto (read_url, search, get_balance) + API REST; 5 lecturas gratuitas al día, luego $0.005/llamada vía x402 USDC en Base, sin necesidad de cuenta.

Ver en agentreader.xyz

Servidor MCP alojado

npx add-mcp 'https://agentreader.xyz/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

AgentReader

Lee las páginas web que el fetch de tu agente de IA no puede.

Las herramientas de fetch integradas devuelven shells de JavaScript vacíos, muros de cookies, bytes de PDF sin procesar, o HTML donde los menús y los anuncios queman miles de tokens. AgentReader devuelve el contenido real como Markdown o JSON limpio y compacto. Si un sitio bloquea bots, recibes un error claro rápidamente y no pagas nada. 5 lecturas gratuitas al día, luego $0.005 por llamada en USDC vía x402, sin necesidad de cuenta.

Conecta tu agente Prueba una lectura en tu navegador Precios

El problema

Los agentes obtienen páginas web todo el tiempo, y el resultado suele ser inútil. Estos son los casos para los que AgentReader está diseñado:

Páginas solo JavaScript
Muchos sitios envían un shell HTML casi vacío y construyen la página en el navegador. AgentReader detecta esto y renderiza la página en Chromium sin interfaz gráfica.

Muros de cookies y consentimiento
En lugar del artículo obtienes "acepta cookies". AgentReader acepta el diálogo de consentimiento y lee la página detrás de él.

PDFs
Los bytes de PDF sin procesar son inútiles para un modelo. AgentReader extrae el título, el texto y las tablas simples.

HTML con muchos tokens
La navegación, los scripts, los anuncios y el marcado pueden ser más del 90% de una página. AgentReader conserva el contenido principal, con encabezados, listas, tablas y enlaces absolutos.

Lo que no puede hacer: algunos sitios (grandes sitios de noticias y compras, por ejemplo) bloquean lectores automatizados con protección contra bots. AgentReader no intenta evadir eso. Recibes un error blocked en segundos y no se te cobra, para que tu agente pueda continuar.

Lo que obtienes

Un ejemplo real: la página de documentación de React react.dev/learn, medida el 18 de octubre de 2026 con el tokenizador cl100k_base.

Fetch HTTP simple: 265 KB de HTML, ~91,900 tokens

<!DOCTYPE html><html lang="en" dir="ltr"><head><meta charSet="utf-8" data-next-head=""/><meta name="viewport" content="width=device-width, initial-scale=1" data-next-head=""/><script async="" src="https://www.googletagmanager.com/gtag/js?id=G-B1E83PJ3RT"></script><title data-next-head="">Quick Start – React</title><link rel="canonical" href="https://react.dev/learn" data-next-head=""/><link rel=…
(15 script tags, inline styles, navigation for the whole site…)

AgentReader: 17 KB de Markdown, ~4,100 tokens

# Quick Start

Welcome to the React documentation! This page will give you an introduction to 80% of the React concepts that you will use on a daily basis.

### You will learn

-   How to create and nest components
-   How to add markup and styles
-   How to display data
-   How to render conditions and lists
…

Mismo contenido, aproximadamente 22 veces menos tokens. Los ahorros varían según la página: las páginas simples se reducen menos, las páginas pesadas más. Algunas herramientas de agentes ya convierten HTML a texto, pero normalmente no pueden renderizar JavaScript, superar muros de consentimiento ni leer PDFs.

Con format=json también obtienes campos estructurados: title, author, date, siteName, lang, wordCount, links[], tables[] y meta (por ejemplo, si se usó un navegador).

Conexión

AgentReader es un servidor MCP remoto en https://agentreader.xyz/mcp (HTTP transmisible) con las herramientas read_url, search y get_balance, y una API REST simple. No se necesita clave para las 5 lecturas gratuitas diarias.

Claude Code

claude mcp add --transport http agentreader https://agentreader.xyz/mcp

# with an API key for prepaid credits:
claude mcp add --transport http agentreader https://agentreader.xyz/mcp --header "Authorization: Bearer ar_..."

Cursor (~/.cursor/mcp.json) y otros clientes con configuración mcpServers

{
  "mcpServers": {
    "agentreader": {
      "url": "https://agentreader.xyz/mcp",
      "headers": { "Authorization": "Bearer ar_..." }
    }
  }
}

Omite headers si no tienes una clave.

Claude Desktop y claude.ai

Configuración → Conectores → Añadir conector personalizado, luego pega https://agentreader.xyz/mcp. Los conectores personalizados no pueden enviar un encabezado de clave API, por lo que esto usa las lecturas gratuitas diarias.

opencode (opencode.json)

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "agentreader": {
      "type": "remote",
      "url": "https://agentreader.xyz/mcp",
      "enabled": true,
      "headers": { "Authorization": "Bearer ar_..." }
    }
  }
}

REST (curl o cualquier cliente HTTP)

curl "https://agentreader.xyz/v1/read?url=https://react.dev/learn"
curl "https://agentreader.xyz/v1/read?url=https://react.dev/learn" -H "Authorization: Bearer ar_..."   # use prepaid credits

Claves y pago

Sin clave: 5 lecturas gratuitas al día por dirección IP.
Clave API (Authorization: Bearer ar_..., o x-api-key): usa los créditos prepagados de esa clave. Obtienes una clave cuando compras un paquete o un lote de tarjetas.
x402, sin clave: cuando se agotan las lecturas gratuitas, el servidor responde con HTTP 402 y una solicitud de pago. Un agente con un cliente x402 paga $0.005 en USDC en Base y reintenta. https://agentreader.xyz/v1/x402/read?url=… siempre usa x402.

Opciones

Para GET /v1/read. La herramienta MCP read_url acepta los mismos argumentos url, format, mode, render y extract. Los valores desconocidos devuelven un error 400 que explica los válidos.

Parámetro	Valores	Predeterminado	Qué hace	Cuándo usarlo	Ejemplo
`url`	cualquier URL http(s)	(obligatorio)	La página, PDF o feed RSS/Atom a leer. También se acepta como u o link, sin https://, o estilo de ruta /v1/read/https://….	Siempre. Codifica la URL si tiene su propia?consulta.	`/v1/read?url=https://react.dev/learn`
`format`	`markdown`, `json`	`markdown`	markdown devuelve solo el texto. json añade título, autor, fecha, enlaces, tablas y metadatos.	json cuando tu código necesita campos; markdown para pasarlo directamente a un modelo.	`/v1/read?url=https://arxiv.org/pdf/1706.03762&format=json`
`mode`	`auto`, `article`, `links`, `full`	`auto`	article: solo el contenido principal. links: lista de titulares con enlaces. full: toda la página, incluidas las partes no relacionadas con el artículo. auto elige article o links según la página. Los feeds RSS/Atom siempre devuelven sus elementos.	links para portadas y páginas de índice; full cuando la extracción del contenido principal omite algo.	`/v1/read?url=https://www.bbc.com/news&mode=links`
`render`	`auto`, `never`, `always`	`auto`	Si cargar la página en Chromium sin interfaz gráfica. auto lo hace solo cuando la obtención simple devuelve muy poco.	siempre si una página JavaScript vuelve incompleta; nunca por velocidad cuando sabes que la página es estática.	`/v1/read?url=https://react.dev/learn&render=never`
`extract`	lista separada por comas de nombres de campos, o un esquema JSON	(ninguno)	Devuelve campos nombrados (title, author, date, price, currency, image, brand, sku, rating, availability, summary…) de JSON-LD, OpenGraph, microdatos y metaetiquetas. Sin LLM. Los campos faltantes son null. En JSON como `fields`, en Markdown como front matter.	Páginas de productos, artículos y otras páginas con datos estructurados.	`/v1/read?url=https://books.toscrape.com/catalogue/a-light-in-the-attic_1000/index.html&format=json&extract=title,price,currency`
`nocache`	`1`	`off`	Omite la caché de resultados de 10 minutos y lee la página de nuevo.	Cuando la página cambió en los últimos minutos.	`/v1/read?url=https://react.dev/learn&nocache=1`

POST /v1/read con los mismos campos en un cuerpo JSON también funciona.

Precios

Solo pagas por lecturas exitosas. Los sitios bloqueados, los tiempos de espera y los errores son gratuitos.

Opción	Qué obtienes	Precio
Gratis	5 llamadas/día por IP, sin clave	$0
Pago por llamada	Sin cuenta. Vía x402 una vez que se agotan las llamadas gratuitas, o siempre en `/v1/x402/read`	$0.005 por llamada en USDC en Base
Paquete de créditos	500 llamadas por $1 USDC, sin caducidad	$0.0020/llamada, un pago x402
Paquete de créditos	5,000 llamadas por $8 USDC, sin caducidad	$0.0016/llamada, un pago x402
Lote de tarjetas	7,000 llamadas, sin caducidad	$10 con tarjeta (comprar)

Una búsqueda cuesta lo mismo que una lectura. Comprar sin clave te da una nueva clave API que contiene los créditos. Las claves no incluyen las llamadas gratuitas diarias. Paga con tarjeta en agentreader.xyz/buy; el proveedor de tarjetas gestiona la verificación, y los créditos llegan una vez que el pago se confirma en Base.

curl -X POST "https://agentreader.xyz/v1/credits/buy?bundle=500" -H "Authorization: Bearer ar_..."   # 402 with x402 payment request; pay and retry
curl "https://agentreader.xyz/v1/balance" -H "Authorization: Bearer ar_..."                                  # free calls left and credits

También incluido

Búsqueda web: /v1/search?q=… y la herramienta MCP search devuelven resultados (title, url, snippet) para que tu agente lea a continuación. Ejemplo: /v1/search?q=x402+protocol&limit=5
Feeds y portadas: los feeds RSS/Atom devuelven elementos con título, enlace, fecha y resumen. Ejemplo: /v1/read?url=https://feeds.bbci.co.uk/news/world/rss.xml
APIs oficiales: las páginas de StackOverflow/StackExchange, npm y PyPI se leen a través de sus APIs oficiales.

Preguntas frecuentes y límites

¿Funciona en todos los sitios?

No. Los sitios con protección fuerte contra bots (desafíos de Cloudflare, DataDome, PerimeterX) normalmente lo bloquean. Recibes un error blocked rápidamente y no pagas nada. Las páginas detrás de un inicio de sesión no son compatibles.

¿Qué tan rápido es?

Las páginas estáticas normalmente tardan menos de uno o dos segundos. Las páginas que necesitan un navegador tardan más, a menudo varios segundos. Los resultados se almacenan en caché durante 10 minutos.

¿Necesito una cuenta o una billetera de criptomonedas?

Sin cuenta. Para el nivel gratuito no necesitas nada. Más allá de eso, un agente puede pagar por llamada con x402, o puedes comprar un paquete de créditos con tarjeta y usar la clave API.

¿Qué está bloqueado?

Direcciones de red privadas e internas, y URLs que no sean http(s). Las solicitudes tienen límite de velocidad.

¿Dónde están los documentos legibles por máquina?

llms.txt · OpenAPI · Tarjeta de servidor MCP · Recursos x402 · estado