taiwan-data-mcp 0.6.0 → 0.8.0

package/README.md

@@ -12,7 +12,10 @@
 | `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_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.6.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,
@@ -58,13 +59,48 @@ const TOOLS = [
   {
     name: 'taiwan_company_risk',
     description:
-      '公司風險查核（盡職調查紅旗）：用 8 位統編查該公司有無政府採購拒絕往來、勞動法令裁罰、環保裁罰，回傳風險等級與紅旗清單。資料來源：inc.com.tw（聚合政府公開資料）。',
+      '公司風險查核（盡職調查紅旗）：用 8 位統編或公司名稱（簡稱如「台積電」自動解析成正主）查該公司有無解散、政府採購拒絕往來、國際制裁名單（OFAC/UN）、金管會重大裁罰、司法案件、勞動法令裁罰、環保裁罰，回傳風險等級、紅旗清單與負責人，上市櫃並附即時股價。資料來源：inc.com.tw（聚合政府公開資料）。',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        unified_business_no: { type: 'string', description: '8 位統一編號（與 name 二擇一），例如 22099131' },
+        name: { type: 'string', description: '公司名稱或簡稱（與統編二擇一），例如「台積電」「鴻海」' },
+      },
+    },
+    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) => companyRisk(a.unified_business_no),
+    run: (a) => companyVerify(a.unified_business_no),
   },
   {
     name: 'taiwan_realprice_search',
@@ -201,7 +237,7 @@ const TOOLS = [
 ];
 
 const server = new Server(
-  { name: 'taiwan-data-mcp', version: '0.1.0' },
+  { name: 'taiwan-data-mcp', version: '0.8.0' },
   { capabilities: { tools: {} } }
 );
 
@@ -222,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

@@ -77,36 +77,86 @@ export async function personCompanies(name) {
     source: '台灣公司登記網 inc.com.tw' };
 }
 
-export async function companyRisk(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/company/${tin}`, { timeout: 20000 });
-  if (status === 404) return { error: `查無此統一編號 ${tin}` };
-  if (!ok || !body) return { error: '查詢失敗（inc.com.tw）', unified_business_no: tin };
+// 風險查核：用統編或公司名（簡稱會自動解析成正主，如「台積電」→台積電本尊）。
+// 走 inc.com.tw/api/card：比 /api/company flags 更完整（含解散/金管裁罰/司法/國際制裁），上市櫃並附即時股價。
+export async function companyRisk(idOrName) {
+  const raw = String(idOrName || '').trim();
+  if (!raw) return { error: '請提供統一編號或公司名稱' };
+  const tin = raw.replace(/\D/g, '');
+  const url = /^\d{8}$/.test(tin)
+    ? `https://inc.com.tw/api/card/${tin}`
+    : `https://inc.com.tw/api/card?name=${encodeURIComponent(raw)}`;
+  const { ok, status, body } = await fetchJson(url, { timeout: 20000 });
+  if (status === 404) return { error: `查無公司：${raw}` };
+  if (!ok || !body || body.error) return { error: '查詢失敗（inc.com.tw）', query: raw };
   const f = body.flags || {};
   const redFlags = [];
-  if (f.government_debarment) redFlags.push('政府採購拒絕往來');
-  if (f.labor_penalties) redFlags.push(`勞動法令裁罰 ${f.labor_penalties} 筆`);
-  if (f.environmental_penalties) redFlags.push(`環保裁罰 ${f.environmental_penalties} 筆`);
-  const level = f.government_debarment ? 'high' : redFlags.length ? 'medium' : 'low';
+  if (f.dissolved) redFlags.push(`登記狀態：${body.status}`);
+  if (f.reject) redFlags.push('政府採購拒絕往來');
+  if (f.sanction) redFlags.push(`命中國際制裁名單 ${f.sanction} 筆（OFAC/UN 等）`);
+  if (f.fsc) redFlags.push(`金管會重大裁罰 ${f.fsc} 件`);
+  if (f.judicial) redFlags.push(`司法案件 ${f.judicial} 筆`);
+  if (f.labor) redFlags.push(`勞動法令裁罰 ${f.labor} 筆`);
+  if (f.env) redFlags.push(`環保裁罰 ${f.env} 筆`);
+  // 重大紅旗（解散/拒往/制裁/司法/金管）→ high；僅勞動或環保 → medium；皆無 → low
+  const major = f.dissolved || f.reject || f.sanction || f.judicial || f.fsc;
+  const level = major ? 'high' : (f.labor || f.env) ? 'medium' : 'low';
   return {
-    unified_business_no: tin,
+    unified_business_no: body.id,
     name: body.name,
+    representative: body.rep || null,
     status: body.status,
-    listing: body.listing || null,
+    capital: body.capital ?? null,
+    listing: body.listed || null,
+    stock_price: body.price || null,
     risk_level: level,
     red_flags: redFlags,
     detail: {
-      government_debarment: !!f.government_debarment,
-      labor_penalties: f.labor_penalties || 0,
-      environmental_penalties: f.environmental_penalties || 0,
+      dissolved: !!f.dissolved,
+      government_debarment: f.reject || 0,
+      international_sanction: f.sanction || 0,
+      fsc_major_penalty: f.fsc || 0,
+      judicial_cases: f.judicial || 0,
+      labor_penalties: f.labor || 0,
+      environmental_penalties: f.env || 0,
     },
-    note: '裁罰以公司名稱比對，可能含同名同稱；僅供參考，以政府原始公告為準',
-    profile_url: `https://inc.com.tw/c/${tin}`,
+    note: '裁罰／名單以公司名稱比對，可能含同名同稱；僅供參考，以政府原始公告為準',
+    profile_url: body.url || `https://inc.com.tw/c/${body.id}`,
     source: '台灣公司登記網 inc.com.tw',
   };
 }
 
+// 公司關係圖譜（天眼查式）：法人股東／轉投資子公司／最終母公司／集團規模／共同董監事人脈。
+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})$/);