Financial Data Infrastructure · Open Source

Multi-Market Economic Intelligence for Code & AI Agents

Automated extraction and typed Pydantic v2 normalization across ForexFactory, CryptoCraft, EnergyExch, and MetalsMine. Terminal CLI with Rich tables, Python SDK for quant pipelines, and Model Context Protocol (MCP) server for Claude and Cursor.

brew tap AtaCanYmc/tap && brew install forex-pytory
Release v0.2.0 4 Portals Supported Pydantic v2 Validated MCP Protocol Native

Engineered for Automated Ingestion & Autonomous Agents

Bridging raw unstructured financial calendar websites into deterministic, typed data streams.

Multi-Market Ingestion

Unified scrapers for ForexFactory, CryptoCraft, EnergyExch, and MetalsMine. Normalized schemas across fiat currencies, crypto assets, crude oil, and bullion.

Cloudflare Challenge Bypass

Integrated cloudscraper engine transparently solves anti-bot JS challenges and emulates genuine desktop browser sessions without headless browser overhead.

Pydantic v2 Type Safety

Every calendar row is validated into strongly typed EconomicEvent models with aliases, field serialization, and seamless one-line conversion to Pandas DataFrames.

Model Context Protocol

Turn AI systems like Claude Desktop, Cursor, and custom agentic frameworks into live market research analysts with the standard forex-mcp stdio server.

Live Economic Event Explorer & Schema Inspector

Experience how raw financial calendar tables are mapped into structured, filterable data entities.

Market:
Impact:
Time (EST) Asset / Currency Event Name Impact Forecast Actual Previous

Interactive Command & Code Generator

Configure your extraction parameters and generate copy-pastable CLI commands, Python code, and MCP tool payloads in real time.

CLI Terminal Command
forex-scraper --source forex --format table
Python SDK Equivalent
# Generated via builder
Model Context Protocol (MCP) Tool Call
{}

Complete Technical Documentation

Explore setup guides, API contracts, pipeline recipes, and agent configuration templates.

Command Line Interface (forex-scraper)

The forex-scraper executable provides instant terminal queries with zero code. It supports both Rich ANSI table rendering and clean JSON output for UNIX piping.

Flag Type Allowed Values Default Description
--source String forex, crypto, energy, metals forex Financial market calendar portal to query.
--date String YYYY-MM-DD Today Specific calendar date to fetch.
--format String table, json json Output visual formatting style.
-h, --help Flag — — Print CLI help and argument descriptions.

UNIX Pipe & jq Recipe

Extract only high-impact cryptocurrency events and format as a compact list:

Shell Script
forex-scraper --source crypto --format json | jq '.[] | select(.impact == "high") | "\(.time) [\(.currency)] \(.event) - Actual: \(.actual)"'

Supported Portals & Market Domains

Direct, unthrottled access across four distinct financial domains.

Market Source Domain Python Scraper Module Primary Assets Tracked
Forex forexfactory.com forex_pytory.core.scraper.forex_factory_scraper Global fiat pairs (USD, EUR, GBP, JPY, CAD, AUD, NZD, CHF)
Cryptocurrency cryptocraft.com forex_pytory.core.scraper.crypto_craft_scraper Major digital assets, difficulty adjustments, network hardforks
Energy energyexch.com forex_pytory.core.scraper.energy_exch_scraper WTI Crude, Brent, Natural Gas, EIA Storage Reports
Precious Metals metalsmine.com forex_pytory.core.scraper.metals_mine_scraper Gold, Silver, Platinum, COMEX Vault Deliveries