<!-- README.md is generated from README.Rmd. Please edit that file -->

TweetScraperR<img src="man/figures/hex-twitterscraper.svg" align="right" height="320"/>

<!-- badges: start -->

<!-- badges: end -->

Vision general

Este paquete proporciona funciones para extraer datos de X/Twitter, incluidos tweets, usuarixs y metadatos asociados, permitiendo realizar la extracción y manejo de estos datos de manera conveniente en R. Enfocado en facilitar la recolección de datos para análisis y visualización, el paquete puede obtener tweets desde la búsqueda de X/Twitter y está construido sobre rvest, sin utilizar las API de X/Twitter. Aunque los datos rastreados no son tan limpios como los obtenidos a través de las API, el costo actual de las API hace que esta sea una alternativa flexible, gratuita y de código abierto.

This package provides functions to extract data from X/Twitter, including tweets, users, and associated metadata, allowing for convenient data extraction and handling in R. Focused on facilitating data collection for analysis and visualization, the package can obtain tweets from X/Twitter search and is built on rvest, without using the X/Twitter APIs. Although the scraped data is not as clean as that obtained through the APIs, the current cost of the APIs makes this a flexible, free, and open-source alternative.

Instalacion de la version en desarrollo

Puedes instalar la versión de desarrollo de TweetScraperR desde GitHub con:

# install.packages("devtools")
devtools::install_github("agusnieto77/TweetScraperR")

Funciones

| Nombre | Ciclo | Descripción | |:---|:---|:---| | closeTimeline() | | Cierre de Timeline. | | closeTwitter() | | Cierre de sesión. | | extractTweetsData() | | Extrae información relevante de tweets almacenados localmente. | | getScrollExtract() | | Scrolea y extrae tweets. | | getScrollExtractUrls() | | Scrolea y extrae URLs de tweets. | | getTweetsCites() | | Recupera las citas de un tweet a partir de su URL. | | getTweetsData() | | Recupera datos de tweets a partir de URLs. | | getTweetsData2() | | Recupera datos de tweets a partir de URLs. | | getTweetsFullSearch() | | Recupera tweets desde la búsqueda avanzada. | | getTweetsHashtags() | | Recupera los hashtags de la columna 'texto'. | | getTweetsHistoricalHashtag() | | Recupera tweets históricos con un hashtag específico. | | getTweetsHistoricalHashtagFor() | | Recupera tweets históricos con un hashtag específico en un ciclo for. | | getTweetsHistoricalSearch() | | Recupera tweets históricos con un término específico. | | getTweetsHistoricalSearchFor() | | Recupera tweets históricos con un término específico en un ciclo for. | | getTweetsHistoricalTimeline() | | Recupera tweets históricos de un timeline. | | getTweetsHistoricalTimelineFor() | | Recupera tweets históricos de un timeline en un ciclo for. | | getTweetsImages() | | Descarga las imágenes posteadas en los tweets. | | getTweetsImagesAnalysis() | | Analiza las imágenes posteadas en los tweets. | | getTweetsReplies() | | Recupera las respuesta a un tweet desde su URL. | | getTweetsRetweets() | | Recupera los usuarios que rt un tweet desde su URL. | | getTweetsSearchStreaming() | | Recupera tweets en tiempo real. | | getTweetsSearchStreaming2() | | Recupera tweets en tiempo real. | | getTweetsSearchStreamingFor() | | Itera la recuperación de tweets en tiempo real. | | getTweetsSearchStreamingFor2() | | Itera la recuperación de tweets en tiempo real. | | getTweetsSentiments() | | Analizador de sentimientos. | | getTweetsTimeline() | | Recupera tweets de un timeline. | | getUrlsHistoricalTimeline() | | Recupera URLs de tweets históricos de un timeline. | | getUrlsSearchStreaming() | | Recupera URLs de tweets en tiempo real. | | getUrlsTweetsCites() | | Recupera las URLs de las citas de un tweet. | | getUrlsTweetsReplies() | | Recupera las URLs de las respuestas a un tweet. | | getUrlsTweetsSearch() | | Recupera URLs de tweets por búsqueda. | | getUrlsTweetsTimeline() | | Recupera URLs de tweets de un timeline. | | getUsersData() | | Recupera datos de users a partir de URLs. | | getUsersFullData() | | Recupera datos completos de users a partir de URLs. | | HTMLImgReport() | | Crea una visualización HTML interactiva de imágenes analizadas. | | openTimeline() | | Accede al Timeline de un/a usuario/a. | | openTwitter() | | Inicio de sesión. | | passTwitter() | | Función de login, completa el campo pass. | | plotEmojis() | | Hace un gráfico de barras en base a la columna 'emoticones'. | | plotEmojisPNG() | | Hace un gráfico de barras en base a la columna 'emoticones' con los PNG de los emojis. | | plotTime() | | Hace un gráfico de líneas en base a la columna 'texto'. | | plotWords() | | Hace una nube de palabras en base a la columna 'texto'. | | userTwitter() | | Función de login, completa el campo user. |

Uso de las funciones del paquete {TweetScraperR}

# Cargamos la librería
require(TweetScraperR)

# Con la función getTweetsSearchStreaming() recolectamos en tiempo real los  
# tweets que mencionan el término de búsqueda, en este ejemplo es un hashtag.
# Esta función guarda un rds con los tweets y algunos metadatos.

urls_hashtagRstats <- getTwee