Taiwan Stocks

@pipeworx/taiwan-stocks

台湾股票 MCP — 提供在台湾证券交易所（TWSE，上市）和台北证券交易所（TPEx，上櫃）上市公司的价格、估值、月营收、公告、融资余额和股息日期。无需密钥。

属于 Pipeworx — 一个连接 AI Agent 与 1683+ 个实时数据源的 MCP 网关。

工具

• taiwan_stock_quote(symbols) — 每日开盘价、最高价、最低价、收盘价、涨跌额、成交股数和 TWD 成交额。涵盖两个市场。
• taiwan_search_securities(query, market?, limit?) — 根据公司名称、英文简称或代码查找上市证券。
• taiwan_company_profile(symbol) — 行业、董事长、总经理、成立和上市日期、实收资本、流通股数、审计师、网站。台湾证券交易所主板。
• taiwan_market_summary(days?) — TAIEX 和 TPEx 指数点位，以及每个交易日的全市场成交额、成交量和成交笔数。
• taiwan_stock_valuation(symbols) — 各交易所每日发布的市盈率、股息收益率和市净率。
• taiwan_monthly_revenue(symbol?, industry?, limit?) — 月营收，包含月环比、同比和年初至今变化；也可按营收增长率对行业排名。
• taiwan_material_news(symbol?, query?, limit?) — 当日强制公告（重大訊息）：董事会决议、并购、诉讼、增资。
• taiwan_top_traded(limit?) — 当日成交最活跃的 20 只台湾证券交易所证券。
• taiwan_foreign_holdings(mode?, limit?) — 按证券或行业查看外资和中国大陆持股，以及法定持股上限的剩余空间。
• taiwan_margin_balance(symbols) — 融资和融券余额、当日交易情况及额度。
• taiwan_ex_dividend_calendar(symbol?, limit?) — 已公布的除息和除权日期，以及现金和股票条款。

身份验证

无需验证。两个交易所均将这些数据作为开放数据发布，无需密钥，也没有调用限额。

输入约定

所有接受证券代码的工具都支持以下三种形式，且可互换使用：

形式	示例
数字代码	2330、2330.TW、6488
英文简称（交易所官方简称）	TSMC、HON HAI
中文名称	台積電、鴻海

无需查询公司信息即可直接使用代码，因为 ETF 和权证虽在台湾证券交易所交易，却不会出现在公司主数据中。

注意事项

• 一个 API 中有两种日历。 大多数端点使用中华民国纪年 （1150819 = 2026-08-19，11507 = 2026-07）；MI_INDEX20 和 TPEx 指数 历史使用公历日期（20260819）。此工具包会将两种日期统一转换为 ISO 格式。
• 部分 JSON 键末尾带有空格——公告数据流的主题字段实际为 "主旨 "。摄取数据时会修剪所有键。
• 这些是全市场文件，而非单只证券端点。 不存在 /quote/2330；最小单位是“今天所有有交易的证券”（TWSE 为 318 KB，TPEx 约 4 MB）。此工具包会获取市场文件，在隔离环境中缓存 5 分钟，并始终先尝试较小的 TWSE 文件，失败后再转向 TPEx。
• TPEx 拒绝来自 Cloudflare 的出口流量（已知问题）。 从已部署的网关访问时，www.tpex.org.tw 会返回 HTTP 520，随后陷入重定向循环并进入 /errors；在笔记本电脑上使用完全相同的 URL，以及 worker 的精确 User-Agent 和 Accept 标头，则会返回 200，因此问题在出口 IP，而非请求本身。网关注入出口中继时，此工具包会通过出口中继访问 TPEx；如果中继返回 host_not_allowed，则会改用直接出口，因此两者可以按任意顺序部署。www.tpex.org.tw 已加入中继的允许列表源，但边缘函数尚未重新部署——在重新部署前，TPEx 调用会失败，且所有工具都会降级处理而非抛出异常：TWSE 结果会完整返回，同时包含 tpex_unavailable: true 和原因；OTC 证券则会返回 reason: "tpex_unreachable"，而非空结果。无法访问的 OTC 证券与不存在的证券会返回不同结果。
• 覆盖范围划分。 报价、估值和融资融券余额涵盖两个市场。公司简介、月营收、公告、外资持股和除息日历均来自 TWSE 主板文件；对于 TPEx 证券，会返回 found: false 并附上说明原因，而非空结果。
• 发布时间。 两家交易所都会在台北时间 13:30 收盘后发布数据，因此在此之前显示的最新交易日是前一个交易日。
• 月营收金额以 新台币千元 计；融资融券余额以 1,000 股为一张 计。

数据来源

• TWSE 开放数据 — https://openapi.twse.com.tw/v1 (规范)
• TPEx 开放数据 — https://www.tpex.org.tw/openapi/v1 (规范)

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "taiwan-stocks": {
      "url": "https://gateway.pipeworx.io/taiwan-stocks/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/taiwan-stocks/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、 discover_tools、search_within、remember/recall 和网关范围内的其他工具。因此，你看到的工具数量会多于此表中的数量：目前，单个工具包端点会列出约 30 个共享工具，以及该工具包自身的工具。连接的 initialize 响应会说明其确切范围，是当天情况的权威信息。

这是有意为之，并非意外的多路复用。元工具可让指定范围的连接通过 ask_pipeworx 跨整个目录路由，从而回答此工具包未涵盖的问题，无需添加第二个 MCP 服务。目前无法挂载不含这些元工具的工具包端点；如果额外的架构所占上下文超过路由功能带来的价值，请改为连接完整网关一次，而不是连接多个工具包端点。

或者连接完整的 Pipeworx 网关，直接列出每个工具包的所有工具，而不只是当前工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都会访问同一个网关和相同的 1683+ 个数据源。唯一的区别是直接列出哪个工具包的工具；无论连接哪一个，ask_pipeworx 都能访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/taiwan_stock_quote \
  -H 'Content-Type: application/json' \
  -d '{"symbols":"TSMC,2317"}'

首次调用无需账户。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/taiwan_stock_quote。查找工具：使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。

独立运行（无需网关账户）

此软件包也可以作为本地 stdio MCP 服务运行，无需 Pipeworx 账户，也无需经过网关：

{
  "mcpServers": {
    "taiwan-stocks": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-taiwan-stocks"]
    }
  }
}

或者直接运行，确认其能够启动：

npx -y @pipeworx/mcp-taiwan-stocks

它通过 stdin/stdout 使用 MCP，并响应 initialize/tools/list/tools/call，但仅支持此软件包的工具，不包含上述网关连接提供的共享元工具。相同的源代码、相同的工具，无需 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用通俗易懂的语言提问，而不是直接调用工具——这既适用于上面的软件包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Taiwan Stocks data" })

网关会选取合适的工具并自动填写参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT