Converta documentos com MinerU dentro do Claude Code

Install

npx skills add tanis90/pdf-converter-mineru

Para quem

Se já trata documentos locais no Claude Code e quer passar PDF, imagens ou ficheiros Office para texto editável, esta habilidade encaixa. O texto oficial escreve-a como uma habilidade Claude Code no ecossistema MinerU para converter PDF e outros documentos. A página MinerU está em

https://mineru.net/

Os formatos de saída estão escritos Markdown, Word, HTML, LaTeX ou texto simples. O ambiente nomeado é Claude Code: quando pede converter ou extrair um documento, o Claude chama mineru-open-api automaticamente. A página não dá comandos de instalação para outros agentes nem escreve o âmbito como um roster exclusivo.

O perfil mais adequado tem um PDF ou ficheiro de escritório que pode ser convertido em local e quer ver primeiro o resultado flash-extract por defeito, não saltar para o extract completo. Notas oficiais:

https://github.com/tanis90/pdf-converter-mineru

Primeira tentativa em 3 minutos

Use só este caminho oficial de instalação:

npx skills add tanis90/pdf-converter-mineru

Pré-requisito: já consegue abrir o Claude Code em local e tem um PDF ou documento de escritório local. A instalação é esse comando; a página não dá um segundo instalador.

Para a primeira tarefa escolha uma conversão de baixo risco. Primeiro confirme com o Claude o caminho de origem, o formato de destino (comece por Markdown ou texto simples) e onde escrever o resultado; depois de concordar, deixe converter. O modo por defeito é flash-extract; não é preciso autenticar primeiro. A conversão escreve um ficheiro novo e também é uma chamada de saída. Confirme o caminho antes de executar.

Sinal de sucesso: com a habilidade instalada, o Claude usa mineru-open-api automaticamente e produz um Markdown ou texto simples que se pode abrir, não um aviso de «não instalado». Se quiser mineru-open-api auth, pare primeiro e confirme que quer desbloquear o modo extract. Isso não é obrigatório na primeira tentativa.

Casos de uso

Caso 1: passar um PDF para Markdown com flash-extract por defeito.

O texto oficial diz que um PDF pode passar a Markdown e que o defeito é flash-extract. Da primeira vez converta um PDF conhecido e confira se títulos e parágrafos ficam. A página não diz o que acontece com cabeçalhos, rodapés, digitalizações ou PDF cifrados, nem a diferença de qualidade entre flash-extract e extract. Só pode confirmar o nome do modo por defeito e que o Claude chama mineru-open-api automaticamente.

Caso 2: autenticar primeiro e depois extract numa imagem ou documento Office.

O texto oficial diz que executar mineru-open-api auth desbloqueia o modo extract. O âmbito inclui imagens e documentos Office; o destino ainda pode ser Markdown, Word, HTML, LaTeX ou texto simples. Execute a autenticação sozinha primeiro e, depois de ver o desbloqueio, escolha uma imagem ou ficheiro de escritório. A autenticação altera credenciais locais; confirme que a janela de comando vem de mineru-open-api auth antes de continuar. A página não enumera os campos de autenticação nem interruptores extra de extract.

Ambos os casos assentam no mesmo comando de instalação npx. Não tente outros métodos em paralelo da primeira vez.

Limites de uso

O único comando oficial de instalação copiável é npx skills add tanis90/pdf-converter-mineru. O defeito é sempre flash-extract. Para extract tem de terminar primeiro mineru-open-api auth com sucesso. A página não põe a autenticação como requisito da primeira conversão nem diz que pode saltar o Claude e usar isto como conversor autónomo.

A cobertura é PDF, imagens e Office para cinco formatos de texto ou documento, sem tamanho de ficheiro, número de páginas nem intervalo de línguas. A conversão escreve ficheiros novos; confirme o caminho primeiro. MinerU está escrito como ecossistema de base; os detalhes seguem