taiwan-data-mcp 0.1.0 → 0.3.0

package/README.md

@@ -10,10 +10,14 @@
 |------|------|----------|
 | `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_company_profile` | 用統編查公司完整登記資料（含董監事） | inc.com.tw |
+| `taiwan_person_companies` | 用人名查他擔任負責人／董監事的公司 | inc.com.tw |
+| `taiwan_company_risk` | 公司風險查核：拒絕往來／勞動／環保裁罰紅旗 | 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 |
 
 跨工具串接是重點：例如「查這家公司 → 看它登記地址那區的房價 → 查它官網是不是詐騙」，一次問答內 AI 自己串起來。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "taiwan-data-mcp",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "MCP server for Taiwan public data — 實價登錄行情、公司登記查核、165 防詐查詢。Lets AI assistants (Claude, Cursor, etc.) query real Taiwan data.",
   "type": "module",
   "bin": {

package/src/server.mjs

@@ -3,8 +3,8 @@ import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { ListToolsRequestSchema, CallToolRequestSchema } from '@modelcontextprotocol/sdk/types.js';
 import {
-  scamCheck, companySearch, companyProfile,
-  realpriceSearch, realpriceLocate, realpriceArea,
+  scamCheck, companySearch, companyProfile, personCompanies, companyRisk,
+  realpriceSearch, realpriceLocate, realpriceArea, realpriceEstimate, realpriceRoad,
 } from './sources.mjs';
 
 const TOOLS = [
@@ -41,6 +41,28 @@ const TOOLS = [
     },
     run: (a) => companyProfile(a.unified_business_no),
   },
+  {
+    name: 'taiwan_person_companies',
+    description:
+      '用人名查他擔任「負責人／董監事」的台灣公司，回傳關聯公司數與範例公司（公司關係／查老闆人脈用）。以姓名比對，可能含同名同姓。資料來源：inc.com.tw。',
+    inputSchema: {
+      type: 'object',
+      properties: { name: { type: 'string', description: '人名，例如「郭台銘」' } },
+      required: ['name'],
+    },
+    run: (a) => personCompanies(a.name),
+  },
+  {
+    name: 'taiwan_company_risk',
+    description:
+      '公司風險查核（盡職調查紅旗）：用 8 位統編查該公司有無政府採購拒絕往來、勞動法令裁罰、環保裁罰，回傳風險等級與紅旗清單。資料來源：inc.com.tw（聚合政府公開資料）。',
+    inputSchema: {
+      type: 'object',
+      properties: { unified_business_no: { type: 'string', description: '8 位統一編號，例如 22099131' } },
+      required: ['unified_business_no'],
+    },
+    run: (a) => companyRisk(a.unified_business_no),
+  },
   {
     name: 'taiwan_realprice_search',
     description:
@@ -80,6 +102,38 @@ const TOOLS = [
     },
     run: (a) => realpriceArea(a.county, a.district),
   },
+  {
+    name: 'taiwan_realprice_estimate',
+    description:
+      '自動估價：輸入縣市+行政區（可加建物型態/屋齡/坪數），回傳可比案例的單價區間（萬/坪）與推估總價。資料來源：housetw.com（內政部實價登錄）。',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        county: { type: 'string', description: '縣市，例如「臺北市」（用「臺」非「台」）' },
+        district: { type: 'string', description: '行政區，例如「信義區」' },
+        building_type: { type: 'string', description: '建物型態（可選），例如「住宅大樓」「公寓」「華廈」' },
+        house_age: { type: 'number', description: '屋齡（可選，年）' },
+        area_ping: { type: 'number', description: '坪數（可選），給了才會推估總價' },
+      },
+      required: ['county', 'district'],
+    },
+    run: (a) => realpriceEstimate(a.county, a.district, { type: a.building_type, age: a.house_age, ping: a.area_ping }),
+  },
+  {
+    name: 'taiwan_realprice_road',
+    description:
+      '查某路段的不動產成交行情：單價統計（萬/坪）、成交筆數、屋齡與逐年價格走勢。資料來源：housetw.com（內政部實價登錄）。',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        county: { type: 'string', description: '縣市，例如「臺北市」' },
+        district: { type: 'string', description: '行政區，例如「信義區」' },
+        road: { type: 'string', description: '路段，例如「松高路」「忠孝東路四段」' },
+      },
+      required: ['county', 'district', 'road'],
+    },
+    run: (a) => realpriceRoad(a.county, a.district, a.road),
+  },
 ];
 
 const server = new Server(
@@ -104,4 +158,4 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
 
 const transport = new StdioServerTransport();
 await server.connect(transport);
-console.error('taiwan-data-mcp running (stdio) — 6 tools: 防詐 / 公司登記 / 實價登錄');
+console.error('taiwan-data-mcp running (stdio) — 10 tools: 防詐 / 公司登記 / 實價登錄');

package/src/sources.mjs

@@ -1,7 +1,7 @@
 // 台灣公開資料來源：薄客戶端，呼叫各站既有 JSON API，資料留在來源站。
 // 每個工具回傳都夾帶 source 與 link（署名 + 導流）。
 
-const UA = 'taiwan-data-mcp/0.1 (+https://github.com/kwlin/taiwan-data-mcp)';
+const UA = 'taiwan-data-mcp (+https://github.com/kewelin/taiwan-data-mcp)';
 
 export async function fetchJson(url, { timeout = 12000 } = {}) {
   const ctrl = new AbortController();
@@ -12,6 +12,9 @@ export async function fetchJson(url, { timeout = 12000 } = {}) {
     let body = null;
     try { body = JSON.parse(text); } catch { /* non-JSON (e.g. SSR HTML fallback) */ }
     return { ok: r.ok, status: r.status, body, raw: text };
+  } catch (e) {
+    // 網路 / TLS / 逾時錯誤：回結構化失敗，讓工具優雅降級而非拋例外
+    return { ok: false, status: 0, body: null, raw: '', netError: e?.cause?.code || e?.name || String(e) };
   } finally {
     clearTimeout(t);
   }
@@ -50,7 +53,7 @@ export async function companySearch(name) {
 export async function companyProfile(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}`);
+  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 };
   const { source: _drop, ...rest } = body;
@@ -58,6 +61,52 @@ export async function companyProfile(id) {
     source: '台灣公司登記網 inc.com.tw' };
 }
 
+export async function personCompanies(name) {
+  const q = String(name || '').trim();
+  if (q.length < 2) return { error: '人名至少 2 個字' };
+  const { ok, body } = await fetchJson(`https://inc.com.tw/api/suggest?q=${encodeURIComponent(q)}`);
+  if (!ok || !Array.isArray(body)) return { error: '查詢失敗（inc.com.tw）', query: q };
+  const people = body
+    .filter((x) => x.t === 'p')
+    .map((x) => ({ person: x.n, company_count: x.c, example_companies: x.eg || [],
+      profile_url: `https://inc.com.tw/p/${encodeURIComponent(x.n)}` }));
+  if (!people.length) return { query: q, count: 0, note: '查無此人擔任負責人／董監事的公司（或人名不完整）', people: [],
+    source: '台灣公司登記網 inc.com.tw' };
+  return { query: q, count: people.length, people,
+    note: '以姓名比對，可能含同名同姓，僅供參考',
+    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 };
+  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';
+  return {
+    unified_business_no: tin,
+    name: body.name,
+    status: body.status,
+    listing: body.listing || 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,
+    },
+    note: '裁罰以公司名稱比對，可能含同名同稱；僅供參考，以政府原始公告為準',
+    profile_url: `https://inc.com.tw/c/${tin}`,
+    source: '台灣公司登記網 inc.com.tw',
+  };
+}
+
 // ── 實價登錄 housetw.com ───────────────────────────────────────
 export async function realpriceSearch(q) {
   const query = String(q || '').trim();
@@ -95,3 +144,37 @@ export async function realpriceArea(county, district) {
   if (!ok) return { error: '查詢失敗（housetw.com）', county: c };
   return body;
 }
+
+export async function realpriceEstimate(county, district, { type, age, ping } = {}) {
+  const c = String(county || '').trim(), d = String(district || '').trim();
+  if (!c || !d) return { error: '請提供縣市 county 與行政區 district' };
+  const qp = new URLSearchParams({ county: c, district: d });
+  if (type) qp.set('type', String(type).trim());
+  if (age != null && age !== '') qp.set('age', String(age));
+  if (ping != null && ping !== '') qp.set('ping', String(ping));
+  const { ok, body, status } = await fetchJson(`https://housetw.com/api/estimate.json?${qp}`);
+  if (status === 404 || !body) return { error: '估價端點暫不可用（housetw.com）', county: c, district: d };
+  if (!ok) return { error: '查詢失敗（housetw.com）', county: c, district: d };
+  return body;
+}
+
+export async function realpriceRoad(county, district, road) {
+  const c = String(county || '').trim(), d = String(district || '').trim(), r = String(road || '').trim();
+  if (!c || !d || !r) return { error: '請提供縣市 county、行政區 district、路段 road' };
+  const qp = new URLSearchParams({ county: c, district: d, road: r });
+  const { ok, body, status } = await fetchJson(`https://housetw.com/api/road.json?${qp}`);
+  if (status === 404 || !body) return { error: '路段端點暫不可用（housetw.com）', road: r };
+  if (!ok) return { error: '查詢失敗（housetw.com）', road: r };
+  return body;
+}
+
+export async function realpriceRent(county, district) {
+  const c = String(county || '').trim();
+  if (!c) return { error: '請提供縣市 county（可加行政區 district）' };
+  const qp = new URLSearchParams({ county: c });
+  if (district) qp.set('district', String(district).trim());
+  const { ok, body, status } = await fetchJson(`https://housetw.com/api/rent.json?${qp}`);
+  if (status === 404 || status === 302 || !body) return { error: '租金端點暫不可用（housetw.com，待部署）', county: c };
+  if (!ok) return { error: '查詢失敗（housetw.com）', county: c };
+  return body;
+}