{"skill":{"slug":"economic-calendar","displayName":"Economic Calendar","summary":"Fetch and display filtered macro-economic events from Investing.com with no API key, supporting date range, importance, country, timezone, and JSON output.","description":"# economic-calendar\n\nFetch macro-economic events (Fed, ECB, CPI, etc.) from Investing.com. No API key required — pure scraping.\n\n## Usage\n\n```bash\n# Today's high-importance US events (table output)\npython scripts/economic_calendar.py\n\n# Specific date with custom filters\npython scripts/economic_calendar.py --date 2026-03-01 --importance high medium --countries \"united states\" germany\n\n# Multiple days (next 7 days)\npython scripts/economic_calendar.py --days 7 --importance high medium --countries \"united states\"\n\n# JSON to stdout (for automation/piping)\npython scripts/economic_calendar.py --date tomorrow --json stdout\n\n# JSON to file (default: calendar_YYYYMMDD.json)\npython scripts/economic_calendar.py --days 3 --json file\n```\n\n## Options\n\n| Flag | Description | Default |\n|------|-------------|---------|\n| `--date` | Start date: `today`, `tomorrow`, `yesterday`, or `YYYY-MM-DD` | `today` |\n| `--days` | Fetch range of N days (overrides `--date`) | — |\n| `--importance` | Filter levels: `low`, `medium`, `high` (space-separated) | `high` |\n| `--countries` | Countries (space-separated, quotes for multi-word) | `united states` |\n| `--timezone` | Timezone for event times | `GMT +1:00` |\n| `--json` | JSON mode: `file`, `stdout`, `none` | `file` |\n\n## Countries\n\nAvailable country names (use quotes for multi-word):\n- `united states`\n- `germany`\n- `united kingdom`\n- `france`\n- `japan`\n- `china`\n- `canada`\n- `australia`\n- `switzerland`\n- `eurozone`\n\n## Timezones\n\nCommon timezones:\n- `GMT +1:00` — Berlin/Vienna (CET) ✓ default\n- `GMT +2:00` — Berlin/Vienna (CEST)\n- `GMT -5:00` — New York (EST)\n- `GMT -4:00` — New York (EDT)\n- `GMT` — UTC\n\n## Output Formats\n\n### Table (default)\nHuman-readable formatted table to stdout:\n```\n================================================================================\n  Economic Calendar  |  25.02.2026\n  Countries: United States  |  Timezone: GMT +1:00  |  Importance: high\n================================================================================\n  Time    Imp.     Curr.  Event                          Forecast  Previous  Actual\n  ------- -------- ------ ------------------------------ --------- --------- --------\n  14:30   high     USD    Unemployment Claims            215K      219K      —\n  14:30   high     USD    Core PPI m/m                   0.3%      0.4%      —\n================================================================================\n  2 event(s) found.\n```\n\n### JSON\n```json\n{\n  \"from\": \"2026-02-25\",\n  \"to\": \"2026-02-25\",\n  \"timezone\": \"GMT +1:00\",\n  \"importances\": [\"high\"],\n  \"countries\": [\"united states\"],\n  \"events\": [\n    {\n      \"date\": \"Tuesday, February 25, 2026\",\n      \"time\": \"14:30\",\n      \"currency\": \"USD\",\n      \"importance\": 3,\n      \"event\": \"Unemployment Claims\",\n      \"actual\": \"\",\n      \"forecast\": \"215K\",\n      \"previous\": \"219K\"\n    }\n  ]\n}\n```\n\n## Dependencies\n\n```bash\npip install requests beautifulsoup4 lxml\n```\n\n## Notes\n\n- **Source:** Investing.com (server-side rendered, reliable CSS selectors)\n- **Rate limiting:** Built-in delays between requests\n- **Session handling:** Maintains cookies across requests for proper session state\n- **Data validity:** Historical data + 1+ years forward\n- **No API key:** All data is publicly scraped\n\n## Use in Workflows\n\n```bash\n# Daily briefing — get today's high/medium US events as JSON\npython3 skills/economic-calendar/scripts/economic_calendar.py \\\n  --date today \\\n  --importance high medium \\\n  --countries \"united states\" \\\n  --json stdout\n```\n","topics":["Calendar"],"tags":{"economics":"1.0.1","finance":"1.0.1","forex":"1.0.1","latest":"1.0.1","scraping":"1.0.1"},"stats":{"comments":0,"downloads":1040,"installsAllTime":38,"installsCurrent":6,"stars":0,"versions":2},"createdAt":1772387161954,"updatedAt":1778491681414},"latestVersion":{"version":"1.0.1","createdAt":1772387650945,"changelog":"Removed MCC-specific references, generalized workflow examples","license":null},"metadata":null,"owner":{"handle":"quantx-heiko","userId":"s17ey905mpnm9z8xkhn6aw82yh858mqs","displayName":"quantx-heiko","image":"https://avatars.githubusercontent.com/u/145019013?v=4"},"moderation":null}