Habilidade de Gerador de Capa de Blog
Esta habilidade fornece aos agentes de IA a capacidade de gerar imagens de capa de blog impressionantes, minimalistas e técnicas usando o blog-cover-image-cli. O CLI aproveita o Gemini 3.1 Flash Image Preview, busca automaticamente logotipos de marcas a partir de domínios, usa imagens de referência estética locais e emprega ancoragem do Google Search para injetar contexto em tempo real.
Configuração
Pré-requisitos do Agente:
Antes de usar esta ferramenta, verifique se ela está instalada. Se blog-cover-cli --help falhar, instale-a globalmente:
npm install -g blog-cover-image-cli
Se o usuário quiser que você gere uma imagem e você ainda não configurou a chave de API, primeiro você deve configurar o CLI usando uma chave de API Gemini. O CLI armazena isso de forma segura via pacote conf.
# 1. Defina sua Chave de API Gemini (Obrigatória para geração de imagem)
npx -p blog-cover-image-cli blog-cover-cli config set-key <SUA_CHAVE_DE_API_GEMINI>
# 2. Defina seu ID de Cliente Brandfetch (Obrigatório para buscar logotipos em alta resolução)
npx -p blog-cover-image-cli blog-cover-cli config set-brandfetch-id <SEU_ID_DE_CLIENTE_BRANDFETCH>
# Verifique suas chaves (mascaradas)
npx -p blog-cover-image-cli blog-cover-cli config get-key
npx -p blog-cover-image-cli blog-cover-cli config get-brandfetch-id
Uso: Gerando uma Imagem
Quando um usuário solicitar uma imagem de capa (por exemplo, "Crie uma imagem de capa para meu blog sobre Vercel v0"), você deve usar o comando generate.
npx -p blog-cover-image-cli blog-cover-cli generate -t "O Título do Post do Blog" -l "exemplo.com"
Argumentos
-t, --title <texto>: (Obrigatório) O texto do título a ser exibido na imagem de capa. Não use títulos excessivamente longos (mantenha abaixo de 3 linhas de texto visualmente).-l, --logo <domínio>: (Opcional, mas recomendado) O domínio para buscar o logotipo da marca (por exemplo,vercel.com,google.com,cursor.com). O CLI converte automaticamente WebP/SVG/AVIF para PNG para compatibilidade.-o, --output <caminho>: (Opcional) O caminho do arquivo onde a imagem gerada será salva. Se omitido, o CLI a salva automaticamente em um diretóriooutput/na pasta de trabalho atual (por exemplo,./output/vercel-capa.png).
Exemplos
Exemplo 1: Cursor
npx -p blog-cover-image-cli blog-cover-cli generate -t "Por que o Cursor é o Editor de Código de IA Definitivo" -l "cursor.com"
Exemplo 2: Lovable
npx -p blog-cover-image-cli blog-cover-cli generate -t "Construindo Aplicativos em Minutos com Lovable" -l "lovable.dev"
Exemplo 3: Caminho de Saída Personalizado
npx -p blog-cover-image-cli blog-cover-cli generate -t "Dominando React em 2026" -l "reactjs.org" -o "./assets/react-capa.png"
Como Funciona Internamente
Como agente, você deve saber o que o CLI está fazendo para informar o usuário:
- Busca de Logotipo: Ele busca logotipos do
Brandfetche os processa viasharp. - Referências: Ele carrega imagens de referência selecionadas do diretório
examples/para garantir que a saída seja sempre um fundo branco limpo e minimalista com tipografia ousada. - Ancoragem: Ele tem ferramentas
googleSearchhabilitadas, o que significa que se o título estiver relacionado a um evento recente, o Gemini pode pesquisá-lo antes de gerar a imagem. - Imposição de Texto: Ele força o Gemini a gerar a string exata do título usando regras de posicionamento tipográfico.
Casos de Borda / Solução de Problemas
- Erro de Chave de API Ausente: Se você vir um erro de chave de API, execute o comando
config set-key. - Aviso de Busca de Logotipo: Se o CLI disser
Warning: Could not fetch logo, ele ainda gerará a imagem, mas sem o logotipo. Você não precisa travar ou parar. - Limites de Modalidade Estritos: Devido ao uso dos modelos de imagem experimentais do Gemini, a geração pode ocasionalmente falhar devido a filtros de segurança rigorosos. Se isso acontecer, notifique o usuário.