First public release of the HKEx Filing Scraper — an open-source Python tool to scrape and ingest 25+ years of Hong Kong Stock Exchange regulatory filings into SurrealDB.
Key Features
- Scrapes the full history of HKEx filings from April 1999 to present via an undocumented JSON API
- Downloads and extracts full text from PDF, HTML, and Excel documents
- Extracts structured tables using Camelot and substitutes them inline
- Optional graph linking:
(company)-[has_filing]->(filing)and(filing)-[references_filing]->(company) - Resilient pipeline with parallel downloads, batch upserts, and recursive retry
- Configurable via environment variables with zero hardcoded dependencies
- Modern Python package with CLI, type hints, and unit tests
Installation
pip install "hkex-filing-scraper[all]"See the README for full documentation.