https://github.com/murapadev/populpy
Fetch related searches for a given query from Google Trends, and for each related search, it retrieves the date it was most popular and its popularity score
https://github.com/murapadev/populpy
google query searchs trends
Last synced: 22 days ago
JSON representation
Fetch related searches for a given query from Google Trends, and for each related search, it retrieves the date it was most popular and its popularity score
- Host: GitHub
- URL: https://github.com/murapadev/populpy
- Owner: murapadev
- License: mit
- Created: 2023-07-20T12:19:12.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-03-12T01:35:10.000Z (about 2 months ago)
- Last Synced: 2025-03-28T06:33:41.626Z (about 1 month ago)
- Topics: google, query, searchs, trends
- Language: Python
- Homepage:
- Size: 1.73 MB
- Stars: 9
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# PopulPy 📊
[](https://www.python.org/downloads/)
[](https://opensource.org/licenses/MIT)
[](https://streamlit.io)
Herramienta de análisis de tendencias de búsqueda con integración de múltiples motores (Google, Bing, DuckDuckGo) y visualizaciones interactivas.
## 🚀 Características
- 🔍 Búsqueda integrada con múltiples proveedores
- 📈 Análisis de tendencias temporales
- 🗺️ Visualización geográfica de interés
- ☁️ Generación de nubes de palabras
- 📊 Gráficos interactivos con Plotly
- 🎨 Temas claro/oscuro
- 💾 Historial de búsquedas
## 🛠️ Instalación
### Prerrequisitos
1. Python 3.8 o superior
2. Una cuenta de Google Cloud con acceso a la API de búsqueda personalizada
3. Una cuenta de Azure con acceso a la API de Bing
4. Una cuenta de DuckDuckGo (opcional)
### Instalación
1. Clona este repositorio:
```bash
git clone https://github.com/murapa96/populpy
cd populpy
```
2. Instala las dependencias necesarias:
```bash
pip install -r requirements.txt
```
### Configuración de Variables de Entorno
Crea un archivo `.env` en el directorio raíz con la siguiente estructura:
```
GOOGLE_API_KEY=TU_API_KEY_DE_GOOGLE
SEARCH_ENGINE_ID=TU_ID_DE_MOTOR_DE_BUSQUEDA
BING_API_KEY=TU_API_KEY_DE_BING
```
Reemplaza `TU_API_KEY_DE_GOOGLE`, `TU_ID_DE_MOTOR_DE_BUSQUEDA` y `TU_API_KEY_DE_BING` con tus credenciales correspondientes.
## 📖 Uso
### Interfaz Web (Streamlit)
Para ejecutar la interfaz web, usa el siguiente comando:
```bash
streamlit run app.py
```
### Línea de Comandos
```bash
python main.py -q "término de búsqueda" -c "código de país" -w "ruta para guardar la imagen"
```
- `-q`: Término de búsqueda.
- `-c`: Código de país (por defecto es `es`).
- `-w`: Ruta para guardar la imagen de la nube de palabras.
## 🗂️ Estructura del Proyecto
```
populpy/
├── app.py
├── main.py
├── README.md
├── requirements.txt
└── .env.example
```
## 📝 ToDo
- [ ] Añadir soporte para más proveedores de búsqueda
- [ ] Implementar exportación de datos en múltiples formatos
- [ ] Mejorar la persistencia de datos
- [ ] Añadir más visualizaciones
- [ ] Implementar caché de resultados
## 📄 Licencia
Este proyecto está bajo la Licencia MIT - ver el archivo LICENSE para más detalles.
## 👤 Autor
Pablo Ramos Muras [@Murapa96](https://github.com/Murapa96)