value-dividend-screener

Cuándo usarla

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

Errores que conviene evitar

"ERROR: requests library not found"

Solution: Install requests library

pip install requests

"ERROR: FMP API key required"

Solution: Set environment variable or provide via command-line

export FMP_API_KEY=your_key_here
# OR
python3 scripts/screen_dividend_stocks.py --fmp-api-key your_key_here

"ERROR: FINVIZ API key required when using --use-finviz"

Solution: Set environment variable or provide via command-line

export FINVIZ_API_KEY=your_key_here
# OR
python3 scripts/screen_dividend_stocks.py --use-finviz --finviz-api-key your_key_here

Note: FINVIZ Elite subscription required (~$40/month or ~$330/year)

"ERROR: FINVIZ API authentication failed"

Possible causes:

1. Invalid FINVIZ API key
2. FINVIZ Elite subscription expired
3. API key format incorrect

Solution:

• Verify FINVIZ Elite subscription is active
• Check API key for typos (should be alphanumeric string)
• Log into FINVIZ Elite account and verify API key in settings
• Try accessing FINVIZ Elite screener manually to confirm subscription

"ERROR: FINVIZ pre-screening failed or returned no results"

Possible causes:

1. FINVIZ API connection issue
2. Screening criteria too restrictive (no stocks match)
3. Market conditions (bear market may yield fewer results)

Solution:

• Check internet connection
• Verify FINVIZ Elite website is accessible
• Try FMP-only method as fallback:

  python3 scripts/screen_dividend_stocks.py

"WARNING: Rate limit exceeded"

Solution: Script automatically retries after 60 seconds. If persistent:

• Wait until next day (free tier resets daily)
• Reduce number of stocks analyzed (modify line 394 limit)
• Consider upgrading to paid FMP tier

"No stocks found matching all criteria"

Solution: Criteria may be too restrictive

• Relax P/E threshold (increase from 20)
• Lower dividend yield requirement (decrease from 3.5%)
• Reduce dividend growth requirement (decrease from 5%)
• Check market conditions (bear markets may have fewer qualifiers)

Script runs slowly

Expected behavior: Script includes 0.3s delay between API calls for rate limiting

• 100 stocks analyzed = ~8-10 minutes
• First 20-30 qualifying stocks usually found within first 50-70 analyzed