Skip to content
Conduit

skill

twse-api

The skill for the Taiwan Stock Exchange (TWSE) OpenAPI — stock quotes, P/E & dividend yield, TAIEX history, financial statements, ESG data. 143 endpoints, no API key required.

NanookAI/twse-apicommunitylistedunreviewed
Use skill

Set up

Skills are installed by placing their folder where your agent loads skills.

Download ZIP from GitHub Open the repository

The download comes from github.com/NanookAI/twse-api itself, not from our server, so what you get is exactly what its author published.

Install instructions come from the README

Skills do not use an MCP config. Follow the steps in the README below.

README

synced Oct 17, 2026

TWSE API Skill

A Claude Code skill for the official Taiwan Stock Exchange (TWSE) OpenAPI (臺灣證券交易所開放資料 API, https://openapi.twse.com.tw). It teaches the AI how to query all 143 endpoints — free, no API key, no registration.

What's covered

Category (原分類)EndpointsContents
Securities Trading (證券交易)36Daily OHLC quotes, P/E · dividend yield · P/B, margin balances, block trades, day trading, attention/disposition stocks, market calendar
Corporate Governance (公司治理)56Company profiles, insider/director holdings, material news, dividends, shareholder meetings, 21 ESG datasets
Financial Statements (財務報表)30Monthly revenue, income statements & balance sheets by industry format, profitability summaries
Indices (指數)5TAIEX, Taiwan 50, Formosa Index histories
Broker Data (券商資料)9Securities firm directories, personnel, monthly financials
Warrants (權證)3Warrant issuance and trading stats
Miscellaneous (其他)4TWSE news/events, government bonds, funds

The skill also documents the pitfalls an AI needs to know: ROC (民國) date format, Chinese vs. English JSON keys, comma-formatted number strings, snapshot-only data (no historical query parameters), and the TWSE/TPEx split.

Installation

ClawHub

clawhub install twse-api

Skill page: https://clawhub.ai/skills/twse-api

Claude Code (plugin marketplace)

This plugin is distributed through the NanookAI/skills marketplace. Inside Claude Code, run:

/plugin marketplace add NanookAI/skills
/plugin install twse-api@nanookai-skills

The skill is then available in every project, and /plugin marketplace update picks up new versions.

Manual

Copy skills/twse-api/ into your project's .claude/skills/ directory (or ~/.claude/skills/ for all projects).

Usage

Once installed, just ask Claude about Taiwan stocks — the skill triggers automatically. Examples:

  • "台積電今天的收盤價和本益比是多少?"
  • "Get the TAIEX index history and plot the last month"
  • "列出上市公司股利分派情形,找出殖利率最高的 10 檔"

Repository layout

skills/twse-api/
├── SKILL.md           # Main skill: conventions, quick start, task→endpoint cheat sheet
└── references/        # Per-category endpoint catalogs with exact JSON response keys

Endpoint data is derived from the official Swagger spec (https://openapi.twse.com.tw/v1/swagger.json) and verified against live API responses. Chinese endpoint titles from the official docs are preserved as comments.

License

MIT

↑↓ navigate openesc close