Aade Api Monitor

Real-time monitoring of Greek AADE tax authority systems — tracks deadlines, rate changes, and compliance updates. File-based, OpenClaw-native.

Security Scan

The skill's requirements and runtime instructions are consistent with a file-based AADE monitoring tool that needs OpenClaw data paths and AADE portal credentials; nothing in the package indicates unexplained or unrelated access.

Purpose & Capability

Name/description (AADE monitoring) align with required binaries (jq, curl), declared env vars (OPENCLAW_DATA_DIR, AADE_USERNAME, AADE_PASSWORD), file paths (/data) and the described OpenClaw CLI commands for downloading and processing government documents.

Instruction Scope

SKILL.md instructs only to authenticate to AADE, download/process government documents, write alerts/reports to local data directories, and optionally post to configured webhook/SMS/calendar endpoints. It does not instruct reading unrelated system files or accessing other credentials. It does include a suggestion to install jq/curl via apt if missing, which is a reasonable runtime convenience.

Install Mechanism

This is an instruction-only skill with no install spec or archive downloads. That minimizes risk—the skill relies on existing system tools (jq, curl) and OpenClaw commands rather than pulling external code.

Credentials

Requested env vars (OPENCLAW_DATA_DIR, AADE_USERNAME, AADE_PASSWORD) are appropriate for a monitoring skill that authenticates to the AADE portal and stores files locally. However, AADE_PASSWORD is sensitive; the skill expects direct portal credentials rather than an API token, which increases risk if those credentials have broader privileges. Optional webhook/SMS/calendar env vars are reasonable for alerting but would transmit data externally if configured.

Persistence & Privilege

always is false and the skill is user-invocable; it does not request elevated platform privileges or permanent global presence. There are no instructions to modify other skills or system-wide agent settings.

Assessment

This skill appears coherent with its stated purpose, but before installing: (1) avoid supplying your primary AADE account password if possible — create a dedicated, least-privilege account or API token for monitoring and rotate it regularly; (2) secure OPENCLAW_DATA_DIR (it will store downloaded documents and alerts); (3) be cautious with optional webhooks/SMS/calendar env vars — they will forward alerts to external endpoints, so only configure trusted targets; (4) verify the openclaw aade CLI commands and the referenced GitHub homepage repository to ensure the OpenClaw commands invoked are from a trusted implementation; (5) note the SKILL.md suggests using sudo apt install which requires system privileges — run that step intentionally and independently rather than letting an agent perform it automatically.

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.