Look up HKEXnews stockId mapping for a Hong Kong stock code. Diagnostic tool.

Args: stock_code: 5-digit HK stock code, e.g. "00700" or "700" refresh: Force re-download of company mappings (default: false)

List available HKEXnews announcements for a company (excludes full periodic report PDFs).

Args: stock_code: 5-digit HK stock code, e.g. "00700" category: Optional HKEX t1/t2 code or tier name (e.g. "Inside Information", "13500") start_date: YYYY-MM-DD inclusive end_date: YYYY-MM-DD inclusive title_keyword: Optional title search keyword limit: Max announcements to return, default 10, max 50

Download an HKEXnews announcement PDF (or HTML fallback) to local storage.

Args: stock_code: 5-digit HK stock code release_date: YYYY-MM-DD (optional if local_key provided) title_keyword: Title substring to disambiguate same-day announcements category: Optional category filter news_id: HKEXnews NEWS_ID if known local_key: Exact local bundle key from list results

Parse a downloaded announcement PDF/HTML into page-split JSON.

Args: local_key: Bundle key returned by list/download, e.g. "00700_13500_2026-03-15_a1b2c3d4"

Search a parsed announcement by keywords. Results sorted by relevance.

Args: local_key: Bundle key from list/download keywords: 1-5 search keywords match_mode: "ANY" or "ALL", default ANY max_results: Max snippets, default 5, max 50

Retrieve full page content for a range of pages from a parsed announcement.

Args: local_key: Bundle key start_page: 1-based start page page_count: Number of pages, default 3, max 5