Guía de Inicio - Dividend Stock Scanner
Inicio en 3 Pasos
Paso 1: Instalar (5 minutos)
Windows:
# Haz doble clic en [Link]
Linux/macOS:
chmod +x [Link]
./[Link]
Paso 2: Ejecutar Menú Principal (30 segundos)
Windows:
# Haz doble clic en [Link]
Linux/macOS:
./[Link]
Paso 3: Seleccionar Opción
1. 🔍 Buscar automáticamente acciones con dividendos
2. 📊 Analizar acciones y generar reporte
3. ⚙️ Configurar acciones manualmente
4. 📖 Ver documentación
5. ❌ Salir
🎯 Flujo Recomendado
Opción A: Búsqueda Automática (Recomendado)
1. Ejecuta [Link] (Windows) o ./[Link] (Linux/macOS)
2. Selecciona opción 1: "Buscar automáticamente acciones"
3. Espera a que termine (2-5 minutos)
4. Selecciona "Sí" para analizar las acciones encontradas
5. Abre el reporte Excel en la carpeta reports/
Ventajas:
● ✅ Busca automáticamente en internet
● ✅ Encuentra acciones con dividendos
● ✅ Genera reporte automáticamente
● ✅ Fácil y rápido
Opción B: Análisis Manual
1. Edita [Link] con tus acciones favoritas
2. Ejecuta [Link] (Windows) o ./[Link] (Linux/macOS)
3. Selecciona opción 2: "Analizar acciones"
4. Espera a que termine
5. Abre el reporte Excel
Ventajas:
● ✅ Control total sobre qué acciones analizar
● ✅ Más rápido si ya sabes qué acciones quieres
📊 ¿Qué Hace Cada Opción?
1 Buscar Automáticamente (stock_finder.py)
1️⃣
Busca en internet:
● S&P 500 con dividendos
● Acciones de alto rendimiento
● NASDAQ con dividendos
● Dividend Aristocrats
Verifica:
● Que tengan historial de dividendos
● Calcula el rendimiento (yield)
● Filtra por rendimiento mínimo
Resultado:
● Actualiza [Link] automáticamente
● Listo para analizar
2️⃣Analizar Acciones (dividend_scanner.py)
Analiza:
● Dividendos anuales, semestrales, trimestrales, mensuales
● Rendimiento de dividendos (%)
● Frecuencia de pagos
● Último dividendo pagado
Genera:
● Resumen en consola (Top 10)
● Reporte Excel profesional
● Archivo de caché para futuras ejecuciones
3️⃣Configurar Manualmente
Edita [Link]:
{
"tickers": [
"AAPL",
"MSFT",
"JNJ",
"TUS_ACCIONES"
]
}
Luego ejecuta:
● Opción 2 para analizar
📁 Archivos Principales
Archivo Descripción
[Link] Menú principal interactivo
stock_finder.py Busca acciones en
internet
dividend_scanner.p Analiza dividendos
y
[Link] Configuración (acciones)
[Link] / [Link] Inicia el menú
[Link] / Instalador
[Link]
🔍 Stock Finder - Búsqueda Automática
¿Cómo Funciona?
1. Busca en múltiples fuentes:
○ S&P 500
○ Acciones de alto rendimiento
○ NASDAQ
○ Dividend Aristocrats
2. Verifica cada acción:
○ Descarga datos de Yahoo Finance
○ Calcula el rendimiento
○ Filtra por criterios
3. Actualiza [Link]:
○ Guarda las acciones encontradas
○ Listo para analizar
Ejemplo de Ejecución
🔍 STOCK FINDER - Búsqueda Automática
📡 Buscando en S&P 500 Dividends...
📡 Buscando en High Yield Stocks...
📡 Buscando en NASDAQ Dividends...
📡 Buscando en Dividend Aristocrats...
✓ Se encontraron 150 acciones con dividendos
🔎 Verificando y filtrando acciones...
🎯 ACCIONES CON DIVIDENDOS ENCONTRADAS
Total encontradas: 120
Top 20 por rendimiento:
1. O - Realty Income Corporation | Yield: 4.87%
2. MAIN - Main Street Capital | Yield: 5.01%
...
✓ Búsqueda completada exitosamente!
📊 Dividend Scanner - Análisis
¿Qué Genera?
1. Resumen en Consola:
○ Top 10 acciones por rendimiento
○ Información detallada de cada una
2. Reporte Excel:
○ Tabla profesional con 13 columnas
○ Datos ordenados por rendimiento
○ Estilos y formatos aplicados
○ Ubicación: reports/dividend_report_YYYYMMDD_HHMMSS.xlsx
3. Caché:
○ Datos almacenados para futuras ejecuciones
○ Ubicación: cache/
💡 Consejos de Uso
Primer Uso
1. Ejecuta Stock Finder para buscar automáticamente
2. Revisa las acciones encontradas
3. Analiza con Dividend Scanner
4. Abre el reporte Excel
Uso Regular
1. Ejecuta Dividend Scanner (más rápido con caché)
2. Revisa el reporte
3. Compara con reportes anteriores
Personalización
1. Edita [Link]
2. Agrega/elimina acciones
3. Ejecuta Dividend Scanner
🆘 Problemas Comunes
❌ "Entorno virtual no encontrado"
# Ejecuta el instalador
[Link] # Windows
./[Link] # Linux/macOS
❌ "Error de conexión"
● Verifica tu conexión a Internet
● Intenta más tarde (servidores pueden estar saturados)
❌ "Algunas acciones no tienen dividendos"
● Esto es normal
● Stock Finder solo muestra acciones con dividendos
● Algunas acciones de crecimiento no pagan dividendos
❌ "El reporte Excel no se abre"
● Instala Excel, LibreOffice o usa Google Sheets
● Intenta abrir con otro programa
📈 Ejemplos de Uso
Ejemplo 1: Búsqueda Completa (Recomendado)
# 1. Instalar
[Link] # Windows
# 2. Ejecutar menú
[Link] # Windows
# 3. Seleccionar opción 1 (Buscar automáticamente)
# 4. Esperar a que termine
# 5. Seleccionar "Sí" para analizar
# 6. Abrir reporte en reports/
Ejemplo 2: Análisis Rápido
# 1. Editar [Link] con tus acciones
# 2. Ejecutar menú
[Link] # Windows
# 3. Seleccionar opción 2 (Analizar)
# 4. Abrir reporte
Ejemplo 3: Búsqueda + Análisis
# 1. Ejecutar Stock Finder
python stock_finder.py
# 2. Ejecutar Dividend Scanner
python dividend_scanner.py
# 3. Abrir reporte
🎓 Aprende Más
Documentación Disponible
● QUICK_START.md - Inicio en 30 segundos
● [Link] - Guía completa
● INSTALLATION_GUIDE.md - Instalación detallada
● [Link] - Solución de problemas
● ADVANCED_USAGE.md - Uso programático
● PROJECT_SUMMARY.md - Resumen técnico
Acciones Recomendadas
Dividendos Altos:
● O (Realty Income) - 4.87%
● MAIN (Main Street Capital) - 5.01%
● ARCC (Ares Capital) - 5.50%
Empresas Grandes:
● AAPL (Apple)
● MSFT (Microsoft)
● JNJ (Johnson & Johnson)
Servicios Públicos:
● NEE (NextEra Energy)
● DUK (Duke Energy)
● SO (Southern Company)
🚀 Próximos Pasos
1. Instala la aplicación (5 minutos)
2. Ejecuta Stock Finder (2-5 minutos)
3. Analiza los resultados (1 minuto)
4. Abre el reporte Excel (Inmediato)
5. Personaliza según tus necesidades
📞 Necesitas Ayuda?
1. Lee QUICK_START.md - Inicio rápido
2. Consulta [Link] - Guía completa
3. Revisa [Link] - Problemas comunes
4. Ejecuta [Link] - Menú interactivo