liyangbai-hub/skill-article-fetcher

O que skill-article-fetcher faz?

Habilidade do Codex para extrair conteúdo de artigos para Markdown ou PDF com fallback rápido para o navegador.

Descrição

Esta habilidade permite que o agente Codex extraia o conteúdo principal de um artigo da web e o converta para Markdown ou PDF. Se a extração automática falhar, um fallback rápido abre o artigo no navegador para que o conteúdo não seja perdido.

Funcionalidades

• Extrair artigo para Markdown (.md)
• Extrair artigo para PDF (.pdf)
• Fallback para fast-to-browser (abrir URL diretamente)
• Tratamento de erros e feedback claro

Como usar

Para extrair um artigo, use o seguinte formato de comando:

codex fetch-article <url> [options]

Opções

Opção	Descrição
--format markdown	(Padrão) Saída em Markdown
--format pdf	Saída em PDF
--fallback	Usar modo fallback se a extração falhar (padrão: verdadeiro)
--no-fallback	Não usar fallback
--output <arquivo>	Nome do arquivo de saída (padrão: título do artigo)
--open-browser	Sempre abrir no navegador (ignorar extração)

Exemplos

Extrair como Markdown:

codex fetch-article https://exemplo.com/artigo

Extrair como PDF:

codex fetch-article https://exemplo.com/artigo --format pdf

Especificar arquivo de saída:

codex fetch-article https://exemplo.com/artigo --output meu-artigo

Apenas abrir no navegador:

codex fetch-article https://exemplo.com/artigo --open-browser

Pré-requisitos

Para a extração automática funcionar, as seguintes ferramentas devem estar instaladas no sistema:

• curl (para baixar a página)
• pandoc (para converter HTML para Markdown/PDF)
• wkhtmltopdf (opcional, para melhor qualidade de PDF)

Se pandoc ou wkhtmltopdf não estiverem disponíveis, a habilidade recorrerá ao modo de fallback.

Fluxo de trabalho

1. O agente recebe uma URL de artigo e formato desejado
2. Tenta baixar a página com curl
3. Se bem-sucedido, extrai o conteúdo principal usando pandoc ou wkhtmltopdf
4. Salva o resultado no formato solicitado
5. Se a extração falhar, redireciona para o navegador

Tratamento de erros

• Se a URL estiver mal formatada: retorna erro 400
• Se a página não estiver acessível: tenta fallback ou retorna erro 503
• Se a conversão falhar: informa e sugere o modo fallback

Notas

• O modo fallback (--open-browser) não salva o artigo; apenas o abre para visualização manual.
• Para artigos grandes, o PDF via wkhtmltopdf pode ter melhor fidelidade que pandoc.
• Habilidade testada em ambientes Unix/Linux (macOS, Linux).

Licença

MIT