Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

HKEx Filings

✓ ascent-partners.com

von simonmak-ascentVersion 2.4.3i★ 18 (Sterne gehören zu einem anderen Repo)iComputer oder CloudOffizielle Website ↗
Name in der Registrycom.ascent-partners/hkex-filings

So installierst du es

What it does

Live HKEx (Hong Kong Stock Exchange) regulatory filings for AI agents.

  • Connects Computer oder Cloud
  • Account or key No key needed
  • Category Recht & Behördendaten

Warum es hier steht

Dieser Eintrag steht im Tab „Apps, die sich mit KI verbinden“, der ohne Sterne in dieser Reihenfolge sortiert

1. In Claudes Connector-VerzeichnisNein
2. Vom Team getestetNein
3. Für Nutzer in Thailand geeignetNein
4. Nutzung ohne Sterne20/100Beliebtheit 0 · Aktualität 12 · Antwortet noch 8 · Likes von Nutzern +0
5. Eingetragen am2026-10-14

Likes von Nutzern: 0 · Höchstens 5 Punkte (1 pro Person). Nicht käuflich.

Qualität: 4/5 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte HKEx Filings. Folge https://mcp.popnx.com/i/ascent-partners-hkex-filings.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

4/5 Prüfungen bestanden · Was du fragst, läuft über den Server des Anbieters (hkex-listco-updates.ascent-partners.com) · ✓ Befehle geprüft am 13. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude · etwa 2 Min.

Kein Schlüssel, nichts zu installieren · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu

  1. Öffne die Connectors-Seite von Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Klicke „Add“ → „Custom“ → „Web“ und fülle diese 2 Felder aus

    Kopiere jeden Wert in das gleichnamige Feld in Claude und klicke Continue

    Name · NameHKEx Filings
    Remote MCP server URL · Adressehttps://hkex-listco-updates.ascent-partners.com/api/mcp

    Klicke auf der von Claude erkannten Anmelde-Seite auf Continue · wähle bei Authentication, was der Anbieter angibt (Sign in now, Sign in when needed oder No sign in), dann Add

  3. Im Chat einschalten

    +ConnectorsHKEx Filings

  4. Ausprobieren

    Nutze HKEx Filings und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es HKEx Filings nutzt, oder ein Werkzeug von HKEx Filings in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit ChatGPT je nach Tarif

Volles MCP: ChatGPT Business, Enterprise oder Edu im Web · Pro: verbindet mit Lese-/Abrufrechten, Werkzeuge, die Daten ändern, gehen evtl. nicht · Plus: in der Doku nicht bestätigt; siehst du auf der Plugins-Seite eine Option für eigene MCP-Server, kannst du es versuchen · nur Web

  1. In ChatGPT im Web die Seite zum Hinzufügen von MCP öffnen

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Name und Adresse eintragen

    Namen eingeben, Adresse unter Connection einfügen, Risikohinweis abhaken und Create as a plugin klicken

    Name · NameHKEx Filings
    Connection · Adressehttps://hkex-listco-updates.ascent-partners.com/api/mcp
  3. HKEx Filings im Chat auswählen

    Neuen Chat öffnen und vor dem Tippen HKEx Filings aus deinen Plugins wählen

  4. Ausprobieren

    Nutze HKEx Filings und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn ChatGPT sagt, dass es HKEx Filings nutzt, oder ein Werkzeug von HKEx Filings in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von OpenAI abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Claude Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  2. Diesen Befehl einfügen und Enter drücken

    claude mcp add --transport http --scope user hkex-filings https://hkex-listco-updates.ascent-partners.com/api/mcp
  3. /mcp in Claude Code eingeben

    HKEx Filings sollte in der Liste als verbunden erscheinen

  4. Ausprobieren

    Nutze HKEx Filings und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es HKEx Filings nutzt, oder ein Werkzeug von HKEx Filings in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in Cursor im Agent-Modus öffnen

  3. Ausprobieren

    Nutze HKEx Filings und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es HKEx Filings nutzt, oder ein Werkzeug von HKEx Filings in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in VS Code im Agent-Modus öffnen

  3. Ausprobieren

    Nutze HKEx Filings und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es HKEx Filings nutzt, oder ein Werkzeug von HKEx Filings in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

Adresse für Apps, die über das Web verbinden

Adressehttps://hkex-listco-updates.ascent-partners.com/api/mcp

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die HKEx Filings nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Über das Web

Claude Code

claude mcp add --transport http --scope user hkex-filings https://hkex-listco-updates.ascent-partners.com/api/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "hkex-filings": {
      "url": "https://hkex-listco-updates.ascent-partners.com/api/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "hkex-filings": {
      "type": "http",
      "url": "https://hkex-listco-updates.ascent-partners.com/api/mcp"
    }
  }
}

Auf deinem Computer installiert

Claude Code

claude mcp add --scope user hkex-filings -- uvx hkex-filing-scraper hkex-scraper-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "hkex-filings": {
      "command": "uvx",
      "args": [
        "hkex-filing-scraper",
        "hkex-scraper-mcp"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "hkex-filings": {
      "command": "uvx",
      "args": [
        "hkex-filing-scraper",
        "hkex-scraper-mcp"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "hkex-filings": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "hkex-filing-scraper",
        "hkex-scraper-mcp"
      ]
    }
  }
}

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

GitHub-Sternei
18 (Sterne gehören zu einem anderen Repo)
Dieser Eintrag verweist auf das Repo einer anderen Person, daher zählen die Sterne nicht in Ranglisten
Downloads pro Wochei
19/Wo.
Bestätigte Domain
✓ ascent-partners.com
Verbindung
Computer oder Cloud
Transport
stdio, streamable-http
Neueste Versioni
2.4.3
In der Registry veröffentlichti
14. Okt. 2026
Code zuletzt geänderti
3. Nov. 2026
Zuletzt geprüft
18. Nov. 2026
Entwickler
simonmak-ascent
Pakete
pypi: hkex-filing-scraper
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Verbinden sich über das Internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Laufen auf deinem Computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Tool-Namen und -Beschreibungen genau so, wie der Server sie am 18. Nov. 2026 gemeldet hat. Geschrieben hat sie der Entwickler, nicht wir; wir zeigen sie als reinen Text.

  • get_server_info

    Report this live gateway's version, transport, and hard limits. Reads nothing.

  • search_filings

    Search live HKEx filings in a date window (at most 31 days). ``from_date``/``to_date`` accept YYYY-MM-DD or DD/MM/YYYY. All filters are optional and combine with AND semantics: ``stock_code`` matches exactly (e.g. ``01461`` or ``1461``); ``title_query``, ``category`` and ``stock_

  • list_filing_facets

    Browse what filings exist in a date window (at most 31 days) without downloading. ``from_date``/``to_date`` accept YYYY-MM-DD or DD/MM/YYYY. Returns counts of the categories (headline categories), document types, and stock codes present in the window, each sorted by frequency and

  • get_filing

    Download one HKEx document by its URL and read, page through, or search its text. ``link`` must be an HKEx document URL from search_filings (host ``www1.hkexnews.hk``); any other host is rejected. With ``extract=True`` (default) the response includes up to 30 ``tables`` and a win

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 19. Nov. 2026

  • ! Vorsicht

    Entwickler passt zum Repo

    Der Herausgeber (ascent-partners.com) ist nicht der Repo-Inhaber (simonmak-ascent); vielleicht hat jemand anderes ihn eingetragen

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: vor 16 Tagen

  • ✓ Bestanden

    Hat eine Lizenz

    Nutzt MIT

  • ✓ Bestanden

    Endpunkt antwortet

    Antwort in 1262 ms (HTTP 200)

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Keine Anmeldung nötig

  • ✓ Bestanden

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Wir haben 4 Tool-Beschreibungen gelesen und keine versteckten Anweisungen an die KI gefunden

Veröffentlichte Schwachstellen (OSV.dev)

Keine Einträge auf OSV.dev für hkex-filing-scraper@2.4.3

Prüft nur diese Paketversion, nicht alle Abhängigkeiten · geprüft 15. Nov. 2026

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/ascent-partners-hkex-filings.svg)](https://mcp.popnx.com/en/servers/ascent-partners-hkex-filings)

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Recht & Behördendateni

  • Mehr Sterne als 0 % der anderen 1948 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 46 % der anderen 1948 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 51 % der anderen 1948 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist HKEx Filings sicher?

Er hat 4 von 5 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.

Läuft er auf meinem Computer oder in der Cloud?

Beides geht: Installiere ihn auf deinem Computer oder verbinde dich mit der Cloud-Version.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vor 16 Tagen geändert, und die neueste Version (2.4.3) kam vor 36 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL und funktioniert daher auch in Apps mit Remote-MCP, etwa ChatGPT im Web (volles MCP ab Business; Pro nur lesend).

Was kann ich stattdessen nutzen?

In derselben Kategorie: Global law, Open Legal Data (Germany), LibreJustice, InfraNode, Fedlex Connector

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Global law

The law of nearly every country on earth, any date: read it, see what changed it, check citations.

von lexifinaWeit verbreitet★ 2096Aktualisiert vor 9 Tagen

Läuft in der Cloud✓ lexifina.com

LibreJustice

Search French-language and European case law and French legal texts (codes, statutes, treaties).

von librejusticeAm Anfang★ 36Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · librejustice.fr

InfraNode

Keyless open data for 84 German cities: 12 lean read-only MCP tools covering 67 data types.

von street1983nkAm Anfang★ 18Aktualisiert vor 5 Monaten

Läuft in der Cloud✓ vom Dienst · infranode.dev

Fedlex Connector

Search Swiss federal legislation: laws, articles, amendments via the Fedlex SPARQL endpoint.

von JayTheSkierAm Anfang★ 8Aktualisiert vor 7 Monaten

Läuft in der Cloud✓ vom Dienst · fedlex-connector.ch
Im Vergleich mit ähnlichen
Dieser
HKEx Filings
Global lawOpen Legal Data (Germany)LibreJusticeInfraNodeFedlex Connector
Läuft woIn der Cloud oder auf deinem RechnerLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine Installation
Braucht SchlüsselNeinNeinNeinNeinNeinNein
Mit + in Claude hinzufügenNeinNeinNeinNeinNeinNein
Basisprüfungen4/54/44/44/44/44/4
LizenzMITNOASSERTIONMITApache-2.0Apache-2.0MIT
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

HKEx Filing Scraper

An open-source scraper for 25+ years of HKEx regulatory filings — into any of nine databases, with full-text extraction, graph linking, and a read-only MCP server for AI agents.

Overview

The US has EDGAR full-text search. Japan has EDINET. Hong Kong has a search form that returns one page at a time. There is no bulk, machine-readable, full-text corpus of HKEx filings. This builds one.

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

It speaks the undocumented HKEx JSON API directly, which is faster and more resilient than driving a browser.

Vendors & Integrations

Databases — nine first-class destinations, in documented popularity order (see the support matrix):

  • PostgreSQL — production-grade open-source relational
  • MySQL / MariaDB — GPL relational servers, one driver
  • SQLite — zero-server file database, no install needed
  • MongoDB — document database
  • Neo4j — property-graph database
  • ClickHouse — columnar analytics engine
  • DuckDB — in-process analytical engine
  • SurrealDB — multi-model graph + document database

AI clients — any MCP-capable agent; ready-made configuration for Claude, ChatGPT, Cursor, VS Code/Copilot, Gemini CLI, opencode, Manus, and Perplexity.

Available on — PyPI · Glama · MCP Registry · hosted gateway.

Two Ways to Use It

Hosted MCP gatewayLocal pipeline
WhatA public endpoint you point an AI agent atThe hkex-scraper CLI
SetupNone — paste a URLpip install + one environment variable
DataLive from HKEx, nothing storedStored in your database(s)
DocsLive MCP gateway · AI agent supportGetting started

Use the Hosted MCP Gateway

POST, Streamable HTTP, no API key:

https://hkex-listco-updates.ascent-partners.com/api/mcp

Four read-only tools: get_server_info, search_filings (a window of at most 31 days, with optional stock-code, title, document-type, category, and stock-name filters), list_filing_facets (browse what a window contains), and get_filing (downloads one document and extracts its text and tables).

Point a client at it — for example opencode:

{

"$schema": "https://opencode.ai/config.json", "mcp": { "hkex-live": { "type": "remote", "url": "https://hkex-listco-updates.ascent-partners.com/api/mcp" } } }

Then ask:

Use hkex-live to list the filings published between 2026-09-01 and 2026-09-18,

then summarise the interim report.

Ready-made configuration for Claude, ChatGPT, Cursor, VS Code/Copilot, Gemini CLI, opencode, Manus, and Perplexity is in AI agent support — and for a stored corpus, the stdio MCP server exposes a wider tool catalog and is published on Glama. The gateway is listed in the official MCP Registry as com.ascent-partners/hkex-filings.

Featured on Glama — the read-only stdio MCP server is also published on

Glama, where Glama scans the

built server and scores tool-definition quality (currently 4.7/5).

Quick Start (≤ 5 minutes)

Fastest path: no install — use the hosted gateway at https://hkex-listco-updates.ascent-partners.com/api/mcp (Streamable HTTP), or install and run locally:

pip install hkex-filing-scraper        # core; SQLite needs no server

pip install "hkex-filing-scraper[all]" # Excel + dotenv + every driver + the MCP server cp .env.example .env # then set DATABASE_TARGET (below) hkex-scraper --metadata-only --limit 100

Optional extras: excel, postgres, mysql, duckdb, mongodb, clickhouse, neo4j, mcp, pdf, all, dev.

DATABASE_TARGET is an ordered, comma-separated list of sink ids; the order decides which sink serves reads. To start with no server:

DATABASE_TARGET=sqlite

SQLITE_PATH=hkex.db

hkex-scraper runs the full pipeline (metadata + documents + graph); hkex-scraper --full-history covers everything since April 1999. The schema is created automatically. Full install options and per-sink settings are in Getting started.

Database Support

Every sink is a first-class destination; rows are in documented popularity order. The full matrix — licenses, capability differences, per-engine notes — is in Database sinks.

SinkModelLicenseExtraIdempotent upsert
postgresrelationalPostgreSQL LicensepostgresON CONFLICT DO UPDATE
mysql / mariadbrelationalGPLv2mysqlON DUPLICATE KEY UPDATE
sqliterelationalPublic domain—ON CONFLICT DO UPDATE
mongodbdocumentSSPL¹mongodbupdate_one(upsert=True)
neo4jgraphGPLv3 (Community)neo4jMERGE
clickhousecolumnarApache-2.0clickhouseReplacingMergeTree + read-merge
duckdbrelationalMITduckdbON CONFLICT DO UPDATE
surrealdbgraph + documentBSL 1.1¹—UPSERT / RELATE

¹ Source-available, not OSI-approved — labeled exceptions per ADR 0003.

Valid sink ids, in documented order: postgres, mysql, sqlite, mongodb, mariadb, neo4j, clickhouse, duckdb, surrealdb. Set one variable and the same run feeds every sink:

# Order sets read precedence.

DATABASE_TARGET=postgres,sqlite POSTGRES_DSN=postgresql://user:password@localhost:5432/hkex SQLITE_PATH=hkex.db

How This Compares

Four ways to get HKEx filings, and what each one costs you.

This projectHKEXnews web searchBrowser automation you writeLicensed HKEx feed
Bulk exportYesNo — page-at-a-timeYesYes
History to April 1999YesYes, manuallyDepends on your codeYes
Full text of documentsExtracted from PDF/HTML/ExcelNo — you open each fileYou build the extractorVaries by contract
Structured tablesExtracted to MarkdownNoYou build itVaries
Coverage verificationPer-chunk, auditableNot applicableYou build itVendor SLA
Lands in your engine9 engines, any combinationNoWhatever you wire upUsually one format
SpeedJSON API, no browserManualSlower — renders pagesFast
CostFree, MITFreeYour timeSubscription
Commercial redistributionSee docs/legal.mdRestrictedRestrictedLicensed

If you need licensed, redistributable, SLA-backed data, buy the feed. If you need a complete local corpus for research, compliance, or RAG, this replaces the pipeline you would otherwise write yourself.

How It Works

flowchart LR

A[HKEx JSON API] --> B[Phase 1: metadata] B --> C[Canonical record] C --> D{DATABASE_TARGET} D --> E[(PostgreSQL)] D --> F[(MySQL / MariaDB)] D --> G[(SQLite)] D --> H[(MongoDB)] D --> I[(Neo4j)] D --> J[(ClickHouse)] D --> K[(DuckDB)] D --> L[(SurrealDB)] B --> M[Graph linking] M --> D B --> N[Phase 2: download and extract] N --> C

  • Phase 1 scrapes filing metadata through a JSF session, splitting the range into monthly chunks and deduplicating on a 16-character MD5 filingId.
  • Phase 2 downloads each filing's PDF/HTML/Excel document, extracts text and tables to Markdown, and writes the payload.
  • Graph linking (optional) writes has_filing and references_filing edges when COMPANY_TABLE is set.
  • Failure isolation — a failure on one sink is logged and counted but never blocks another; the run exits non-zero if any configured sink failed.

Deeper detail: Architecture · ADR 0002.

HKEx API session

sequenceDiagram

autonumber participant C as hkex-scraper participant J as HKEx site (JSF) participant A as HKEx JSON servlet C->>J: GET /search/titlesearch.xhtml J-->>C: HTML + javax.faces.ViewState C->>J: POST form (from/to dates + ViewState) C->>A: GET /search/titleSearchServlet.do (rowRange paging) A-->>C: JSON page of filings Note over C: generate_monthly_chunks() splits ranges > 1 month C->>C: dedupe on 16-char MD5 filingId

Data model

erDiagram

COMPANY ||--o{ EXCHANGE_FILING : has_filing EXCHANGE_FILING ||--o{ DOCUMENT : has_document EXCHANGE_FILING ||--o{ EXCHANGE_FILING : references_filing EXCHANGE_FILING ||--o{ SCRAPE_COVERAGE : chunk_of EXCHANGE_FILING { string filingId "16-char MD5" string stockCode string title datetime dateTime } DOCUMENT { text documentText array documentTables } SCRAPE_COVERAGE {

Nur der Anfang wird gezeigt; den Rest findest du im Repo