stock-price-tracker

name	stock-price-tracker
description	Retrieve real-time stock prices via Yahoo Finance API. Supports multiple stock symbols, currency conversion, and clean JSON output for agent processing. Includes rate limiting protection.
metadata	{"version":"1.1.0","author":"cortana"}

Stock Price Tracker

Overview

This skill provides real-time stock price retrieval using Yahoo Finance's public API. It is designed for AI agents (like Cortana) to obtain accurate, up-to-date stock prices without manual web browsing. The output is clean JSON that can be directly consumed by other agents or tools.

Why this Skill?

When an AI agent needs to discuss financial markets, investment strategies, or company valuations, it requires current stock prices. This skill:

1. Provides Real-Time Data: Fetches live prices, day change, volume, and market cap.
2. Standardized Output: Returns structured JSON with consistent fields.
3. Multi-Symbol Support: Query multiple stocks in a single request.
4. No API Key Required: Uses Yahoo Finance's free public endpoint.
5. Rate Limiting Protection: Built-in retry logic, session pooling, and request delays to avoid "Too Many Requests" errors.

Note: This skill is for real-time price lookup only. For historical data or technical indicators, consider extending the skill or using dedicated financial data APIs.

Rate Limiting Protection

This skill includes multiple mechanisms to handle Yahoo Finance's rate limits:

1. Session Pooling: Uses requests.Session() for TCP connection reuse
2. Request Delays: Adds 1.5s delay between symbol requests
3. Retry Logic: Automatic retry with exponential backoff for 429 errors
4. Auto-Update: Automatically upgrades yfinance to latest version for bug fixes
5. Proxy Support: Configure HTTP/HTTPS proxy if needed

Troubleshooting "Too Many Requests" Errors

If you encounter rate limiting errors:

# Option 1: Update yfinance to latest version
pip install --upgrade yfinance

# Option 2: Use a proxy
export HTTP_PROXY="http://your-proxy:port"
export HTTPS_PROXY="http://your-proxy:port"
python3 skills/stock-price-tracker/scripts/stock_price.py --symbol AAPL

# Option 3: Increase delay between requests (modify REQUEST_DELAY_SECONDS in code)

Usage

The skill is implemented as a Python script that uses the yfinance library. Ensure you have Python 3.7+ and the required dependencies installed.

Installation

# Install required Python packages
pip install yfinance pandas requests

CLI Commands

# Get real-time price for a single stock symbol
python3 skills/stock-price-tracker/scripts/stock_price.py --symbol AAPL

# Get prices for multiple symbols
python3 skills/stock-price-tracker/scripts/stock_price.py --symbol AAPL,MSFT,GOOGL

# Specify exchange suffix (e.g., Shanghai .SS, Shenzhen .SZ, Hong Kong .HK)
python3 skills/stock-price-tracker/scripts/stock_price.py --symbol 000001.SZ,0700.HK

# Output in JSON format (default)
python3 skills/stock-price-tracker/scripts/stock_price.py --symbol AAPL --format json

# Output in CSV format
python3 skills/stock-price-tracker/scripts/stock_price.py --symbol AAPL --format csv

# Use proxy (via environment variables)
HTTP_PROXY=http://proxy:8080 python3 skills/stock-price-tracker/scripts/stock_price.py --symbol AAPL

Output Format

JSON Output Example

{
  "status": "success",
  "timestamp": "2026-02-25T14:30:00Z",
  "data": [
    {
      "symbol": "AAPL",
      "name": "Apple Inc.",
      "price": 178.32,
      "currency": "USD",
      "change": 1.24,
      "change_percent": 0.70,
      "volume": 58201300,
      "market_cap": 2790000000000,
      "day_high": 179.50,
      "day_low": 177.10,
      "previous_close": 177.08,
      "open": 177.50,
      "last_updated": "2026-02-25T14:30:00Z"
    }
  ]
}

CSV Output Example

symbol,name,price,currency,change,change_percent,volume,market_cap,day_high,day_low,previous_close,open,last_updated
AAPL,Apple Inc.,178.32,USD,1.24,0.70,58201300,2790000000000,179.50,177.10,177.08,177.50,2026-02-25T14:30:00Z

Error Handling

If a symbol cannot be found or an error occurs, the skill returns:

{
  "status": "error",
  "message": "Symbol 'INVALID' not found",
  "timestamp": "2026-02-25T14:30:00Z"
}

Integration with Agents

Agents can call this skill via subprocess or Python's submodule.run. Example:

import subprocess
import json

def get_stock_price(symbol):
    result = subprocess.run(
        ["python3", "skills/stock-price-tracker/scripts/stock_price.py", "--symbol", symbol],
        capture_output=True,
        text=True
    )
    return json.loads(result.stdout)

# Use in agent logic
price_data = get_stock_price("AAPL")
if price_data["status"] == "success":
    print(f"Current price: {price_data['data'][0]['price']}")

Dependencies

• Python 3.7+
• yfinance >= 0.2.0
• pandas >= 1.3.0

License

This skill is part of the llm-prompts project and follows the same licensing terms.