taiwan-data-mcp
**[中文](#中文) | [English](#english)**
## 中文
# taiwan-data-mcp
讓 AI 助理(Claude、Cursor、任何支援 MCP 的工具)直接查 **台灣公開資料** 的 MCP server。
一句話:把散落的台灣資料站,變成 AI 可以直接呼叫的工具。資料即時來自來源站,回傳一律附上來源與連結。
## 工具
| 工具 | 功能 | 資料來源 |
|------|------|----------|
| `taiwan_scam_check` | 查網址 / 網域是否被 165 通報詐騙 | [fraud.tw](https://fraud.tw)(內政部警政署 165) |
| `taiwan_company_search` | 用公司名搜尋,拿統一編號與負責人 | [inc.com.tw](https://inc.com.tw)(經濟部公司登記) |
| `taiwan_company_profile` | 用統編查公司完整登記資料(含董監事) | inc.com.tw |
| `taiwan_person_companies` | 用人名查他擔任負責人/董監事的公司 | inc.com.tw |
| `taiwan_company_risk` | 公司風險查核(統編或公司名):解散/拒絕往來/國際制裁/金管會/司法/勞動/環保紅旗+上市櫃即時股價 | inc.com.tw |
| `taiwan_company_relations` | 公司關係圖譜:法人股東/轉投資子公司/最終母公司/集團規模/共同董監事人脈 | inc.com.tw |
| `taiwan_company_name_check` | 公司名稱預查/撞名查重(創業命名用) | inc.com.tw |
| `taiwan_company_verify` | 經濟部商工登記 OpenAPI 即時官方登記狀態 | inc.com.tw |
| `taiwan_realprice_search` | 搜尋實價登錄的地址 / 路段 / 行政區 | [housetw.com](https://housetw.com)(內政部實價登錄) |
| `taiwan_realprice_locate` | 用經緯度反查行政區與行情頁 | housetw.com |
| `taiwan_realprice_area` | 查某縣市 / 行政區成交行情統計 | housetw.com |
| `taiwan_realprice_estimate` | 自動估價:單價區間與推估總價 | housetw.com |
| `taiwan_realprice_road` | 查某路段成交行情與逐年走勢 | housetw.com |
| `taiwan_drug_search` | 用中文藥名搜尋核准藥品、取許可證字號 | [health-hub](https://health-hub-epx.pages.dev)(衛福部食藥署) |
| `taiwan_drug_info` | 用許可證字號查藥品成分/適應症/健保價/回收/短缺 | health-hub |
| `taiwan_gov_tender_by_company` | 查某公司投標/得標的政府採購案 | 政府電子採購網(g0v PCC API) |
| `taiwan_gov_tender_search` | 用標案名稱關鍵字搜尋政府採購案 | 政府電子採購網(g0v PCC API) |
| `taiwan_farm_price` | 查蔬果批發市場最新行情(菜價) | 農業部 data.moa.gov.tw |
跨工具串接是重點:例如「查這家公司 → 看它登記地址那區的房價 → 查它官網是不是詐騙」,一次問答內 AI 自己串起來。
## 安裝
需要 Node.js 18+。
### Claude Desktop
編輯 `claude_desktop_config.json`(設定 → Developer → Edit Config):
```json
{
"mcpServers": {
"taiwan-data": {
"command": "npx",
"args": ["-y", "taiwan-data-mcp"]
}
}
}
```
### Claude Code
```bash
claude mcp add taiwan-data -- npx -y taiwan-data-mcp
```
### Cursor / 其他
任何支援 MCP 的工具,指向 `npx -y taiwan-data-mcp`(stdio)即可。
## 範例提問
- 「google.com 是詐騙網站嗎?」
- 「台積電的統編、負責人、資本額是多少?」
- 「臺北市信義區的房價中位數大概多少?哪幾條路最貴?」
- 「我在經緯度 25.034, 121.5645,附近房價如何?」
## 開發
```bash
npm install
npm run smoke # 直接打活線 API,驗證 6 個工具回得出資料
node test/e2e.mjs # MCP 協定層測試
```
## 資料來源網站
本工具的資料即時來自以下網站,每筆查詢結果也都會標註來源與連結:
- 實價登錄行情 — **[housetw.com](https://housetw.com)**(實價雷達)
- 公司登記查核 — **[inc.com.tw](https://inc.com.tw)**(台灣公司登記網)
- 165 防詐查詢 — **[fraud.tw](https://fraud.tw)**(防詐雷達)
- 藥品/健康查詢 — **[health-hub](https://health-hub-epx.pages.dev)**(衛福部食藥署資料)
- 政府標案查詢 — 政府電子採購網開放資料(透過 [g0v PCC API](https://pcc.g0v.ronny.tw))
- 農產批發行情 — 農業部開放資料([data.moa.gov.tw](https://data.moa.gov.tw))
三站皆為聚合台灣政府開放資料的免費查詢服務。
## 資料與免責
資料即時取自上述各站的公開 API,內容以政府開放資料為準,僅供參考,不構成投資、法律或交易建議。詐騙查詢結果為「是否被通報」,未被通報不代表絕對安全。
## License
MIT License
## English
# taiwan-data-mcp
An MCP server that lets AI assistants (Claude, Cursor, any MCP-capable tool) directly query **Taiwan public data**.
In one sentence: it turns scattered Taiwan data sites into tools that AI can call directly. Data comes live from the source sites, and every result is returned with its source and link.
## Tools
| Tool | Function | Data source |
|------|------|----------|
| `taiwan_scam_check` | Check whether a URL / domain has been reported as a scam by 165 | [fraud.tw](https://fraud.tw) (National Police Agency, Ministry of the Interior, 165) |
| `taiwan_company_search` | Search by company name to get the unified business number and responsible person | [inc.com.tw](https://inc.com.tw) (Ministry of Economic Affairs company registration) |
| `taiwan_company_profile` | Look up a company's full registration record by unified business number (including directors and supervisors) | inc.com.tw |
| `taiwan_person_companies` | Look up by a person's name the companies where they serve as responsible person / director / supervisor | inc.com.tw |
| `taiwan_company_risk` | Company risk check (by unified business number or company name): dissolution / refused transactions / international sanctions / FSC / judicial / labor / environmental red flags + real-time stock prices for listed companies | inc.com.tw |
| `taiwan_company_relations` | Company relationship graph: corporate shareholders / reinvested subsidiaries / ultimate parent company / group size / shared director-supervisor network | inc.com.tw |
| `taiwan_company_name_check` | Company name pre-check / duplicate-name lookup (for naming a startup) | inc.com.tw |
| `taiwan_company_verify` | Real-time official registration status from the Ministry of Economic Affairs business registration OpenAPI | inc.com.tw |
| `taiwan_realprice_search` | Search real-estate actual-price registration by address / road section / district | [housetw.com](https://housetw.com) (Ministry of the Interior actual-price registration) |
| `taiwan_realprice_locate` | Reverse-look up the district and market page from latitude/longitude | housetw.com |
| `taiwan_realprice_area` | Look up transaction market statistics for a city/county / district | housetw.com |
| `taiwan_realprice_estimate` | Automatic valuation: unit-price range and estimated total price | housetw.com |
| `taiwan_realprice_road` | Look up transaction market data and year-by-year trend for a road section | housetw.com |
| `taiwan_drug_search` | Search approved drugs by Chinese drug name and get the license number | [health-hub](https://health-hub-epx.pages.dev) (TFDA, Ministry of Health and Welfare) |
| `taiwan_drug_info` | Look up a drug's ingredients / indications / NHI price / recalls / shortages by license number | health-hub |
| `taiwan_gov_tender_by_company` | Look up government procurement cases a company has bid on / won | Government e-Procurement System (g0v PCC API) |
| `taiwan_gov_tender_search` | Search government procurement cases by tender-name keyword | Government e-Procurement System (g0v PCC API) |
| `taiwan_farm_price` | Look up the latest wholesale market prices for fruit and vegetables (produce prices) | Ministry of Agriculture, data.moa.gov.tw |
Chaining across tools is the point: for example, "look up this company → see the housing prices in the district of its registered address → check whether its official site is a scam" — within a single Q&A the AI chains it together on its own.
## Installation
Requires Node.js 18+.
### Claude Desktop
Edit `claude_desktop_config.json` (Settings → Developer → Edit Config):
```json
{
"mcpServers": {
"taiwan-data": {
"command": "npx",
"args": ["-y", "taiwan-data-mcp"]
}
}
}
```
### Claude Code
```bash
claude mcp add taiwan-data -- npx -y taiwan-data-mcp
```
### Cursor / Others
For any MCP-capable tool, just point it at `npx -y taiwan-data-mcp` (stdio).
## Example questions
- "Is google.com a scam site?"
- "What are TSMC's unified business number, responsible person, and capital?"
- "Roughly what is the median housing price in Xinyi District, Taipei City? Which roads are the most expensive?"
- "I'm at latitude/longitude 25.034, 121.5645 — what are the housing prices nearby?"
## Development
```bash
npm install
npm run smoke # 直接打活線 API,驗證 6 個工具回得出資料
node test/e2e.mjs # MCP 協定層測試
```
## Data source sites
This tool's data comes live from the following sites, and every query result is also labeled with its source and link:
- Actual-price registration market data — **[housetw.com](https://housetw.com)** (RealPrice Radar)
- Company registration checks — **[inc.com.tw](https://inc.com.tw)** (Taiwan Company Registration site)
- 165 anti-fraud lookup — **[fraud.tw](https://fraud.tw)** (Fraud Radar)
- Drug / health lookup — **[health-hub](https://health-hub-epx.pages.dev)** (TFDA, Ministry of Health and Welfare data)
- Government tender lookup — Government e-Procurement System open data (via [g0v PCC API](https://pcc.g0v.ronny.tw))
- Agricultural wholesale market data — Ministry of Agriculture open data ([data.moa.gov.tw](https://data.moa.gov.tw))
All three sites are free lookup services that aggregate Taiwan government open data.
## Data and disclaimer
Data is retrieved live from the public APIs of the sites above, with content based on government open data. It is for reference only and does not constitute investment, legal, or transaction advice. A scam lookup result indicates "whether it has been reported"; not having been reported does not mean it is absolutely safe.
## License
MIT License
TDQS
Scored across 23 tools
Tools cover distinct domains (company, drug, real estate, farm, scam, tender), but within the company domain there are 9 tools that could overlap, e.g., taiwan_company_search vs taiwan_company_name_check. However, detailed descriptions clarify their specific purposes, making confusion unlikely.
All tools follow a consistent pattern: taiwan_<domain>_<action> in snake_case, with clear verbs like search, check, info, verify. No mixing of styles.
23 tools is on the high side for a single server, but the scope is broad (multiple domains). Each domain has a reasonable number of tools, and none feel superfluous.
Company domain is well-covered (search, profile, risk, relations, compare, verify, etc.). Drug, real estate, and tender have core operations. Missing some secondary features (e.g., drug interactions, real estate listings), but overall solid for the stated data sources.