taiwan-data-mcp 0.7.0 → 0.8.0

package/README.md

@@ -13,6 +13,9 @@
 | `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 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "taiwan-data-mcp",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "MCP server for Taiwan public data — 實價登錄、公司登記查核、165 防詐、藥品查詢、政府標案、農產行情。Query real Taiwan data from Claude, Cursor, etc.",
   "type": "module",
   "bin": {

package/src/server.mjs

@@ -4,6 +4,7 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import { ListToolsRequestSchema, CallToolRequestSchema } from '@modelcontextprotocol/sdk/types.js';
 import {
   scamCheck, companySearch, companyProfile, personCompanies, companyRisk,
+  companyRelations, companyNameCheck, companyVerify,
   realpriceSearch, realpriceLocate, realpriceArea, realpriceEstimate, realpriceRoad,
   drugSearch, drugInfo,
   tenderByCompany, tenderSearch,
@@ -68,6 +69,39 @@ const TOOLS = [
     },
     run: (a) => companyRisk(a.unified_business_no || a.name),
   },
+  {
+    name: 'taiwan_company_relations',
+    description:
+      '公司關係圖譜（盡職調查／天眼查式）：用 8 位統編查該公司的法人股東（誰持有它）、轉投資子公司（它持有誰）、推估最終母公司、整個集團規模，以及共同董監事連到的其他公司（人脈）。查母子公司、集團版圖、關係人用。資料來源：inc.com.tw。',
+    inputSchema: {
+      type: 'object',
+      properties: { unified_business_no: { type: 'string', description: '8 位統一編號，例如 04541302（鴻海）' } },
+      required: ['unified_business_no'],
+    },
+    run: (a) => companyRelations(a.unified_business_no),
+  },
+  {
+    name: 'taiwan_company_name_check',
+    description:
+      '公司名稱預查／撞名查重：給一個想取的公司名稱，回傳是否已有相同或近似的既有公司（含統編）。創業命名或盡調辨識用。回傳 core（特取名稱）、exact（完全相同）、similar（近似）。資料來源：inc.com.tw。',
+    inputSchema: {
+      type: 'object',
+      properties: { name: { type: 'string', description: '想查的公司名稱，例如「台積電」「方圓科技」' } },
+      required: ['name'],
+    },
+    run: (a) => companyNameCheck(a.name),
+  },
+  {
+    name: 'taiwan_company_verify',
+    description:
+      '用 8 位統編向經濟部商工登記公示 OpenAPI 取「即時」官方登記狀態（名稱／狀態／資本／實收／負責人／所在地／登記機關）。比一般資料庫更即時，適合確認某公司目前是否仍存續、是否已解散撤銷。資料來源：經濟部商工登記公示資料。',
+    inputSchema: {
+      type: 'object',
+      properties: { unified_business_no: { type: 'string', description: '8 位統一編號，例如 22099131' } },
+      required: ['unified_business_no'],
+    },
+    run: (a) => companyVerify(a.unified_business_no),
+  },
   {
     name: 'taiwan_realprice_search',
     description:
@@ -203,7 +237,7 @@ const TOOLS = [
 ];
 
 const server = new Server(
-  { name: 'taiwan-data-mcp', version: '0.7.0' },
+  { name: 'taiwan-data-mcp', version: '0.8.0' },
   { capabilities: { tools: {} } }
 );
 
@@ -224,4 +258,4 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
 
 const transport = new StdioServerTransport();
 await server.connect(transport);
-console.error('taiwan-data-mcp running (stdio) — 15 tools: 防詐 / 公司登記 / 實價登錄 / 藥品健康 / 政府標案 / 農產行情');
+console.error('taiwan-data-mcp running (stdio) — 18 tools: 防詐 / 公司登記·關係·盡調 / 實價登錄 / 藥品健康 / 政府標案 / 農產行情');

package/src/sources.mjs

@@ -126,6 +126,37 @@ export async function companyRisk(idOrName) {
   };
 }
 
+// 公司關係圖譜（天眼查式）：法人股東／轉投資子公司／最終母公司／集團規模／共同董監事人脈。
+export async function companyRelations(id) {
+  const tin = String(id || '').replace(/\D/g, '');
+  if (tin.length !== 8) return { error: '統一編號必須是 8 位數字' };
+  const { ok, status, body } = await fetchJson(`https://inc.com.tw/api/relations/${tin}`, { timeout: 20000 });
+  if (status === 404) return { error: `查無此統一編號 ${tin}` };
+  if (!ok || !body) return { error: '查詢失敗（inc.com.tw）', unified_business_no: tin };
+  return body; // 已自帶 source / profile_url / note
+}
+
+// 公司名稱預查／撞名查重（創業命名、盡調辨識用）。
+export async function companyNameCheck(name) {
+  const q = String(name || '').trim();
+  if (q.length < 2) return { error: '公司名稱至少 2 個字' };
+  const { ok, body } = await fetchJson(`https://inc.com.tw/api/namecheck?name=${encodeURIComponent(q)}`);
+  if (!ok || !body) return { error: '查詢失敗（inc.com.tw）', query: q };
+  return { query: q, ...body, note: '名稱比對僅供命名參考；正式設立以經濟部名稱預查核准為準', source: '台灣公司登記網 inc.com.tw' };
+}
+
+// 官方即時查證：經濟部商工登記公示 OpenAPI 的「目前」登記狀態（比快取更即時）。
+export async function companyVerify(id) {
+  const tin = String(id || '').replace(/\D/g, '');
+  if (tin.length !== 8) return { error: '統一編號必須是 8 位數字' };
+  const { ok, body } = await fetchJson(`https://inc.com.tw/api/verify?id=${tin}`, { timeout: 15000 });
+  if (!ok || !body) return { error: '查詢失敗（inc.com.tw）', unified_business_no: tin };
+  if (!body.ok) return { unified_business_no: tin, verified: false, note: body.note || '官方查證暫時無回應', source: '經濟部商工登記公示資料' };
+  return { unified_business_no: tin, verified: true, name: body.name, status: body.status, capital: body.capital,
+    paid_in_capital: body.paid, representative: body.responsible, location: body.location, register_organization: body.regOrg,
+    source: body.src || '經濟部商工登記公示資料' };
+}
+
 // ── 農產批發行情 MOA（農業部農產品交易行情）──────────────────────
 function _rocToAd(s) {
   const m = String(s || '').match(/^(\d{2,3})\.(\d{2})\.(\d{2})$/);