Ejemplos de la API de Perplexity Sonar

¡Bienvenido a la colección de Ejemplos de la API de Perplexity Sonar! Estas son aplicaciones listas para producción que demuestran casos de uso reales de la API de Sonar.

🚀 Inicio Rápido

Navega a cualquier directorio de ejemplo y sigue las instrucciones en el archivo README.md.

📋 Ejemplos Disponibles

🔍 CLI de Verificador de Hechos

Propósito: Verificar afirmaciones y artículos para su precisión factual
Tipo: Herramienta de línea de comandos
Casos de Uso: Periodismo, investigación, verificación de contenido

Características Clave:

• Análisis estructurado de afirmaciones con calificaciones
• Citación de fuentes y seguimiento de evidencia
• Salida JSON para automatización
• Flujo de trabajo profesional de verificación de hechos

Inicio Rápido:

cd fact-checker-cli/
python fact_checker.py --text "The Earth is flat"

🤖 Bot de Conocimiento Diario

Propósito: Sistema automatizado de entrega diaria de hechos
Tipo: Aplicación Python programada
Casos de Uso: Educación, boletines, aprendizaje personal

Características Clave:

• Rotación de temas basada en el calendario
• Almacenamiento persistente de hechos
• Programación configurable
• Generación de contenido educativo

Inicio Rápido:

cd daily-knowledge-bot/
python daily_knowledge_bot.py

🏥 Aplicación de Información sobre Enfermedades

Propósito: Búsqueda interactiva de información médica
Tipo: Aplicación web (HTML/JavaScript)
Casos de Uso: Educación para la salud, referencia médica, información para pacientes

Características Clave:

• Interfaz interactiva de navegador
• Tarjetas de conocimiento médico estructuradas
• Seguimiento de citas para fuentes médicas
• Lista para despliegue independiente

Inicio Rápido:

cd disease-qa/
jupyter notebook disease_qa_tutorial.ipynb

📊 Rastreador de Noticias Financieras

Propósito: Monitoreo de noticias financieras en tiempo real y análisis de mercado
Tipo: Herramienta de línea de comandos
Casos de Uso: Investigación de inversiones, monitoreo de mercado, periodismo financiero

Características Clave:

• Agregación de noticias financieras en tiempo real
• Análisis de sentimiento del mercado (Alcista/Bajista/Neutral)
• Evaluación de impacto y análisis sectorial
• Perspectivas y recomendaciones de inversión

Inicio Rápido:

cd financial-news-tracker/
python financial_news_tracker.py "tech stocks"

📈 Informe de Investigación de Renta Variable

Propósito: Generar informes de investigación de renta variable de grado institucional para cualquier ticker público
Tipo: Herramienta de línea de comandos
Casos de Uso: Flujos de trabajo de inversores, análisis fundamental, preparación de ganancias, evaluación comparativa de pares

Características Clave:

• Utiliza la herramienta finance_search incorporada de la Agent API para fundamentos estructurados
• Tres configuraciones preestablecidas (cotización en vivo, empresa única, investigación de varios pasos)
• Cita las URL de fuentes financieras de Perplexity junto con el informe
• Reporta el recuento de invocaciones finance_search y el costo total de la solicitud

Inicio Rápido:

cd equity-research-brief/
python equity_research_brief.py NVDA

📚 Buscador de Investigación Académica

Propósito: Descubrimiento y resumen de literatura académica
Tipo: Herramienta de investigación de línea de comandos
Casos de Uso: Investigación académica, revisiones de literatura, trabajo académico

Características Clave:

• Priorización de fuentes académicas
• Extracción de citas de artículos con enlaces DOI
• Prompting enfocado en la investigación
• Integración de flujo de trabajo académico

Inicio Rápido:

cd research-finder/
python research_finder.py "quantum computing advances"

🔑 Configuración de la Clave API

Todos los ejemplos requieren una clave API de Perplexity. Puedes configurarla de varias maneras:

Variable de Entorno (Recomendado)

export PPLX_API_KEY="your-api-key-here"

Archivo .env

Crea un archivo .env en el directorio del ejemplo:

PERPLEXITY_API_KEY=your-api-key-here

Argumento de Línea de Comandos

python script.py --api-key your-api-key-here

🛠️ Requisitos Comunes

Todos los ejemplos requieren:

• Python 3.7+
• Clave API de Perplexity (Obtén una aquí)
• Conexión a Internet para llamadas a la API

Los requisitos adicionales varían según el ejemplo y se enumeran en cada archivo requirements.txt.

🎯 Eligiendo el Ejemplo Correcto

🤝 Contribuciones

¿Encontraste un error o quieres mejorar un ejemplo? ¡Agradecemos las contribuciones!

1. Reportar Problemas: Abre un issue describiendo el problema
2. Sugerir Funciones: Propón nuevas funcionalidades o mejoras
3. Enviar Código: Haz un fork, implementa y envía una solicitud de extracción (pull request)

Consulta nuestras Pautas de Contribución para más detalles.

📄 Licencia

Todos los ejemplos están bajo la Licencia MIT.

¿Listo para explorar? ¡Elige un ejemplo de arriba y empieza a construir con la API Sonar de Perplexity! 🚀