nzxplorer-mcp

NZXplorer MCP 服务

一个 MCP（模型上下文协议） 服务，可让 Claude Desktop、Cursor、VS Code 和 Claude Code 等 AI 助手通过 NZXplorer API 直接访问新西兰股票市场数据。

通过自然语言查询 130 家 NZX 上市公司、1,300 多名董事、162,000 多条每日股价、治理风险评分、4,100 多笔内部人交易、64,000 多则公司公告、董事会构成分析、异常检测、市场信号、代理顾问投票建议，以及包含 87 多项指标的强大股票筛选器。

一键安装

**无需注册（最简单）：**让任意 MCP 客户端连接远程端点——无需 API 密钥，提供 23 个只读工具，每个 IP 每小时可调用 30 次、每天可调用 100 次：

{ "mcpServers": { "nzxplorer": { "url": "https://mcp.nzxplorer.co.nz" } } }

在 Claude Desktop / claude.ai 中：Settings → Connectors → Add custom connector → 粘贴 https://mcp.nzxplorer.co.nz。在 Claude Code 中：claude mcp add --transport http nzxplorer https://mcp.nzxplorer.co.nz。

如需使用完整工具集，请提供 API 密钥（可在 nzxplorer.co.nz/developers 免费获取）：

客户端	安装
Cursor	添加到 Cursor（深度链接）
VS Code	添加到 VS Code（深度链接）
Claude Code	claude mcp add nzxplorer -- npx -y nzxplorer-mcp
Claude Desktop / Windsurf / Goose	npx -y @smithery/cli@latest install @mambaventures/nzxplorer-mcp --client claude（将 claude 替换为 windsurf / goose）
任意客户端（Smithery）	通过 Smithery 安装

安装后，请在 NZXplorer Settings → API & Developer 页面设置 NZXPLORER_API_KEY。

快速安装（npm）

npx nzxplorer-mcp

或全局安装：

npm install -g nzxplorer-mcp

可用工具（58）

工具	描述
get_companies	列出 NZX 公司，支持搜索和行业筛选
get_company	按股票代码查询公司详情，可选择包含董事、财务数据、治理评分和最新价格
get_directors	按姓名搜索董事，或按公司筛选
get_director	董事档案，包含简介、任职情况、内部人士交易、董事会费用和高管薪酬
get_stock_prices	每日 OHLCV 价格数据，支持日期范围和回溯筛选
get_governance_scores	所有 130 家 NZX 公司的治理风险评分（0-100），涵盖 6 个组成部分
search_announcements	对 64,000 多条 NZX 公告（2017-2026）进行全文搜索
get_insider_trades	董事股份交易，包括买入、卖出和行权。支持按股票代码、董事、日期和类型筛选
get_financials	标准化财务报表，包括损益表、资产负债表、现金流量表和比率。FY2010-2025
get_earnings	结构化业绩结果，包括收入、利润、每股收益和指引。从 NZX PDF 中提取
get_dividends	股息历史，包括每股股息、抵免、股息再投资计划和支付日期。另含股息安全性指标
get_technical_signals	技术指标，包括 SMA-50/100/200、RSI-14、黄金交叉/死亡交叉和成交量比率
screen_stocks	使用 87 多项指标、12 个智能预设和自定义筛选条件（例如 PE<15、RSI<30）筛选股票
get_performance	股票表现，包括回报率（1D-5Y）、相对 NZX50 的 Alpha、波动率、Beta 和 52 周区间
get_director_due_diligence	全面的董事尽职调查报告，包含 8 张表、11 个部分
get_market_signals	市场情报动态，包含 10 种信号类型，汇总所有 NZX 公司的事件流
get_anomalies	异常检测，涵盖 5 个类别（内部人士、治理、财务、市场、股东周年大会）中的 12 种类型
get_proxy_report	代理顾问投票建议，针对每项股东周年大会决议给出赞成/反对/转交建议，包含 34 条规则和 8 个政策预设
get_takeovers	并购和收购活动，包含 313 笔交易、51 家发行人和 11 种交易类型（2017-2026）
get_board_changes	董事会变动，包括任命、辞职和退休。105 家发行人共 1,242 项变动
get_board_composition_report	董事会构成分析，包括独立性、多元化、任期、技能、继任风险和同业比较
get_accounting_quality	会计质量评分，包括 Beneish M-score、Piotroski F-score、Altman Z-score、利息覆盖率、流动比率和总体评级
get_credit_ratings	S&P、Moody's、Fitch、AM Best 的信用评级，包括评级、展望、行动和历史记录
get_risk_language	风险措辞评分，涵盖 8 个类别（持续经营、契约、诉讼等），覆盖 64K 多条公告
search_keyword_trends	NZX 公告中的关键词频率趋势，相当于公司文件的 Google Trends
list_stewardship_reports	列出符合 FMA 要求的尽责管理/投票记录报告（企业版）
get_stewardship_report	尽责管理报告详情，包含逐公司决议分析（企业版）
list_voting_policies	列出代理顾问引擎的自定义投票政策（企业版/机构版）
get_revenue_segments	收入分部明细，包括 IFRS 8 规定的经营、地理和产品分部
list_alert_subscriptions	列出提醒订阅，包括 11 种信号类型、6 种异常类别和 HMAC-SHA256 Webhook（企业版）
get_capital_raises	融资历史，涵盖 130 家发行人的 11,088 项事件（配售、供股、SPP、回购、股息再投资计划）
get_semantic_search	对 64K 多条公告进行 AI 语义搜索，采用关键词+向量+重排序混合方式
get_iod_designations	IoD 认证董事，包括 NZX 董事会中的 CFInstD、CMInstD、CDir、MInstD 资质
get_board_skills_matrix	董事会技能矩阵，涵盖 12 个 IoD NZ/ASX 类别、差距分析和多元化评分
get_research_briefing	投资研究简报，整合 15 多个数据源、AI 叙述和 4 种模板（通用/投资论点/尽职调查/董事会）
get_fund_votes	基金管理人的投票记录，包括 Harbour、Devon、Mint、Fisher、NZ Super Fund。逐项决议列出赞成/反对/弃权
get_deal_advisers	交易顾问，包括为融资和收购提供建议的律所、投资银行和估值机构
get_company_directorships	来自 NZ Companies Register 的完整董事任职历史，涵盖 NZX 公司和私人公司，以及状态和失败率
get_director_workload	工作量分析，包括 NZX 董事会席位、Companies Office 职务、兼任过多董事职位的风险、出席情况和任期
get_director_network	交叉董事任职和董事会关联分析，支持公司、董事或整个 NZX 范围的模式
get_board_pipeline	近期腾出任职空间的董事，包括辞职、退休以及可供招聘的人才
get_financials_xbrl	机器可读的 iXBRL 损益表、资产负债表和现金流量表，含 IFRS 分类标准标签。116 家公司，FY2010-2025
get_esg_xbrl	机器可读的 NZ CS 1-3 标签化 ESG/气候披露，包括范围 1/2/3 排放、多元化、安全以及 GRI/TCFD/SBTi/SDG
get_announcement_sentiment	对 NZX 公告进行 AI 情绪评分（-1 至 +1），并提供置信度、模糊措辞、隐含风险和指引方向
get_ir_quality	投资者关系披露质量评分（0-100），涵盖 5 个维度：及时性、完整性、可读性、频率和治理透明度
get_peer_mentions	从 62,000 多条 NZX 公告中提取公司间提及，包括谁提及谁以及上下文片段
get_political_connections	与 NZX 公司或其董事相关的议员利益、政治捐助者和政党捐款
get_management_team	现任 C-suite（CEO/CFO/COO/CTO 等），包括职位、任期和简介。127 家发行人，508 位高管
get_beneficial_ownership	穿透托管人代持，查看 NZX 持股背后的基金管理人。56 家基金管理人，涵盖 KiwiSaver/ETF/主权基金
get_substantial_holder_notices	分类 SPH 通知，提取持有人、持股比例和方向（增加/减少/初始/终止）。9,700 多条通知
get_corporate_giving	企业捐赠、赞助和社区投资，包括受赠方、金额、类型及与慈善机构的关联
get_property_portfolio	REIT/房地产公司投资组合，包括地址、账面价值、资本化率、WALE、入住率、租户和开发储备
get_fair_value	通过 DCF、股息折现和 EV/EBITDA 模型估算每股公允价值。该估值仅为估算，并非目标价
get_governance_scorecard	公司治理评分卡，涵盖 15 个符合 NZSA/NZX 政策的领域，提供红黄绿评级和 0-100 总分
check_insolvency_status	按个人标识查询 MBIE Insolvency Register，包括破产、无资产程序和简易分期付款令
get_officer_history	公司完整的历史高管任职时间线，包括所有曾任职的董事和高管，以及任职起止日期、任期、委员会和状态
get_compensation_benchmark	按职位（CEO/CFO/COO/董事会主席/董事等）提供 NZX 薪酬的 P10/P25/P50/P75/P90 百分位数，并按行业和市值层级细分
get_daily_market_wrap	NZX 每日市场综述，包括价格变动、市场广度（上涨/下跌股票）、公告、内部人士交易、即将支付的股息、董事会变动及 AI 叙述摘要

设置

1. 获取 API 密钥

在 nzxplorer.co.nz/developers 获取免费 API 密钥。

2. 配置 Claude Desktop

将以下内容添加到 Claude Desktop 配置文件（macOS 上的 ~/Library/Application Support/Claude/claude_desktop_config.json）：

使用 npx（推荐）：

{
  "mcpServers": {
    "nzxplorer": {
      "command": "npx",
      "args": ["-y", "nzxplorer-mcp"],
      "env": {
        "NZXPLORER_API_KEY": "your_api_key_here"
      }
    }
  }
}

使用本地安装：

{
  "mcpServers": {
    "nzxplorer": {
      "command": "node",
      "args": ["/absolute/path/to/nzxplorer-mcp-server/build/index.js"],
      "env": {
        "NZXPLORER_API_KEY": "your_api_key_here"
      }
    }
  }
}

2b. 或配置 Cursor

将以下内容添加到 Cursor 的 MCP 设置（项目中的 .cursor/mcp.json 或全局配置）：

{
  "mcpServers": {
    "nzxplorer": {
      "command": "npx",
      "args": ["-y", "nzxplorer-mcp"],
      "env": {
        "NZXPLORER_API_KEY": "your_api_key_here"
      }
    }
  }
}

示例提示词

连接后，你可以向 Claude 提出类似的问题：

• “NZX 上治理评分最高的公司有哪些？”
• “展示 Air New Zealand 的董事会成员及其背景”
• “获取 Fisher & Paykel Healthcare 过去 30 天的股价”
• “搜索 Spark 在 2025 年发布的股息公告”
• “哪些 NZX 公司治理评分低于 50？”
• “展示本月 NZX 上规模最大的内幕交易”
• “谁在买入 Ryman Healthcare 的股票？”
• “FPH 的 CEO 薪酬是多少？展示其高管薪酬”
• “筛选被低估的股票：市盈率低于 15，股息收益率高于 4%”
• “找出 RSI 低于 30 的超卖 NZX 股票”
• “目前哪些股票出现了黄金交叉信号？”
• “展示 Air New Zealand 过去 5 年的财务表现”
• “目前 NZX 上是否有任何危险信号或异常情况？”
• “本周发生了哪些市场事件？”
• “Fletcher Building 是否存在内幕交易集群或治理问题？”
• “我应该如何在 Air New Zealand 的 AGM 上投票？”
• “获取 Mercury NZ 的代理投票顾问报告”
• “Spark 各项决议的投票建议是什么？”
• “分析 Fisher & Paykel Healthcare 的董事会构成”
• “Air New Zealand 董事会面临哪些继任风险？”
• “Fletcher Building 董事会最近有哪些成员加入或离任？”

环境变量

变量	必需	说明
NZXPLORER_API_KEY	是	你在 nzxplorer.co.nz/developers 获取的 API 密钥
NZXPLORER_API_URL	否	覆盖 API 基础 URL（默认值：https://nzxplorer.co.nz）

数据覆盖范围

数据	记录数	覆盖范围
公司	130	所有在 NZX 上市的发行人
董事	1,300+	现任及历任董事会成员
股票价格	162,000+	每日 OHLCV，每日更新
治理评分	130	GRS v2.0 — 6 个组成部分，0-100 分制
公告	64,000+	2017-2026 年完整 NZX 存档
内幕交易	4,100+	董事股票交易
高管薪酬	491	CEO/CFO 薪酬方案，含 STI/LTI
股东	2,400+	前 20 大股东及主要持有人
股息	1,184	单笔股息记录，含抵免数据
盈利	389	从 NZX PDF 提取的结构化业绩结果
财务指标	367	116 家公司的 41 项比率
技术信号	127	SMA、RSI、黄金交叉/死亡交叉，每日更新
筛选器	87+ 列	12 种预设、自定义筛选条件，涵盖所有公司

速率限制

层级	每分钟请求数
免费	10
Pro	100
Enterprise	500

许可证

MIT