pensador-api

Um pacote Node.js para buscar frases do Pensador.com.

Instalação

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

Uso

const pensador = require("pensador-api");

// Buscar frases por termo
const result = await pensador({ term: "Fernando Pessoa", max: 3 });

// Buscar frases curtas (padrão, sem term)
const result = await pensador({ max: 5 });

Nota: a função é assíncrona — use async/await ou Promises.

Exemplo de retorno

{
  "total": 3,
  "searchTerm": "frases_de_fernando_pessoa",
  "phrases": [
    {
      "author": "Fernando Pessoa",
      "text": "Não sou nada. Nunca serei nada. Não posso querer ser nada."
    },
    {
      "author": "Fernando Pessoa",
      "text": "A arte é a expressão da nossa experiência real."
    },
    {
      "author": "Fernando Pessoa",
      "text": "Tudo vale a pena se a alma não é pequena."
    }
  ]
}

Opções

| Opção | Tipo | Obrigatório | Padrão | Descrição | | ------ | ------- | ----------- | --------------- | ---------------------------------------------------------------------------------------- | | term | string | não | frases_curtas | Autor ou tema a pesquisar. O prefixo "frases de" é adicionado automaticamente. | | max | integer | não | sem limite | Número máximo de frases a retornar. Omita para buscar todas as disponíveis para o termo. |

Resposta

| Campo | Tipo | Descrição | | ------------ | ------- | --------------------------------------------------------- | | total | integer | Quantidade de frases retornadas. | | searchTerm | string | Slug utilizado na busca (gerado a partir do term). | | phrases | array | Lista de objetos com author (string) e text (string). |

⚠️ Disclaimer

Este pacote funciona fazendo scraping do site Pensador.com. Por isso:

• O funcionamento depende inteiramente da disponibilidade e da estrutura HTML do Pensador.com. Mudanças no site podem quebrar o pacote.
• O uso deste pacote está sujeito aos Termos de Uso do Pensador.com. Consulte-os antes de utilizar em produção.
• Este pacote não é oficial e não é mantido nem afiliado ao Pensador.com.
• Use com responsabilidade: evite requisições excessivas que possam sobrecarregar o serviço.

Licença

MIT