# Leitor de páginas e rastreador

> Leitor de páginas e rastreador: Lê qualquer página pública como texto limpo, extrai dados estruturados, mapeia sites e tira prints.

URL: https://apicultura.app/ferramentas/leitor-paginas/
Atualizado em 05/11/2026 (2026-11-05).

## O que é Leitor de páginas e rastreador na APIcultura

Acesse Leitor de páginas e rastreador pelo APIcultura com uma única chave de API e saldo pré-pago em R$. Lê qualquer página pública como texto limpo, extrai dados estruturados, mapeia sites e tira prints. Respostas em JSON, cobrança só por chamada concluída e estorno automático em falhas.

Categoria: [Automação e dev](/catalogo/?cat=automacao). Autenticação: chave da própria APIcultura (`apk_live_...`); nenhuma conta de terceiros precisa ser conectada.

## Endpoints e preço por chamada

| Endpoint (slug) | O que faz | Preço por chamada | Rota |
|---|---|---|---|
| `pagina-ler` | Ler página | R$ 0,01 | `POST /v1/call/pagina-ler` |
| `pagina-extrair-estruturado` | Extrair dados estruturados | R$ 0,09 | `POST /v1/call/pagina-extrair-estruturado` |
| `site-mapear-urls` | Mapear URLs do site | R$ 0,01 | `POST /v1/call/site-mapear-urls` |
| `feed-rss-ler` | Ler feed RSS/Atom | R$ 0,01 | `POST /v1/call/feed-rss-ler` |
| `pagina-print` | Print de página | R$ 0,02 | `POST /v1/call/pagina-print` |
| `site-rastrear` | Rastrear site | R$ 0,05 | `POST /v1/call/site-rastrear` |
| `pagina-ler-alternativa` | Ler página (renderizada) | R$ 0,05 | `POST /v1/call/pagina-ler-alternativa` |
| `paginas-extrair-varias` | Extrair várias páginas | R$ 0,03 | `POST /v1/call/paginas-extrair-varias` |
| `site-sitemap` | Descobrir URLs (sitemap) | R$ 0,01 | `POST /v1/call/site-sitemap` |

### Ler página (`pagina-ler`)

Lê uma página pública e devolve Markdown limpo. Preço: R$ 0,01 por chamada.

- `url` (string, obrigatório), ex.: `https://example.com`
- `format` (string, opcional, padrão "both"), ex.: `md`
- `proxy` (string, opcional, padrão "none")
- `country` (string, opcional)
- `parse` (object, opcional)

### Schema de entrada de pagina-ler

```json
{
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "maxLength": 2000
    },
    "format": {
      "type": "string",
      "maxLength": 2000
    },
    "proxy": {
      "type": "string",
      "maxLength": 2000
    },
    "country": {
      "type": "string",
      "maxLength": 2000
    },
    "parse": {
      "type": "object"
    }
  }
}
```

### Extrair dados estruturados (`pagina-extrair-estruturado`)

Extrai dados estruturados (contatos, JSON) de uma página. Preço: R$ 0,09 por chamada.

- `url` (string, opcional), ex.: `https://news.ycombinator.com`
- `content` (string, opcional)
- `instruction` (string, opcional), ex.: `the top 3 stories on the front page`
- `schema` (object, opcional)
- `example` (object, opcional)

### Schema de entrada de pagina-extrair-estruturado

```json
{
  "required": [],
  "properties": {
    "url": {
      "type": "string",
      "maxLength": 2000
    },
    "content": {
      "type": "string",
      "maxLength": 2000
    },
    "instruction": {
      "type": "string",
      "maxLength": 2000
    },
    "schema": {
      "type": "object"
    },
    "example": {
      "type": "object"
    }
  }
}
```

### Mapear URLs do site (`site-mapear-urls`)

Lista todas as URLs de um site sem rastrear página por página. Preço: R$ 0,01 por chamada.

- `domain` (string, obrigatório), ex.: `docs.crawl4ai.com`
- `mode` (string, opcional, padrão "fast")
- `max_urls` (integer, opcional, padrão 5000, máx. 50000)
- `include` (string, opcional)
- `include_subdomains` (boolean, opcional, padrão false)

### Schema de entrada de site-mapear-urls

```json
{
  "required": [
    "domain"
  ],
  "properties": {
    "domain": {
      "type": "string",
      "maxLength": 2000
    },
    "mode": {
      "type": "string",
      "maxLength": 2000
    },
    "max_urls": {
      "type": "number"
    },
    "include": {
      "type": "string",
      "maxLength": 2000
    },
    "include_subdomains": {
      "type": "boolean"
    }
  }
}
```

### Ler feed RSS/Atom (`feed-rss-ler`)

Lê qualquer feed RSS ou Atom. Preço: R$ 0,01 por chamada.

- `limit` (integer, opcional)
- `url` (string, obrigatório), ex.: `https://blog.rust-lang.org/feed.xml`

### Schema de entrada de feed-rss-ler

```json
{
  "required": [
    "url"
  ],
  "properties": {
    "limit": {
      "type": "number"
    },
    "url": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

### Print de página (`pagina-print`)

Captura uma imagem de uma página pública. Preço: R$ 0,02 por chamada.

- `url` (string, obrigatório), ex.: `https://example.com`
- `viewportWidth` (integer, opcional, padrão 1280)

### Schema de entrada de pagina-print

```json
{
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "maxLength": 2000
    },
    "viewportWidth": {
      "type": "number"
    },
    "fields": {
      "type": "string",
      "maxLength": 2000
    },
    "max_items": {
      "type": "number"
    },
    "summary": {
      "type": "boolean"
    },
    "jq": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

### Rastrear site (`site-rastrear`)

Rastreia um site e devolve o conteúdo das páginas. Preço: R$ 0,05 por chamada.

- `limit` (integer, opcional, mín. 1, máx. 10), ex.: `3`
- `url` (string, obrigatório), ex.: `https://example.com`

### Schema de entrada de site-rastrear

```json
{
  "required": [
    "url"
  ],
  "properties": {
    "limit": {
      "type": "number"
    },
    "url": {
      "type": "string",
      "maxLength": 2000
    },
    "fields": {
      "type": "string",
      "maxLength": 2000
    },
    "max_items": {
      "type": "number"
    },
    "summary": {
      "type": "boolean"
    },
    "jq": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

Mais 3 endpoints na tabela acima; os parâmetros seguem o `input_schema` de cada um.

## Exemplo de chamada MCP

Com o MCP da APIcultura conectado, o agente usa a ferramenta `call` com o slug do endpoint e a entrada:

```json
{ "name": "call", "arguments": { "slug": "pagina-ler", "input": {"url":"https://example.com","format":"md"}, "max_cost_brl": 0.1 } }
```

## Exemplo de chamada HTTP

```bash
curl -X POST https://api.apicultura.app/v1/call/pagina-ler \
  -H "Authorization: Bearer $APICULTURA_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","format":"md"}'
```

## Formato da resposta, preço e limites

A resposta é JSON com `data` (o resultado do endpoint) e `meta` (inclui `cost_brl`, o valor cobrado). Preço deste endpoint: R$ 0,01 por chamada. Falhas do serviço (502) e pedidos recusados (422) não são cobrados. Use `max_cost_brl` para limitar o gasto por chamada; o saldo pré-pago em R$ é o teto. Parâmetros de entrada: exemplo acima.

## Workflows que usam Leitor de páginas e rastreador

- [Minerador de ofertas: ache os anúncios que já funcionam no seu nicho](/workflows/minerador-de-ofertas/)
- [Espionar um concorrente: anúncios ativos e criativos a partir do nome](/workflows/espionar-concorrente/)

## Experimente

Teste no playground interativo: [Leitor de páginas e rastreador no playground](/ferramentas/ferramenta.html?slug=leitor-paginas). Veja também [todas as ferramentas](/ferramentas/), [como conectar seu agente](/como-conectar/) e o [FAQ](/faq/).

> **Nota.** Leitor de páginas e rastreador é marca de seus respectivos donos, citada apenas para identificar a integração.