Trendings
Repositório do módulo scrapper para obtenção de trendings do Twitter.
Install / Use
/learn @KillovSky/TrendingsREADME
Introdução
- Detalhes importantes que estão em outros arquivos:
- Reportar segurança, problemas e demais
- Contribuir com o código
- Ver o código de conduta
- Ver a changelog
- Ver mais projetos
- Fazer uma donate
O que este módulo faz?
- Este módulo utiliza o site Trends24 para obter as trends atuais do X (Twitter) sem a necessidade de módulos como
cheerio,puppeteerou instalação adicional de outros módulos e sistemas.
Instalação:
- Rode o código abaixo para instalar via
NPM:
$ npm i @killovsky/trendings
- Rode o código abaixo para instalar via
GIT:
$ git clone https://github.com/KillovSky/Trendings.git
O que este módulo tem de especial?
- Assim como o da NASA, muitas coisas, confira abaixo:
Neste módulo, os erros não afetam o funcionamento, o que significa que apesar de qualquer erro, os valores 'sempre' estarão lá para que você não seja afetado.
Os erros serão inseridos na resposta com uma explicação sobre o que causou eles, facilitando para você entender.
Os headers estão inseridos na resposta, facilitando para saber detalhes que podem lhe ser uteis.
Não existem dependências de módulos de terceiro, tudo é feito usando o puro
Node.js.Cada linha do código possui uma explicação do que está rodando ou vai rodar, ou seja, o código INTEIRO é explicado, linha por linha.
As trends são automaticamente formatadas em ordem decrescente [130, 129, 128...] de acordo com a quantidade de tweets feitos.
Os sistemas são como um jogo de exploração, eles podem ser usados de infinitas formas, como um sandbox, divirta-se!
E muitas outras coisas, confira o código para entender!
Como testar este módulo:
- Basta abrir um terminal na pasta do módulo e digitar:
$ npm test
- Ou acessar isso: NpmJS Runkit - KillovSky@Trendings
Como utilizar este módulo:
- Existem diversas formas de utilizar, mas como se trata de um script que faz uso de
Promises, irei dar dois exemplos que funcionam bem, lembrando, você pode rodar sem especificar nada pois também funciona desta forma. - Clique em uma das linhas/setas abaixo para exibir os detalhes!
- Clique aqui para ver detalhes do ambiente de código e suas funções.
/* Função responsável por todo o código */
info('local')
/* ------------------------------------- *
* 1° - Local
* Valores: string
* Padrão: 'worldwide'
* Locais: "brazil, worldwide, italy..."
* Test Mode: "TEST#TICKET"
* FUNÇÃO ASYNC/PROMISE, USE AWAIT!
* ------------------------------------- */
/* Retorna o valor padrão e detalhes do erro */
fail('Error')
/* Retorna o resultado e roda funções adicionais */
dump('*')
/* Reseta o ambiente dos códigos */
reset()
/* Retorna a package JSON */
packs()
/* Retorna o ambiente de códigos */
env()
/* Usando .then | Modo de uso padrão */
const trendings = require('@killovsky/trendings');
trendings.info('LOCAL').then(data => {
/* Faça seu código baseado na object 'data' aqui */
/* Exemplo: console.log(data); */
})
/* Usando await [async] | Modo de uso padrão */
const trendings = require('@killovsky/trendings');
const data = await trendings.info('LOCAL');
/* Faça seu código aqui usando a const 'data' */
/* Exemplo: console.log(data); */
/* Código usando .then */
const trendings = require('@killovsky/trendings');
trendings.info('brazil').then(data => console.log(data));
/* Código usando await */
const trendings = require('@killovsky/trendings');
const data = await trendings.info('brazil');
console.log(data);
/* Se você não sabe criar uma função async ou ainda não tiver uma, use este código abaixo: */
(async () => {
/* Cole um código com await aqui dentro */
})();
{
"date": "String | Data [YYYY-MM-DD HH:MM:SS]",
"error": "Boolean | Determina se houve erro no request",
"dev_msg": "String / Boolean | Mensagem adicional de erro",
"error_msg": "String / false | Mensagem de erro do request",
"code": "Number | String | Código de erro HTTP",
"nodeDetails": {
"isError": "Boolean | Determina se houve erro no Node",
"code": "Number / Boolean | Código de erro do Node",
"message": "String / Boolean | Detalhes da mensagem de erro"
},
"explain": {
"code": "Number / String | Código escrito de HTTP",
"why": "String | Explicação do código HTTP"
},
"headers": {
"date": "String | Data escrita da requisição",
"content-type": "String | Tipo de resposta",
"content-length": "Number | Tamanho da resposta",
"Outros": "E vários outros headers, faça uma requisição para obter todos"
},
"tweet": [
{
"url": "String | URL da Trending",
"trend": "String | Assunto do momento",
"count": "String | Quantidade de tweets simplificada",
"countraw": "String | Quantidade de tweets em números inteiros"
}
]
}
{
"date":"22/07/2024, 22:22:00",
"error":false,
"dev_msg":false,
"error_msg":false,
"code":200,
"nodeDetails":{
"isError":false,
"code":false,
"message":false
},
"explain":{
"code":"OK",
"why":"The request is OK, this response depends on the HTTP method used."
},
"headers":{
"connection":"close",
"date":"Tue, 23 Jul 2024 00:46:26 GMT",
"last-modified":"Tue, 23 Jul 2024 00:46:26 GMT"
},
"tweet":[
{
"url": "https://twitter.com/search?q=Trump",
"trend": "Trump",
"count": "6.7M",
"countraw": "6686521"
}
]
}
Perguntas e Respostas:
- Isso é bem similar ao seu módulo do Projeto APOD da NASA, não é?
Sim, é por que quero criar sistemas fáceis de entender e usar, decidi que a melhor forma seria fazendo eles de forma similar, deixando o código bem simples para qualquer um que vier de outros projetos meus.
- Por que não utiliza o
cheeriooupuppeteerem vez desse sistema?
Related Skills
gh-issues
352.9kFetch GitHub issues, spawn sub-agents to implement fixes and open PRs, then monitor and address PR review comments. Usage: /gh-issues [owner/repo] [--label bug] [--limit 5] [--milestone v1.0] [--assignee @me] [--fork user/repo] [--watch] [--interval 5] [--reviews-only] [--cron] [--dry-run] [--model glm-5] [--notify-channel -1002381931352]
node-connect
352.9kDiagnose OpenClaw node connection and pairing failures for Android, iOS, and macOS companion apps
oracle
352.9kBest practices for using the oracle CLI (prompt + file bundling, engines, sessions, and file attachment patterns).
taskflow-inbox-triage
352.9kname: taskflow-inbox-triage description: Example TaskFlow authoring pattern for inbox triage. Use when messages need different treatment based on intent, with some routes notifying immediately, some w
