value-dividend-screener

Value Dividend Screener

Overview

This skill identifies high-quality dividend stocks that combine value characteristics, attractive income generation, and consistent growth using a two-stage screening approach:

1. FINVIZ Elite API (Optional but Recommended): Pre-screen stocks with basic criteria (fast, cost-effective)
2. Financial Modeling Prep (FMP) API: Detailed fundamental analysis of candidates

Screen US equities based on quantitative criteria including valuation ratios, dividend metrics, financial health, and profitability. Generate comprehensive reports ranking stocks by composite quality scores with detailed fundamental analysis.

Efficiency Advantage: Using FINVIZ pre-screening can reduce FMP API calls by 90%, making this approach ideal for free-tier API users.

When to Use

Invoke this skill when the user requests:

• "Find high-quality dividend stocks"
• "Screen for value dividend opportunities"
• "Show me stocks with strong dividend growth"
• "Find income stocks trading at reasonable valuations"
• "Screen for sustainable high-yield stocks"
• Any request combining dividend yield, valuation metrics, and fundamental analysis

Workflow

Step 1: Verify API Key Availability

For Two-Stage Screening (Recommended):

Check if both API keys are available:

import os
fmp_api_key = os.environ.get('FMP_API_KEY')
finviz_api_key = os.environ.get('FINVIZ_API_KEY')

If not available, ask user to provide API keys or set environment variables:

export FMP_API_KEY=your_fmp_key_here
export FINVIZ_API_KEY=your_finviz_key_here

For FMP-Only Screening:

Check if FMP API key is available:

import os
api_key = os.environ.get('FMP_API_KEY')

If not available, ask user to provide API key or set environment variable:

export FMP_API_KEY=your_key_here

FINVIZ Elite API Key:

• Requires FINVIZ Elite subscription (~$40/month or ~$330/year)
• Provides access to CSV export of pre-screened results
• Highly recommended for reducing FMP API usage