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.

Atualizado em 05/11/2026.

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. Autenticação: chave da própria APIcultura (apk_live_...); nenhuma conta de terceiros precisa ser conectada.

Endpoints e preço por chamada

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

{
  "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

{
  "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

{
  "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

{
  "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

{
  "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

{
  "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:

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

Exemplo de chamada HTTP

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
• Espionar um concorrente: anúncios ativos e criativos a partir do nome

Experimente

Teste no playground interativo: Leitor de páginas e rastreador no playground. Veja também todas as ferramentas, como conectar seu agente e o FAQ.

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