From file to useful result
How to ask with this skill installed
Installing the skill gives your AI a method. Your request still has to provide the case-specific facts, constraints and expected output.
Describe the decision or deliverable, not just the topic.
Add source material, audience, limits and known facts.
Set format, quality criteria and checks.
When to use it
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
Mistakes to avoid
"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:
- Invalid FINVIZ API key
- FINVIZ Elite subscription expired
- 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:
- FINVIZ API connection issue
- Screening criteria too restrictive (no stocks match)
- 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