# Página web para Markdown



<ToolHero tool="web-to-markdown" />

## Visão geral

Informe uma URL e receba o texto principal da página em Markdown, com título, autor e contagem de palavras. Com `collection_id`, o conteúdo também é gravado numa [base de conhecimento](/ferramentas/base-de-conhecimento). Também está disponível no [MCP](/agentes-de-ia) como `web_to_markdown`.

<EndpointList tool="web-to-markdown" />

## Custos

A conversão é uma leitura medida: entra na [franquia diária](/cobranca-e-limites#franquia-diaria) e, depois dela, debita o valor indicado no endpoint. Ao gravar numa base, a gravação é cobrada como uma ingestão da [base de conhecimento](/ferramentas/base-de-conhecimento).

## Endpoints

### Converter página em Markdown

<Endpoint id="web.markdown" example={{ body: `{ "url": "https://example.com/blog/post" }` }}>
  `url` (obrigatório) é o endereço `http` ou `https` da página. `collection_id` (opcional) grava o conteúdo nessa base e exige também o escopo `tools:rag:manage`.

  A resposta traz `url`, `final_url` (depois de redirecionamentos), `title`, `byline`, `markdown` e `word_count`. Com `collection_id`, vêm também `document` (`document_id`, `status` e `duplicate`) e, em dry-run, `estimate`.

  <Callout type="warn" title="Só HTML estático">
    A página é lida como o servidor a entrega, sem executar JavaScript: páginas que montam o conteúdo no navegador respondem `tools.web.no_content`. Endereços internos e privados são recusados (`tools.web.blocked_url`).
  </Callout>
</Endpoint>

## Erros

<ErrorTable tool="web-to-markdown" />