Annual Report Cache
SkillCommerce & financeCached Icelandic company annual reports (ársreikningar) via fetch-annual-report.sh. Prefer over skatturinn+financials for EBITDA, ratios, shareholders.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the Annual Report Cache skill
What this skill tells your AI
The instructions your AI receives, as published by jokull/icelandic-data in .agents/skills/annual-report-cache/SKILL.md and read by ahel’s review.
Always use scripts/fetch-annual-report.sh when fetching annual reports.
This script handles R2 caching transparently — you don't need to manage the cache yourself.
Usage
# Fetch latest year for a kennitala
./scripts/fetch-annual-report.sh 4612023490
# Fetch specific year
./scripts/fetch-annual-report.sh 4612023490 2023
# Fetch multiple years
for year in 2022 2023 2024; do
./scripts/fetch-annual-report.sh 4612023490 $year > /tmp/report-$year.json
done
How it works
- Checks R2 cache at
annual-reports/{kennitala}/{year}.json - If cached (CACHE_HIT) — returns JSON instantly (~100ms)
- If not cached (CACHE_MISS) — runs skatturinn.py + financials.py, caches result in R2, returns JSON
- Status messages go to stderr, JSON data goes to stdout
Output
Structured JSON with: incomeStatement, balanceSheet, cashFlow, ratios, bankFinancials (if bank), shareholders, boardMembers.
When to use
- Any query about ársreikningar, EBITDA, financial analysis, company financials
- Prefer this over running skatturinn.py + financials.py directly
- The R2 cache has ~2,500 pre-extracted reports for instant access
Signals
- GitHub stars
- 53
- Forks
- 4
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
annual-report-cache- Source
- github.com/jokull/icelandic-data