feat(docs): add Financial News Tracker example and implementation

- Introduced a new command-line tool for real-time financial news monitoring and market analysis.
- Added detailed documentation for the Financial News Tracker, including features, installation instructions, and usage examples.
- Implemented the core functionality in `financial_news_tracker.py` to fetch and analyze financial news using Perplexity's Sonar API.
- Included a requirements file for dependencies.

Author: vikvang

docs/examples/README.mdx

@@ -75,6 +75,26 @@ jupyter notebook disease_qa_tutorial.ipynb
 
 ---
 
+### 📊 [Financial News Tracker](financial-news-tracker/)
+
+**Purpose**: Real-time financial news monitoring and market analysis  
+**Type**: Command-line tool  
+**Use Cases**: Investment research, market monitoring, financial journalism  
+
+**Key Features**:
+- Real-time financial news aggregation
+- Market sentiment analysis (Bullish/Bearish/Neutral)
+- Impact assessment and sector analysis
+- Investment insights and recommendations
+
+**Quick Start**:
+```bash
+cd financial-news-tracker/
+python financial_news_tracker.py "tech stocks"
+```
+
+---
+
 ### 📚 [Academic Research Finder](research-finder/)
 
 **Purpose**: Academic literature discovery and summarization  
@@ -129,6 +149,7 @@ Additional requirements vary by example and are listed in each `requirements.txt
 | Verify information accuracy | **Fact Checker CLI** |
 | Learn something new daily | **Daily Knowledge Bot** |
 | Look up medical information | **Disease Information App** |
+| Track financial markets | **Financial News Tracker** |
 | Research academic topics | **Academic Research Finder** |
 
 ## 🤝 Contributing

docs/examples/financial-news-tracker/README.mdx

@@ -0,0 +1,282 @@
+---
+title: Financial News Tracker
+description: A real-time financial news monitoring tool that fetches and analyzes market news using Perplexity's Sonar API
+sidebar_position: 5
+keywords: [financial-news, market-analysis, stocks, cryptocurrency, investment, sonar-api]
+---
+
+# Financial News Tracker
+
+A command-line tool that fetches and analyzes real-time financial news using Perplexity's Sonar API. Get comprehensive market insights, news summaries, and investment analysis for any financial topic.
+
+## Features
+
+- Real-time financial news aggregation from multiple sources
+- Market sentiment analysis (Bullish/Bearish/Neutral)
+- Impact assessment for news items (High/Medium/Low)
+- Sector and company-specific analysis
+- Investment insights and recommendations
+- Customizable time ranges (24h to 1 year)
+- Structured JSON output support
+- Beautiful emoji-enhanced CLI output
+
+## Installation
+
+### 1. Install required dependencies
+
+```bash
+# Install from requirements file (recommended)
+pip install -r requirements.txt
+
+# Or install manually
+pip install requests pydantic
+```
+
+### 2. Make the script executable
+
+```bash
+chmod +x financial_news_tracker.py
+```
+
+## API Key Setup
+
+The tool requires a Perplexity API key. You can provide it in one of these ways:
+
+### 1. As an environment variable (recommended)
+
+```bash
+export PPLX_API_KEY=YOUR_API_KEY
+```
+
+### 2. As a command-line argument
+
+```bash
+./financial_news_tracker.py "tech stocks" --api-key YOUR_API_KEY
+```
+
+### 3. In a file
+
+Create a file named `pplx_api_key` or `.pplx_api_key` in the same directory:
+
+```bash
+echo "YOUR_API_KEY" > .pplx_api_key
+chmod 600 .pplx_api_key
+```
+
+## Quick Start
+
+Get the latest tech stock news:
+
+```bash
+./financial_news_tracker.py "tech stocks"
+```
+
+This will fetch recent financial news about tech stocks, analyze market sentiment, and provide actionable insights.
+
+## Usage Examples
+
+### Basic usage - Get news for a specific topic
+
+```bash
+./financial_news_tracker.py "S&P 500"
+```
+
+### Get cryptocurrency news from the past week
+
+```bash
+./financial_news_tracker.py "cryptocurrency" --time-range 1w
+```
+
+### Track specific company news
+
+```bash
+./financial_news_tracker.py "AAPL Apple stock"
+```
+
+### Get news about market sectors
+
+```bash
+./financial_news_tracker.py "energy sector oil prices"
+```
+
+### Output as JSON for programmatic use
+
+```bash
+./financial_news_tracker.py "inflation rates" --json
+```
+
+### Use a different model
+
+```bash
+./financial_news_tracker.py "Federal Reserve interest rates" --model sonar
+```
+
+### Enable structured output (requires Tier 3+ API access)
+
+```bash
+./financial_news_tracker.py "tech earnings" --structured-output
+```
+
+## Time Range Options
+
+- `24h` - Last 24 hours (default)
+- `1w` - Last week
+- `1m` - Last month
+- `3m` - Last 3 months
+- `1y` - Last year
+
+## Output Format
+
+The tool provides comprehensive financial analysis including:
+
+### 1. Executive Summary
+A brief overview of the key financial developments
+
+### 2. Market Analysis
+- **Market Sentiment**: Overall market mood (🐂 Bullish, 🐻 Bearish, ⚖️ Neutral)
+- **Key Drivers**: Factors influencing the market
+- **Risks**: Current market risks and concerns
+- **Opportunities**: Potential investment opportunities
+
+### 3. News Items
+Each news item includes:
+- **Headline**: The main news title
+- **Impact**: Market impact level (🔴 High, 🟡 Medium, 🟢 Low)
+- **Summary**: Brief description of the news
+- **Affected Sectors**: Industries or companies impacted
+- **Source**: News source attribution
+
+### 4. Investment Insights
+Actionable recommendations and analysis based on the news
+
+## Example Output
+
+```
+📊 FINANCIAL NEWS REPORT: tech stocks
+📅 Period: Last 24 hours
+
+📝 EXECUTIVE SUMMARY:
+Tech stocks showed mixed performance today as AI-related companies surged while 
+semiconductor stocks faced pressure from supply chain concerns...
+
+📈 MARKET ANALYSIS:
+  Sentiment: 🐂 BULLISH
+
+  Key Drivers:
+    • Strong Q4 earnings from major tech companies
+    • AI sector momentum continues
+    • Federal Reserve signals potential rate cuts
+
+  ⚠️ Risks:
+    • Semiconductor supply chain disruptions
+    • Regulatory scrutiny on big tech
+    • Valuation concerns in AI sector
+
+  💡 Opportunities:
+    • Cloud computing growth
+    • AI infrastructure plays
+    • Cybersecurity demand surge
+
+📰 KEY NEWS ITEMS:
+
+1. Microsoft Hits All-Time High on AI Growth
+   Impact: 🔴 HIGH
+   Summary: Microsoft stock reached record levels following strong Azure AI revenue...
+   Sectors: Cloud Computing, AI, Software
+   Source: Bloomberg
+
+💼 INSIGHTS & RECOMMENDATIONS:
+  • Consider diversifying within tech sector
+  • AI infrastructure companies show strong momentum
+  • Monitor semiconductor sector for buying opportunities
+```
+
+## Advanced Features
+
+### Custom Queries
+
+You can combine multiple topics for comprehensive analysis:
+
+```bash
+# Get news about multiple related topics
+./financial_news_tracker.py "NVIDIA AMD semiconductor AI chips"
+
+# Track geopolitical impacts on markets
+./financial_news_tracker.py "oil prices Middle East geopolitics"
+
+# Monitor economic indicators
+./financial_news_tracker.py "inflation CPI unemployment Federal Reserve"
+```
+
+### JSON Output
+
+For integration with other tools or scripts:
+
+```bash
+./financial_news_tracker.py "bitcoin" --json | jq '.market_analysis.market_sentiment'
+```
+
+## Tips for Best Results
+
+1. **Be Specific**: Include company tickers, sector names, or specific events
+2. **Combine Topics**: Mix company names with relevant themes (e.g., "TSLA electric vehicles")
+3. **Use Time Ranges**: Match the time range to your investment horizon
+4. **Regular Monitoring**: Set up cron jobs for daily market updates
+
+## Limitations
+
+- Results depend on available public information
+- Not financial advice - always do your own research
+- Historical data may be limited for very recent events
+- Structured output requires Tier 3+ Perplexity API access
+
+## Error Handling
+
+The tool includes comprehensive error handling for:
+- Invalid API keys
+- Network connectivity issues
+- API rate limits
+- Invalid queries
+- Parsing errors
+
+## Integration Examples
+
+### Daily Market Report
+
+Create a script for daily updates:
+
+```bash
+#!/bin/bash
+# daily_market_report.sh
+
+echo "=== Daily Market Report ===" > market_report.txt
+echo "Date: $(date)" >> market_report.txt
+echo "" >> market_report.txt
+
+./financial_news_tracker.py "S&P 500 market overview" >> market_report.txt
+./financial_news_tracker.py "top gaining stocks" >> market_report.txt
+./financial_news_tracker.py "cryptocurrency bitcoin ethereum" >> market_report.txt
+```
+
+### Python Integration
+
+```python
+import subprocess
+import json
+
+def get_financial_news(query, time_range="24h"):
+    result = subprocess.run(
+        ["./financial_news_tracker.py", query, "--time-range", time_range, "--json"],
+        capture_output=True,
+        text=True
+    )
+    
+    if result.returncode == 0:
+        return json.loads(result.stdout)
+    else:
+        raise Exception(f"Error fetching news: {result.stderr}")
+
+# Example usage
+news = get_financial_news("tech stocks", "1w")
+print(f"Market sentiment: {news['market_analysis']['market_sentiment']}")
+```