aade-api-monitor
Real-time monitoring of Greek AADE tax authority systems — tracks deadlines, rate changes, and compliance updates. File-based, OpenClaw-native.
- License 许可
- MIT
- 最近更新
- 2026-06-07
- Stars
- ★ 0
- Forks
- 1
01 前言 Front Matter
- name
- aade-api-monitor
- tags
- [ "greek", "accounting", "aade", "government-monitoring", "api" ]
- author
- openclaw-greek-accounting
- version
- 1.0.0
- homepage
- https://github.com/satoshistackalotto/openclaw-greek-accounting
- metadata
- { "openclaw": { "notes": "AADE credentials required for monitoring government portal. Slack and SMS alert channels are optional — if not configured, alerts are written to local files only.", "requires": { "env": [ "OPENCLAW_DATA_DIR", "AADE_USERNAME", "AADE_PASSWORD" ], "bins": [ "jq", "curl" ] }, "optional_env": { "SMS_GATEWAY_URL": "SMS gateway for critical compliance alerts", "SLACK_WEBHOOK_URL": "Webhook URL for urgent AADE change alerts", "GOOGLE_CALENDAR_ID": "Google Calendar ID for compliance deadline sync (optional)", "OUTLOOK_CALENDAR_ID": "Outlook Calendar ID for compliance deadline sync (optional)" } } }
- description
- Real-time monitoring of Greek AADE tax authority systems — tracks deadlines, rate changes, and compliance updates. File-based, OpenClaw-native.
03 SKILL.md 正文
AADE API Monitor
This skill provides comprehensive monitoring of AADE systems and announcements through OpenClaw's file processing capabilities, delivering real-time alerts for Greek tax compliance changes.
Setup
export OPENCLAW_DATA_DIR="/data"
export AADE_USERNAME="your-aade-username"
export AADE_PASSWORD="your-aade-password"
which jq curl || sudo apt install jq curl
AADE credentials are used for authenticated read-only checks of announcements, rate changes, and system status. This skill never submits filings.
Core Philosophy
- File-First Processing: Monitor and process government documents, not complex APIs
- Reliable Operation: Work offline with cached data when government sites unavailable
- OpenClaw Native: Built specifically for OpenClaw's strengths and limitations
- Production Ready: Error handling, logging, and recovery built-in from start
- Greek Business Focus: Professional alerts and reporting in Greek
OpenClaw Commands
Core AADE Monitoring Commands
# Primary monitoring operations
openclaw aade monitor --enable --government-sites --cache-updates
openclaw aade check-updates --since "24 hours" --urgent-only
openclaw aade download-announcements --date today --all-categories
openclaw aade scan-deadlines --compare-previous --alert-changes
# System status monitoring
openclaw aade status-check --taxis --mydata --efka --report-outages
openclaw aade system-health --uptime-tracking --performance-metrics
openclaw aade maintenance-schedule --upcoming --impact-assessment
# Document processing
openclaw aade process-documents --input /data/incoming/government/ --extract-deadlines
openclaw aade classify-updates --tax-changes --deadline-changes --system-updates
openclaw aade generate-alerts --priority high --recipients accounting-team
Deadline & Rate Change Monitoring
# Deadline monitoring
openclaw aade monitor-deadlines --vat --income-tax --enfia --social-security
openclaw aade deadline-changes --since yesterday --client-impact-analysis
openclaw aade calendar-update --sync-changes --notify-affected-clients
# Rate and regulation changes
openclaw aade monitor-rates --vat-rates --tax-brackets --social-security
openclaw aade regulation-tracker --new-circulars --law-changes --implementation-dates
openclaw aade impact-analysis --rate-changes --client-calculations --cost-impact
Integration & Reporting Commands
# Integration with other skills
openclaw aade integrate --cli-deadline-monitor --email-processor --meta-skill
openclaw aade export-data --format json --destination /data/dashboard/state/
openclaw aade sync-calendar --include-holidays
# Professional reporting
openclaw aade report-generate --daily --weekly --monthly --client-ready-greek
openclaw aade client-notifications --deadline-changes --rate-updates --professional-tone
openclaw aade compliance-dashboard --current-status --upcoming-deadlines --action-items
OpenClaw File Processing Architecture
File System Organization
AADE_File_Structure:
input_monitoring: # Raw government documents arrive here
- /data/incoming/government/ # All AADE/government downloads
processing_workspace: # Ephemeral — cleared after pipeline
- /data/processing/compliance/ # Classification and extraction workspace
output_delivery:
- /data/dashboard/state/current-alerts.json # Active alerts for dashboard
- /data/dashboard/state/deadline-tracker.json # Updated deadline tracker
- /data/reports/compliance/ # Professional compliance reports
- /data/exports/compliance-deadlines.json # Calendar integration export
Document Processing Pipeline
Processing_Workflow:
step_1_download:
command: "openclaw aade download-batch --sources all --format pdf,html,xml"
input: "Government website monitoring"
output: "/data/incoming/government/{YYYYMMDD}/"
step_2_extract:
command: "openclaw aade extract-content --use-deepread --greek-language"
input: "/data/incoming/government/"
output: "/data/processing/compliance/"
step_3_classify:
command: "openclaw aade classify-importance --deadline-changes high --rate-changes high"
input: "/data/processing/compliance/"
output: "/data/processing/compliance/"
step_4_compare:
command: "openclaw aade detect-changes --compare-with-cache --highlight-differences"
input: "/data/processing/compliance/"
output: "/data/processing/compliance/"
step_5_validate:
command: "openclaw aade validate-data --cross-reference --accuracy-check"
input: "/data/processing/compliance/"
output: "/data/processing/compliance/"
step_6_generate:
command: "openclaw aade generate-outputs --alerts --reports --notifications"
input: "/data/processing/compliance/"
output: "/data/dashboard/state/ and /data/reports/compliance/"
Intelligent Document Monitoring
AADE Website Monitoring Strategy
Government_Site_Monitoring:
primary_sources:
aade_main:
url: "https://www.aade.gr"
sections: ["announcements", "circulars", "deadlines", "rates"]
frequency: "every_2_hours"
taxis_updates:
url: "https://www1.aade.gr/taxisnet"
sections: ["system-announcements", "maintenance-schedules"]
frequency: "every_4_hours"
mydata_status:
url: "https://mydatapi.aade.gr"
sections: ["api-status", "system-updates", "technical-announcements"]
frequency: "hourly"
backup_sources:
press_releases:
url: "https://www.aade.gr/deltia-typou"
fallback: true
legal_database:
url: "https://www.aade.gr/nomothesia"
frequency: "daily"
Intelligent Change Detection
Change_Detection_Logic:
deadline_changes:
triggers:
- "Date changes in deadline tables"
- "New deadline announcements"
- "Extension or acceleration notices"
confidence_threshold: 0.95
validation: "Cross-reference multiple sources"
rate_changes:
triggers:
- "VAT rate modifications"
- "Tax bracket adjustments"
- "Social security rate updates"
effective_date_tracking: "Extract implementation dates"
impact_calculation: "Estimate client effects"
system_updates:
triggers:
- "Maintenance announcements"
- "New feature releases"
- "System outage notifications"
criticality_assessment: "Business impact analysis"
workaround_suggestions: "Alternative procedures"
OpenClaw-Native Processing Features
Robust Error Handling
# Error recovery commands
openclaw aade retry-failed --batch-id {id} --fix-network-issues
openclaw aade fallback-mode --use-cached-data --offline-operation
openclaw aade manual-review --flagged-updates --require-human-verification
# Monitoring and diagnostics
openclaw aade health-check --test-all-sources --report-failures
openclaw aade diagnostics --connection-test --parsing-test --alert-test
openclaw aade logs --filter errors --last 48h --include-context
Caching & Offline Operation
Caching_Strategy:
announcement_cache:
retention: "90 days"
update_frequency: "every_2_hours"
fallback_behavior: "Use cached data if source unavailable"
deadline_cache:
retention: "1 year"
critical_updates: "Force immediate refresh"
validation: "Compare multiple sources for accuracy"
system_status_cache:
retention: "7 days"
real_time_updates: "When possible"
offline_mode: "Report last known status with timestamp"
Greek Language Processing
Greek_Document_Processing:
text_extraction:
encoding: "UTF-8, Windows-1253, ISO-8859-7"
ocr_support: "Greek character recognition via deepread"
keyword_detection:
deadline_terms: ["προθεσμία", "λήξη", "υποβολή", "deadline"]
rate_terms: ["συνπžελεσπžήπš", "ποσοσπžς", "π ςροπš", "rate", "tax"]
system_terms: ["συνπžήρηση", "διακοπή", "maintenance", "outage"]
date_recognition:
greek_formats: ["dd/MM/yyyy", "dd-MM-yyyy", "dd Μμμ yyyy"]
month_names: ["Ιανουάριοπš", "Φεβρουάριοπš", ..., "Δεκέμβριοπš"]
business_day_calculation: "Exclude Greek holidays and weekends"
Professional Alert System
Alert Generation & Classification
Alert_System:
critical_alerts:
deadline_changes:
trigger: "Any tax deadline moved forward"
delivery: "Immediate notification to assigned accountant"
template: "ΡΡΙΣΙΜθ: Προθεσμία {tax_type} μεπžακινήθηκε σπžιπš {new_date}"
system_outages:
trigger: "TAXIS or myDATA unavailable >30 minutes"
delivery: "Immediate notification to accounting teams"
template: "ΔΙΑΡθΠΗ: Σύσπžημα {system_name} μη διαθέσιμο απς {outage_start}"
important_alerts:
rate_changes:
trigger: "VAT or tax rate modifications"
delivery: "Email + dashboard update"
template: "Αλλαγή συνπžελεσπžή: {rate_type} απς {old_rate} σε {new_rate}"
new_regulations:
trigger: "New tax circulars or law changes"
delivery: "Daily digest email"
template: "Νέα εγκύκλιοπš: {circular_number} - {summary}"
routine_alerts:
system_maintenance:
trigger: "Scheduled maintenance announcements"
delivery: "Weekly summary"
template: "Προγραμμαπžισμένη συνπžήρηση: {system} πžην {date} {time}"
Greek Professional Communication
Professional_Templates:
client_deadline_alert:
subject: "Σημανπžική ενημέρπ°ση: Αλλαγή προθεσμίαπš {tax_type}"
body: |
Αξιςπžιμοι πελάπžεπš,
Σαπš ενημερϽνουμε ςπžι η ΑΑΔΕ ανακοίνπ°σε αλλαγή σπžην προθεσμία
υποβολήπš {tax_description}.
Νέα προθεσμία: {new_deadline}
Προηγούμενη προθεσμία: {old_deadline}
Παρακαλούμε επικοινπ°νήσπžε μαζί μαπš για οποιαδήποπžε διευκρίνιση.
Με εκπžίμηση,
{accounting_firm_name}
rate_change_notification:
subject: "Ενημέρπ°ση: Αλλαγή π ορολογικού συνπžελεσπžή"
body: |
Αγαπηπžοί συνεργάπžεπš,
Απς {effective_date} ισπ¡ύει νέοπš συνπžελεσπžήπš {tax_type}:
- Νέοπš συνπžελεσπžήπš: {new_rate}%
- Προηγούμενοπš: {old_rate}%
Η αλλαγή επηρεάζει: {affected_transactions}
Το λογισπžικς μαπš γραπ είο θα ενημερϽσει ςλουπš πžουπš υπολογισμούπš.
{firm_contact_info}
Integration Workflows
Meta-Skill Integration
# Integration with OpenClaw Greek Accounting Meta-Skill
openclaw aade register-with-meta --enable-orchestration
openclaw aade meta-commands --list-available --business-focused
# Meta-skill can now call:
# openclaw greek government-check (calls aade-api-monitor internally)
# openclaw greek emergency-compliance (uses aade alerts)
# openclaw greek status-dashboard (includes aade system status)
Other Skill Integration
Skill_Integration_Points:
cli_deadline_monitor:
data_exchange: "Share deadline change data"
coordination: "Avoid duplicate monitoring"
backup_relationship: "CLI monitor provides fallback data"
greek_email_processor:
alert_delivery: "Use email processor for client notifications"
template_sharing: "Share Greek language templates"
document_processing: "Process AADE emails received by clients"
greek_compliance_aade:
rate_updates: "Notify compliance skill of rate changes"
calculation_updates: "Trigger recalculation when rates change"
submission_timing: "Coordinate deadline changes with submissions"
Production Monitoring & Maintenance
Automated Health Monitoring
# Health check commands for production deployment
openclaw aade health-check --comprehensive --test-all-endpoints
openclaw aade performance-monitor --response-times --error-rates --uptime
openclaw aade data-validation --accuracy-check --cross-reference --anomaly-detection
# Maintenance and optimization
openclaw aade cache-optimize --cleanup-old --defragment --performance-tune
openclaw aade update-patterns --learn-new-formats --improve-accuracy
openclaw aade backup-data --critical-cache --configuration --logs
Logging & Audit Trail
Production_Logging:
access_logs:
file: "/logs/aade-monitor/access.log"
retention: "6 months"
includes: ["URLs accessed", "Response codes", "Response times"]
change_detection_logs:
file: "/logs/aade-monitor/changes.log"
retention: "2 years"
includes: ["Detected changes", "Confidence scores", "Validation results"]
alert_logs:
file: "/logs/aade-monitor/alerts.log"
retention: "1 year"
includes: ["Alert generation", "Delivery methods", "User responses"]
error_logs:
file: "/logs/aade-monitor/errors.log"
retention: "1 year"
includes: ["Processing errors", "Network failures", "Recovery actions"]
Advanced Features
Machine Learning Enhancement
ML_Capabilities:
document_classification:
training_data: "Historical AADE announcements with manual classifications"
accuracy_target: ">95% for critical document identification"
continuous_learning: "Update model based on manual corrections"
change_impact_prediction:
analysis: "Predict client impact based on historical patterns"
risk_assessment: "Identify high-risk clients for proactive communication"
resource_planning: "Estimate workload from detected changes"
anomaly_detection:
baseline_patterns: "Learn normal AADE announcement patterns"
unusual_activity: "Flag potential system issues or major changes"
false_positive_reduction: "Reduce unnecessary alerts through pattern learning"
Compliance Dashboard Integration
Dashboard_Features:
real_time_status:
aade_systems: "Live status of TAXIS, myDATA, EFKA systems"
recent_changes: "Timeline of recent deadline and rate changes"
alert_summary: "Critical, important, and routine alerts overview"
client_impact_view:
affected_clients: "Which clients affected by recent changes"
action_required: "Immediate actions needed per client"
communication_status: "Which clients have been notified"
performance_metrics:
monitoring_uptime: "AADE monitor system availability"
detection_accuracy: "Change detection success rate"
alert_effectiveness: "User response to generated alerts"
Usage Examples
Daily Operations
# Morning AADE check (part of daily routine)
$ openclaw aade morning-check --since yesterday
📊 AADE Morning Summary - February 18, 2026:
ðŸÂ€ºï¸ System Status:
✅ TAXIS Online (98.2% uptime last 24h)
✅ myDATA Online (99.1% uptime last 24h)
✅ EFKA Portal Online (97.5% uptime last 24h)
📢 New Announcements (2):
📀¹ Circular POL.1157/2026 - VAT exemption clarification
⚠ï¸ System maintenance scheduled: February 20, 02:00-06:00 EET
🔀ž Changes Detected: None
📅 Upcoming Deadlines: 3 VAT returns due in 7 days
Next check in 2 hours. Manual refresh: openclaw aade check-updates
Change Detection Example
$ openclaw aade detect-changes --urgent --notify-immediately
🚨 CRITICAL CHANGE DETECTED:
📅 Deadline Change Alert:
Tax Type: Monthly VAT Return (March 2026)
Old Deadline: April 25, 2026
New Deadline: April 20, 2026
Change: 5 days earlier
Impact: 47 clients affected
📀¹ Source Document:
AADE Announcement: Πθº.1158/2026
Published: 2026-02-18 14:30 EET
Confidence: 98.5%
✅ Actions Taken:
- Updated compliance deadline tracker
- Generated client notifications (47 emails prepared)
- Integrated with meta-skill workflow
- Logged change in audit trail
📧 Client notifications ready for review:
openclaw aade review-notifications --batch-id 2026021801
Professional Client Communication
$ openclaw aade generate-client-alert --deadline-change --professional-tone
📧 Generated Greek Client Communication:
Subject: ΕΠΕΙΓθΝ: Αλλαγή προθεσμίαπš δήλπ°σηπš ΦΠΑ Μαρπžίου 2026
Αξιςπžιμοι πελάπžεπš,
Σαπš ενημερϽνουμε με απ ορμή πžην ανακοίνπ°ση πžηπš ΑΑΔΕ (Πθº.1158/2026)
ςπžι η προθεσμία υποβολήπš πžηπš μηνιαίαπš δήλπ°σηπš ΦΠΑ για πžον Μάρπžιο 2026
μεπžακινείπžαι απς πžιπš 25 Απριλίου σπžιπš 20 Απριλίου 2026.
Η αλλαγή επηρεάζει ςλεπš πžιπš επιπ¡ειρήσειπš με υποπ¡ρέπ°ση υποβολήπš
μηνιαίαπš δήλπ°σηπš ΦΠΑ.
Το λογισπžικς μαπš γραπ είο έπ¡ει ήδη ενημερϽσει πžο σύσπžημα παρακολούθησηπš
προθεσμιϽν και θα π ρονπžίσουμε για πžην έγκαιρη προεπžοιμασία και υποβολή.
Για οποιαδήποπžε διευκρίνιση, παρακαλούμε επικοινπ°νήσπžε μαζί μαπš.
Με εκπžίμηση,
[Accounting Firm Name]
📧 Ready for sending to 47 affected clients
Success Metrics
A successful AADE API Monitor should achieve:
- ✅ 99%+ uptime monitoring of critical AADE systems
- ✅ <5 minute detection time for critical deadline changes
- ✅ 95%+ accuracy in document classification and change detection
- ✅ Zero false positives for critical alerts
- ✅ Complete integration with meta-skill orchestration
- ✅ Professional Greek communication standards
- ✅ Comprehensive audit trail for compliance purposes
- ✅ Robust offline operation with cached data fallback
Remember: This skill is built OpenClaw-first, using file processing and practical automation rather than complex API integrations, making it reliable and maintainable for production Greek accounting environments.
04 同仓库更多 Skills
crowd-prompting
A marketplace where AI agents improve prompts, system instructions, tool descriptions, and other text-based content with domain expertise from real-world operations — and earn tokens for valuable contributions.
ceaser
Interact with the Ceaser privacy protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- shield, unshield, note management, and protocol queries. All ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). Ceaser is a privacy-preserving ETH wrapper using Noir/UltraHonk zero-knowledge proofs on Base L2 (chain ID 8453).
ceaser-send
Fully automated private ETH transfer via Ceaser Protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- all ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). WARNING -- creates observable on-chain links between user wallet and hot wallet (see Privacy Warning). Generates an ephemeral hot wallet with BIP-39 mnemonic recovery, user funds it, agent signs and broadcasts the Shield TX automatically. Exactly one manual step required (funding the hot wallet with ETH). Uses Noir/UltraHonk zero-knowledge proofs.
dilemm-ai
Compete in DilemmAI, the prisoner's dilemma AI arena at dilemm.ai. Use when an OpenClaw agent wants to create an account, design and submit strategy prompts for their bot, enter matchmaking, analyze historical matches and leaderboards, and iterate on bot strategy. Requires headless browser automation (no API available yet).
moldium
Post and manage content on the Moldium blog platform. Triggered by "post to Moldium", "write a blog post", "publish an article", etc.
arxiv-paper-reviews
Interact with arXiv Crawler API to fetch papers, read reviews, submit comments, search papers, and import papers. Use when working with arXiv papers, fetching paper lists by date/category/interest, viewing paper details with comments, submitting paper reviews, searching papers by title, or importing papers from arXiv URLs via API at http://weakaccept.top:8000/.