# HKEx Filings

MCP-сервер, который даёт ИИ-агенту доступ к 25+ годам регуляторных документов Гонконгской биржи (HKEx). Работает через публичный шлюз или локально с девятью базами данных.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 16
- Автор: simonmak-ascent
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/simonmak-ascent/hkex-filing-scraper
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/mcp/hkex-filings

## Что делает

Сервер подключается к недокументированному JSON API HKEx и возвращает агенту метаданные документов, полный текст и таблицы из PDF. Публичный шлюз `https://hkex-listco-updates.ascent-partners.com/api/mcp` работает без установки и API-ключа: четыре инструмента — поиск по окну до 31 дня с фильтрами по тикеру, типу документа и категории, список фасетов, загрузка одного документа с извлечением текста и таблиц, информация о сервере. Локальный вариант (`pip install hkex-filing-scraper`) скрапит документы в PostgreSQL, MySQL, SQLite, MongoDB, Neo4j, ClickHouse, DuckDB, MariaDB или SurrealDB и запускает stdio-сервер с расширенным набором инструментов.

Лицензия MIT, Python 3.10+. Для stdio-сервера нужен `uvx` и установленный пакет; для шлюза — только URL в конфиге агента. Сервер внесён в официальный реестр MCP как `com.ascent-partners/hkex-filings` и опубликован на Glama с оценкой качества инструментов 4.7/5.

## Требования
- Нужно: Python и uv (команды через uvx)
- Удалённый сервер: `https://hkex-listco-updates.ascent-partners.com/api/mcp`

## Установка

### Claude Code (родная платформа)

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http hkex-filings https://hkex-listco-updates.ascent-partners.com/api/mcp
```

2. **Командой платформы**
```bash
claude mcp add hkex-filings -- uvx hkex-filing-scraper
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from hkex-filing-scraper <команда>

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add hkex-filings --url https://hkex-listco-updates.ascent-partners.com/api/mcp
```

2. **Командой платформы**
```bash
codex mcp add hkex-filings -- uvx hkex-filing-scraper
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from hkex-filing-scraper <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "hkex-filings": {
            "url": "https://hkex-listco-updates.ascent-partners.com/api/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "hkex-filings": {
            "command": "uvx",
            "args": [
                "hkex-filing-scraper"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from hkex-filing-scraper <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "hkex-filings": {
            "type": "http",
            "url": "https://hkex-listco-updates.ascent-partners.com/api/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "hkex-filings": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "hkex-filing-scraper"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from hkex-filing-scraper <команда>

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http hkex-filings https://hkex-listco-updates.ascent-partners.com/api/mcp
```

2. **Командой платформы**
```bash
gemini mcp add hkex-filings uvx hkex-filing-scraper
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from hkex-filing-scraper <команда>

## Когда брать
- получить регуляторные документы компаний с Гонконгской биржи за произвольный период
- извлечь текст и таблицы из PDF-отчётов HKEx для анализа
- запросить документы HKEx из ИИ-агента без ручного скрапинга
- построить корпус полнотекстовых документов HKEx в собственной базе данных

## Примеры запросов агенту
- Подключи хостинговый шлюз `hkex-filings` и найди все документы за сентябрь 2026 года по тикеру 0700
- Через `hkex-filings` выгрузи промежуточный отчёт компании Tencent и суммируй ключевые показатели
- Скрапь последние 100 документов HKEx в SQLite командой `hkex-scraper --metadata-only --limit 100`

## Похожие
- [World Monitor](https://affpapa.org/nevibecode/mcp/world-monitor.md) — MCP-сервер · ★ 89408
- [Scrapling MCP Server](https://affpapa.org/nevibecode/mcp/scrapling-mcp-server.md) — MCP-сервер · ★ 89433
- [MCP Toolbox for Databases](https://affpapa.org/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP-сервер · ★ 16717
- [PostHog MCP Server](https://affpapa.org/nevibecode/mcp/posthog-mcp-server.md) — MCP-сервер · ★ 40409
- [dbx](https://affpapa.org/nevibecode/mcp/dbx.md) — MCP-сервер · ★ 27669
- [Metabase](https://affpapa.org/nevibecode/mcp/metabase.md) — MCP-сервер · ★ 49845

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md