pensador-promise

📦 pensador-promise

Biblioteca para extrair frases do Pensador via Web Scraping

📦 Instalação

npm install pensador-promise
# ou
yarn add pensador-promise

🚀 Uso

import pensador from 'pensador-promise';

async function buscarFrases(termo: string, max: number = 5) {
  try {
    const resultado = await pensador({ term: termo, max });
    return resultado;
  } catch (erro) {
    console.error('Erro ao buscar frases:', erro);
    throw erro;
  }
}

// Buscar uma frase aleatória
import { randomPhrase } from 'pensador-promise';

async function buscarFraseAleatoria() {
  try {
    const frase = await randomPhrase();
    console.log(`"${frase.text}" - ${frase.author}`);
  } catch (erro) {
    console.error('Erro ao buscar frase aleatória:', erro);
  }
}

Exemplo de Retorno

Busca normal

{
  "searchTerm": "albert_einstein",
  "total": 2,
  "phrases": [
    {
      "author": "Albert Einstein",
      "text": "A imaginação é mais importante que o conhecimento."
    },
    {
      "author": "Albert Einstein",
      "text": "Duas coisas são infinitas: o universo e a estupidez humana."
    }
  ]
}

Frase aleatória

{
  "author": "William Shakespeare",
  "text": "Ser ou não ser, eis a questão."
}

🔧 API

Opções

Parâmetro	Tipo	Descrição	Obrigatório
term	string	Termo de busca para as frases	Sim
max	number	Número máximo de frases para retornar	Sim

Retorno

Campo	Tipo	Descrição
searchTerm	string	Termo de busca formatado
total	number	Total de frases encontradas
phrases	Array	Lista de frases encontradas

🤝 Contribuindo

1. Fork o projeto
2. Crie sua branch de feature (git checkout -b feature/MinhaFeature)
3. Commit suas mudanças (git commit -m 'Adiciona MinhaFeature')
4. Push para a branch (git push origin feature/MinhaFeature)
5. Abra um Pull Request

Veja o arquivo CONTRIBUTING.md para mais detalhes.

📝 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE.md para mais detalhes.