HKEx Filing Scraper — Docs

An open-source Python tool that scrapes 25+ years of Hong Kong Stock Exchange (HKEx) regulatory filings and ingests them into any of nine databases — with full-text and table extraction, chunk-level coverage, optional graph linking, and a hosted MCP gateway so AI agents can query HKEx live.

Try the hosted endpoint Getting started AI agent support GitHub

Start here

• What's new
• Getting started
• Database sinks (support matrix)
• Configuration reference
• CLI reference
• MCP server
• Live MCP gateway — the hosted, no-install endpoint
• AI agent support
• Try it locally (examples/)

Per-sink guides

Every sink is a first-class destination. Rows are in the documented popularity order.

• postgres — PostgreSQL
• mysql — MySQL and MariaDB
• sqlite — SQLite
• mongodb — MongoDB
• mariadb — MySQL and MariaDB
• neo4j — Neo4j
• clickhouse — ClickHouse
• duckdb — DuckDB
• surrealdb — SurrealDB

Operations

• Architecture
• Troubleshooting
• Testing
• De-risking register
• Legal & Terms of Use

Releasing

• How to make a release
• Release automation reference
• Upgrading

Decisions

• ADR 0001 — Versioning and release automation
• ADR 0002 — Multi-sink architecture
• ADR 0003 — Sink support policy
• ADR 0004 — Publish to PyPI

Project

• Documentation style guide
• README
• Contributing
• Changelog