AgentReader

Converte qualquer URL ou PDF em Markdown/JSON limpo para agentes de IA. MCP remoto (read_url, search, get_balance) + API REST; 5 leituras gratuitas por dia, depois $0,005 por chamada via x402 USDC na Base, sem necessidade de conta.

Ver em agentreader.xyz

Servidor MCP hospedado

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

Instala no Claude Code, Codex, Cursor e outros

Documentação

AgentReader

Leia as páginas da web que o fetch do seu agente de IA não consegue.

As ferramentas de fetch integradas retornam shells vazios de JavaScript, muros de cookies, bytes brutos de PDF ou HTML onde menus e anúncios queimam milhares de tokens. O AgentReader retorna o conteúdo real como Markdown ou JSON limpo e compacto. Se um site bloquear bots, você recebe um erro claro rapidamente e não paga nada. 5 leituras gratuitas por dia, depois $0,005 por chamada em USDC via x402, sem necessidade de conta.

Conecte seu agente Experimente uma leitura no seu navegador Preços

O problema

Agentes buscam páginas da web o tempo todo, e o resultado geralmente é inútil. Estes são os casos para os quais o AgentReader foi criado:

Páginas somente com JavaScript
Muitos sites enviam um shell HTML quase vazio e constroem a página no navegador. O AgentReader detecta isso e renderiza a página no Chromium headless.

Muros de cookies e consentimento
Em vez do artigo, você recebe "aceite cookies". O AgentReader aceita o diálogo de consentimento e lê a página por trás dele.

PDFs
Bytes brutos de PDF são inúteis para um modelo. O AgentReader extrai o título, o texto e tabelas simples.

HTML pesado em tokens
Navegação, scripts, anúncios e marcação podem ser 90%+ de uma página. O AgentReader mantém o conteúdo principal, com cabeçalhos, listas, tabelas e links absolutos.

O que ele não pode fazer: alguns sites (grandes sites de notícias e compras, por exemplo) bloqueiam leitores automatizados com proteção contra bots. O AgentReader não tenta contornar isso. Você recebe um erro blocked em segundos e não é cobrado, para que seu agente possa seguir em frente.

O que você obtém

Um exemplo real: a página de documentação do React react.dev/learn, medida em 18 de outubro de 2026 com o tokenizador cl100k_base.

Fetch HTTP simples: 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
…

Mesmo conteúdo, cerca de 22 vezes menos tokens. A economia varia por página: páginas simples encolhem menos, páginas pesadas mais. Algumas ferramentas de agente já convertem HTML em texto, mas geralmente não conseguem renderizar JavaScript, passar por muros de consentimento ou ler PDFs.

Com format=json você também obtém campos estruturados: title, author, date, siteName, lang, wordCount, links[], tables[] e meta (por exemplo, se um navegador foi usado).

Conectar

O AgentReader é um servidor MCP remoto em https://agentreader.xyz/mcp (HTTP transmissível) com as ferramentas read_url, search e get_balance, e uma API REST simples. Nenhuma chave é necessária para as 5 leituras gratuitas por dia.

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) e outros clientes com configuração mcpServers

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

Deixe de fora headers se você não tiver uma chave.

Claude Desktop e claude.ai

Configurações → Conectores → Adicionar conector personalizado, depois cole https://agentreader.xyz/mcp. Conectores personalizados não podem enviar um cabeçalho de chave de API, então isso usa as leituras gratuitas diárias.

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 ou qualquer 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

Chaves e pagamento

Sem chave: 5 leituras gratuitas por dia por endereço IP.
Chave de API (Authorization: Bearer ar_..., ou x-api-key): usa os créditos pré-pagos nessa chave. Você recebe uma chave ao comprar um pacote ou pacote de cartões.
x402, sem chave: quando as leituras gratuitas acabam, o servidor responde com HTTP 402 e uma solicitação de pagamento. Um agente com um cliente x402 paga $0,005 em USDC na Base e tenta novamente. https://agentreader.xyz/v1/x402/read?url=… sempre usa x402.

Opções

Para GET /v1/read. A ferramenta MCP read_url aceita os mesmos argumentos url, format, mode, render e extract. Valores desconhecidos retornam um erro 400 que explica os válidos.

Parâmetro	Valores	Padrão	O que faz	Quando usar	Exemplo
`url`	qualquer URL http(s)	(obrigatório)	A página, PDF ou feed RSS/Atom para ler. Também aceito como u ou link, sem https://, ou estilo de caminho /v1/read/https://….	Sempre. Codifique a URL se ela tiver ?query própria.	`/v1/read?url=https://react.dev/learn`
`format`	`markdown`, `json`	`markdown`	markdown retorna apenas o texto. json adiciona título, autor, data, links, tabelas e metadados.	json quando seu código precisa de campos; markdown para passar direto a um modelo.	`/v1/read?url=https://arxiv.org/pdf/1706.03762&format=json`
`mode`	`auto`, `article`, `links`, `full`	`auto`	article: apenas o conteúdo principal. links: lista de manchetes com links. full: a página inteira, incluindo partes não relacionadas ao artigo. auto escolhe article ou links com base na página. Feeds RSS/Atom sempre retornam seus itens.	links para páginas iniciais e de índice; full quando a extração do conteúdo principal perde algo.	`/v1/read?url=https://www.bbc.com/news&mode=links`
`render`	`auto`, `never`, `always`	`auto`	Se deve carregar a página no Chromium headless. auto faz isso apenas quando a busca simples retorna pouco demais.	sempre se uma página JavaScript voltar incompleta; nunca para velocidade quando você sabe que a página é estática.	`/v1/read?url=https://react.dev/learn&render=never`
`extract`	lista separada por vírgulas de nomes de campos, ou um esquema JSON	(nenhum)	Retorna campos nomeados (title, author, date, price, currency, image, brand, sku, rating, availability, summary…) de JSON-LD, OpenGraph, microdados e meta tags. Sem LLM. Campos ausentes são null. Em JSON como `fields`, em Markdown como front matter.	Páginas de produtos, artigos e outras páginas com dados estruturados.	`/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`	Ignora o cache de resultados de 10 minutos e lê a página novamente.	Quando a página mudou nos últimos minutos.	`/v1/read?url=https://react.dev/learn&nocache=1`

POST /v1/read com os mesmos campos em um corpo JSON também funciona.

Preços

Você só paga por leituras bem-sucedidas. Sites bloqueados, timeouts e erros são gratuitos.

Opção	O que você obtém	Preço
Grátis	5 chamadas/dia por IP, sem chave	$0
Pague por chamada	Sem conta. Via x402 quando as chamadas gratuitas acabarem, ou sempre em `/v1/x402/read`	$0,005 por chamada em USDC na Base
Pacote de créditos	500 chamadas por $1 USDC, sem expiração	$0,0020/chamada, um pagamento x402
Pacote de créditos	5.000 chamadas por $8 USDC, sem expiração	$0,0016/chamada, um pagamento x402
Pacote de cartões	7.000 chamadas, sem expiração	$10 por cartão (comprar)

Uma busca custa o mesmo que uma leitura. Comprar sem uma chave dá a você uma nova chave de API que contém os créditos. As chaves não incluem as chamadas gratuitas diárias. Pague por cartão em agentreader.xyz/buy; o provedor de cartão cuida da verificação, e os créditos chegam quando o pagamento confirma na 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

Também incluído

Busca na web: /v1/search?q=… e a ferramenta MCP search retornam resultados (título, url, trecho) para seu agente ler em seguida. Exemplo: /v1/search?q=x402+protocol&limit=5
Feeds e páginas iniciais: feeds RSS/Atom retornam itens com título, link, data e resumo. Exemplo: /v1/read?url=https://feeds.bbci.co.uk/news/world/rss.xml
APIs oficiais: páginas StackOverflow/StackExchange, npm e PyPI são lidas por meio de suas APIs oficiais.

FAQ e limites

Funciona em todos os sites?

Não. Sites com forte proteção contra bots (desafios Cloudflare, DataDome, PerimeterX) geralmente bloqueiam. Você recebe um erro blocked rapidamente e não paga nada. Páginas atrás de login não são suportadas.

Quão rápido é?

Páginas estáticas geralmente levam menos de um ou dois segundos. Páginas que precisam de um navegador levam mais tempo, muitas vezes vários segundos. Os resultados são armazenados em cache por 10 minutos.

Preciso de uma conta ou carteira de criptomoedas?

Sem conta. Para o nível gratuito, você não precisa de nada. Além disso, um agente pode pagar por chamada com x402, ou você pode comprar um pacote de créditos por cartão e usar a chave de API.

O que é bloqueado?

Endereços de rede privados e internos, e URLs não-http(s). As solicitações são limitadas por taxa.

Onde estão os documentos legíveis por máquina?

llms.txt · OpenAPI · Cartão do servidor MCP · Recursos x402 · status