Tweemol

Robô que publica, todos os dias, uma molécula no Twitter contendo as informações extraídas da Wikipédia, um link e a imagem.
Acessar » · Entrar em contato

Warning

PROJETO ARQUIVADO

Este projeto não recebe manutenção há mais de 5 anos e foi oficialmente arquivado. O repositório e seu código-fonte são mantidos abertos apenas para fins de registro histórico e portfólio. Funcionalidades que dependem de serviços de terceiros (especialmente a API do Twitter e Algorithmia) muito provavelmente não funcionam mais devido a mudanças nas políticas e versões dessas plataformas ao longo dos anos. Issues e Pull Requests foram desabilitados e não serão monitorados.

Índice

• Sobre o Projeto
  • Motivação
  • Feito com
• Começando
  • Pré-requisitos
  • Configurando o ambiente
• Uso
• Licença
• Contato

Sobre o Projeto

Tweemol é um robô desenvolvido por Héliton Martins em Node.js que, todos os dias, escolhe uma molécula de interesse farmacológico e publica um Tweet com sua estrutura, informações e link para a Wikipédia. Isso é feito através de uma busca na Wikipédia seguida do resumo do texto. A imagem é obtida da Wikipédia ou Google Images, nesta ordem de prioridade. O robô, então, de posse de um texto de tamanho adequado para o Twitter e de uma imagem também adequada, publica esse conjunto de informações em @Tweemol no Twitter.

Motivação

Este projeto teve como principal objetivo o meu estudo pesosal do ambiente Node.js e utilização de APIs. Sou programador auto-didata e apaixonado pela programação. Assim, acredito que a melhor forma de estar sempre "em forma", isto é, alinhado com as novidades do mundo tecnológico, é desenvolvendo projetos pessoais que traduzam bem o instinto programador: resolver todos os problemas possíveis através de automação.

Antes de desenvolver este projeto, recebi grande influência do projeto open-source do youtuber Filipe Deschamps e também do @bot_RU_UFMG, robô desenvolvido por Vitor Mafra e que publica no Twitter o cardápio diário do Restaurante Universitário (bandejão) da UFMG, universidade na qual também estudo.

Feito com

Este projeto foi desenvolvido com:

Linguagem/Tecnologia:

• Node.js

Dependências:

• Axios · requisições GET
• Node-fetch · requisições POST
• Sentence-Boundary-Detection (SBD) · detecção de frases
• Sharp · conversão de imagens
• Twit · implementação em Node.js da API do Twitter
• Twitter-Text · contagem precisa de caracteres

APIs:

• Algorithmia
  • nlp/Summarizer · resumo de textos
• Google Custom Search API · busca de imagens
• Twitter Standard API · publicação de Tweets

Serviços

• Heroku · hospedagem e execução programada

Começando

Para reutilizar o projeto, seja para contribuir enviando um Pull-Request, ou para usar em seu projeto pessoal, veja a seguir o que será necessário.

Pré-Requisitos

Você precisará ter pré-instalado:

• Node.js (> 10.16.3*)
• npm (> 6.14.5*)
• Git

* Versões inferiores não testadas.

Configurando o ambiente

1. Clone o repositório utilizando git clone.

git clone [email protected]:hellmrf/Tweemol.git

2. Instale as dependências.

cd Tweemol
npm install

3. Consiga uma conta de desenvolvedor do Twitter. ㅤ Para evitar a utilização inadequada das APIs, o Twitter fará uma verificação das suas inteções antes de aprovar sua conta. Isso pode demorar algumas horas. Acesse o Twitter Developer ou clique aqui para aplicar para o acesso. Detalhe o máximo possível suas intenções. Com a conta de desenvolvedor criada, crie um app. ㅤ

4. O projeto está quase completamente configurado, exceto pelas chaves de API que serão necessárias e que deverão estar corretamente configuradas dentro de /credentials/. Para ver as instruções detalhadas para consegui-las, acesse este arquivo.

Uso

Após tudo devidamente configurado, basta executar o arquivo de entrada do projeto.

node index.js

Licença

Distribuido sob Licença GPL-3.0.

As permissões estão condicionadas à disponibilização do código-fonte completo das obras licenciadas e suas modificações, o que inclui obras maiores que utilizem uma obra licenciada, sob a mesma licença. Os avisos de direitos autorais e de licença devem ser preservados. Os contribuidores fornecem uma concessão expressa de direitos de patente.

Permissões	Condições	Limitações
✅ Uso comercial	ℹ️ Divulgar o código-fonte	❌ Responsabilidade corporativa
✅ Distribuição	ℹ️ Aviso de licença e direitos autorais	❌ Garantia
✅ Modificação	ℹ️ Mesma licença
✅ Uso de patente	ℹ️ Declarar alterações
✅ Uso privado

Ver a GNU General Public License v3.0 completa »

Contato

Heliton Martins - hellmrf.dev.br - [email protected] - WhatsApp

Link do projeto: https://github.com/hellmrf/Tweemol/