taiwan-data-mcp 0.7.0 → 0.10.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.10.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, validateTaxId, findConnection,
   realpriceSearch, realpriceLocate, realpriceArea, realpriceEstimate, realpriceRoad,
   drugSearch, drugInfo,
   tenderByCompany, tenderSearch,
@@ -68,6 +69,64 @@ 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_validate_tax_id',
+    description:
+      '驗證台灣統一編號（8 碼）檢查碼是否正確（財政部統編邏輯，純演算法、不查資料庫）。資料清理、表單驗證、判斷一組號碼是否為有效統編格式用。回傳 valid 與說明。資料來源：inc.com.tw。',
+    inputSchema: {
+      type: 'object',
+      properties: { unified_business_no: { type: 'string', description: '8 位統一編號，例如 22099131' } },
+      required: ['unified_business_no'],
+    },
+    run: (a) => validateTaxId(a.unified_business_no),
+  },
+  {
+    name: 'taiwan_find_connection',
+    description:
+      '查兩家公司／兩個人之間的最短關係鏈（天眼查式盡職調查）：透過共同負責人／董監事一層層串接，回傳中間的人與公司節點與相隔層數。用於「這兩家公司／這兩個人有沒有關係、怎麼牽上線」。a、b 可填公司名、8 位統編或人名。資料來源：inc.com.tw。',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        a: { type: 'string', description: '起點：公司名／統編／人名，例如「鴻海精密工業」' },
+        b: { type: 'string', description: '終點：公司名／統編／人名，例如「三創數位」' },
+      },
+      required: ['a', 'b'],
+    },
+    run: (a) => findConnection(a.a, a.b),
+  },
   {
     name: 'taiwan_realprice_search',
     description:
@@ -203,7 +262,7 @@ const TOOLS = [
 ];
 
 const server = new Server(
-  { name: 'taiwan-data-mcp', version: '0.7.0' },
+  { name: 'taiwan-data-mcp', version: '0.10.0' },
   { capabilities: { tools: {} } }
 );
 
@@ -224,4 +283,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) — 20 tools: 防詐 / 公司登記·關係·盡調 / 實價登錄 / 藥品健康 / 政府標案 / 農產行情');

package/src/sources.mjs

@@ -95,12 +95,13 @@ export async function companyRisk(idOrName) {
   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.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';
+  // 重大紅旗（解散／拒絕往來／國際制裁／金管會重大裁罰）→ high。
+  // 司法案件以名稱比對且噪訊高（大公司常被列為當事人），與勞動／環保同列 medium，不單獨拉到 high。
+  const major = f.dissolved || f.reject || f.sanction || f.fsc;
+  const level = major ? 'high' : (f.judicial || f.labor || f.env) ? 'medium' : 'low';
   return {
     unified_business_no: body.id,
     name: body.name,
@@ -126,6 +127,55 @@ 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 || '經濟部商工登記公示資料' };
+}
+
+// 統一編號檢查碼驗證（純演算法，資料清理／表單檢核用）。
+export async function validateTaxId(id) {
+  const tin = String(id || '').replace(/\D/g, '');
+  if (tin.length !== 8) return { input: String(id || ''), valid: false, reason: '統一編號必須是 8 位數字' };
+  const { ok, body } = await fetchJson(`https://inc.com.tw/api/taxid?id=${tin}`, { timeout: 10000 });
+  if (!ok || !body) return { input: tin, valid: false, reason: '查詢失敗（inc.com.tw）' };
+  return body;
+}
+
+// 關係路徑：兩家公司／兩人之間透過共同負責人／董監事串接的最短關係鏈（天眼查式盡調）。
+export async function findConnection(a, b) {
+  const qa = String(a || '').trim(), qb = String(b || '').trim();
+  if (!qa || !qb) return { error: '請提供 a 與 b（公司名／統編／人名）' };
+  const { ok, body } = await fetchJson(`https://inc.com.tw/api/path?a=${encodeURIComponent(qa)}&b=${encodeURIComponent(qb)}`, { timeout: 25000 });
+  if (!ok || !body) return { error: '查詢失敗（inc.com.tw）', a: qa, b: qb };
+  return body; // 已自帶 from/to/path/note/source
+}
+
 // ── 農產批發行情 MOA（農業部農產品交易行情）──────────────────────
 function _rocToAd(s) {
   const m = String(s || '').match(/^(\d{2,3})\.(\d{2})\.(\d{2})$/);