bizgate-mcp-server 0.3.5 → 0.3.7

package/dist/index.js

@@ -37,6 +37,7 @@ if (authMode === "ip" && !process.env.BIZGATE_APP) {
     process.exit(1);
 }
 const dailyLimit = Number(process.env.BIZGATE_DAILY_LIMIT ?? "200");
+const seedApiUrl = process.env.SEED_API_URL ?? "http://192.168.40.94:3456";
 const usageFile = process.env.BIZGATE_USAGE_FILE ??
     join(homedir(), ".bizgate-mcp-usage.json");
 const baseUrl = process.env.BIZGATE_BASE_URL ??
@@ -204,7 +205,7 @@ server.tool("bizgate__company_search", "会社名または法人番号で企業
     }
 });
 // ---------- Tool 2: 部署検索 ----------
-server.tool("bizgate__department_search", "部署情報（部署名・住所・電話番号・カテゴリ）を検索する。会社名・法人番号での検索に加え、部署名キーワード（bKwd）やカテゴリ（cList）のみでの全企業横断検索も可能。最大500件。デフォルトで上位30件を表示（limitで変更可能）。", {
+server.tool("bizgate__department_search", "会社名または法人番号で部署情報（部署名・住所・電話番号・カテゴリ）を検索する。最大500件。都道府県・カテゴリ・部署名キーワードで絞り込み可能。デフォルトで上位30件を表示（limitで変更可能）。", {
     shogo: z.string().optional().describe("会社名（例：株式会社○○）"),
     compno: z.string().optional().describe("法人番号（13桁）"),
     pList: z.string().optional().describe("都道府県コード（カンマ区切り。例: 13,14 = 東京都,神奈川県）"),
@@ -213,13 +214,9 @@ server.tool("bizgate__department_search", "部署情報（部署名・住所・
     bKOpr: z.string().optional().describe("キーワード結合演算子（0=OR（デフォルト）, 1=AND）"),
     limit: z.number().optional().describe("表示する件数の上限（デフォルト: 30）"),
 }, async ({ shogo, compno, pList, cList, bKwd, bKOpr, limit }) => {
-    // 部署検索: bKwd or cList があれば会社名なしでも検索可能
-    if (!shogo && !compno && !bKwd && !cList) {
-        return { content: [{ type: "text", text: "エラー: 会社名（shogo）、法人番号（compno）、部署名キーワード（bKwd）、カテゴリ（cList）のいずれかを入力してください。" }] };
-    }
-    if (compno && !/^\d{13}$/.test(compno)) {
-        return { content: [{ type: "text", text: "エラー: 法人番号は13桁の数字で入力してください。" }] };
-    }
+    const err = validateInput(shogo, compno);
+    if (err)
+        return { content: [{ type: "text", text: err }] };
     const displayLimit = limit ?? 30;
     try {
         const { docs, numFound } = await client.searchDepartments({
@@ -424,6 +421,229 @@ server.tool("bizgate__usage_status", "本日のBizGate API残り利用回数を
         ],
     };
 });
+// ---------- Tool 7: プロスペクトリスト（シードAPI連携） ----------
+const MAX_API_CALLS_HARD_LIMIT = 150;
+async function fetchSeeds(params) {
+    const url = new URL("/search", seedApiUrl);
+    for (const [k, v] of Object.entries(params))
+        url.searchParams.set(k, v);
+    const res = await fetch(url);
+    if (!res.ok)
+        throw new Error(`seed-api エラー: HTTP ${res.status}`);
+    return (await res.json());
+}
+/** 売上カテゴリ文字列から数値を抽出して最低ラインと比較 */
+function revenueMatchesMin(revenue, minLabel) {
+    if (!revenue)
+        return false;
+    // revenue例: "7. 20億-100億未満", minLabel例: "50億以上"
+    const thresholds = {
+        "50億以上": 7, // カテゴリ7(20億-100億) 以上
+        "300億以上": 8, // カテゴリ8(100億以上)
+        "1000億以上": 8, // カテゴリ8(100億以上)
+    };
+    const minCat = thresholds[minLabel];
+    if (!minCat)
+        return true; // 不明なラベルはフィルタしない
+    const match = revenue.match(/^(\d+)\./);
+    if (!match)
+        return false;
+    return Number(match[1]) >= minCat;
+}
+/** proposal_axis からアプローチキーワードを生成 */
+function axisToKeywords(axis) {
+    const axes = Array.isArray(axis) ? axis : [axis];
+    const keywordMap = {
+        "DOMO": "経営企画,DX,システム,情報,データ,分析",
+        "営業DX/CRM": "営業,マーケティング,販売,顧客,CRM,販促",
+        "営業DX": "営業,マーケティング,販売,顧客,CRM,販促",
+        "CRM": "営業,マーケティング,顧客,CRM",
+    };
+    const keywords = axes.flatMap((a) => (keywordMap[a] ?? a).split(","));
+    return [...new Set(keywords)].join(",");
+}
+server.tool("bizgate__prospect_list", "シードリスト（国税庁572万法人）から条件に合う企業を抽出し、BizGate APIで部署・キーマンまで照会してプロスペクトリストを作成する。1回の実行で約40 APIコールを消費（1日約5回実行可能）。SEED_API_URLが必要。", {
+    pref: z.string().optional().describe("都道府県（例: 東京都）"),
+    city: z.string().optional().describe("市区町村名（例: 千代田区）"),
+    industry: z.string().optional().describe("BizGate業種分類キーワード（例: 製造業, サービス, IT）"),
+    revenue_min: z.string().optional().describe("最低売上（50億以上 / 300億以上 / 1000億以上）"),
+    employee_500plus: z.boolean().optional().describe("従業員500人以上のみ"),
+    proposal_axis: z.union([z.string(), z.array(z.string())]).optional().describe("提案軸（DOMO / 営業DX/CRM）。部署検索のキーワードに変換される"),
+    count: z.number().optional().describe("取得したい企業数（デフォルト: 10、最大: 30）"),
+}, async ({ pref, city, industry, revenue_min, employee_500plus, proposal_axis, count: rawCount }) => {
+    if (!seedApiUrl) {
+        return {
+            content: [{ type: "text", text: "エラー: SEED_API_URL が設定されていません。管理者に連絡してください。" }],
+        };
+    }
+    const count = Math.min(rawCount ?? 10, 30);
+    const remaining = usageTracker.remaining();
+    if (remaining < 10) {
+        return {
+            content: [{ type: "text", text: `エラー: 残りAPI回数が${remaining}回です。明日以降にお試しください。${usageFooter()}` }],
+        };
+    }
+    // ---- Step 1: シードAPIから候補取得 (API 0回) ----
+    const seedParams = {
+        limit: "200",
+        shuffle: "true",
+        type: "株式会社",
+    };
+    if (pref)
+        seedParams.pref = pref;
+    if (city)
+        seedParams.city = city;
+    let seeds;
+    let seedTotal;
+    try {
+        const result = await fetchSeeds(seedParams);
+        seeds = result.results;
+        seedTotal = result.total;
+    }
+    catch (e) {
+        return {
+            content: [{ type: "text", text: `seed-api に接続できません（${seedApiUrl}）: ${e instanceof Error ? e.message : "不明なエラー"}` }],
+        };
+    }
+    if (seeds.length === 0) {
+        return {
+            content: [{ type: "text", text: `条件に合う企業がシードリストに見つかりませんでした。${usageFooter()}` }],
+        };
+    }
+    // ---- Step 2: BizGate企業検索 → 売上/業種/従業員フィルタ ----
+    const verified = [];
+    let apiCalls = 0;
+    const batchSize = 5;
+    const targetVerified = Math.ceil(count * 1.5); // 部署/キーマンで脱落分を見越す
+    for (let i = 0; i < seeds.length && verified.length < targetVerified && apiCalls < MAX_API_CALLS_HARD_LIMIT; i += batchSize) {
+        const batch = seeds.slice(i, i + batchSize);
+        const results = await Promise.all(batch.map(async (seed) => {
+            try {
+                const { docs } = await client.searchCompany({ compno: seed.corporate_number });
+                apiCalls++;
+                return { seed, doc: docs[0] ?? null };
+            }
+            catch {
+                apiCalls++;
+                return { seed, doc: null };
+            }
+        }));
+        for (const { seed, doc } of results) {
+            if (!doc)
+                continue;
+            if (revenue_min && !revenueMatchesMin(doc.revenue, revenue_min))
+                continue;
+            if (industry) {
+                const docIndustry = f(doc.gyoshu_facet);
+                if (!industry.split(",").some((k) => docIndustry.includes(k.trim())))
+                    continue;
+            }
+            if (employee_500plus && doc.emp) {
+                const empMatch = doc.emp.match(/(\d+)/);
+                if (empMatch) {
+                    // emp例: "6. 500-1000人未満" → カテゴリ6以上
+                    const empCat = Number(doc.emp.match(/^(\d+)\./)?.[1] ?? 0);
+                    if (empCat < 6)
+                        continue; // カテゴリ6 = 500-1000人
+                }
+            }
+            verified.push({ doc, seed });
+        }
+    }
+    if (verified.length === 0) {
+        return {
+            content: [{
+                    type: "text",
+                    text: `条件に合う企業が見つかりませんでした。\n（シード候補: ${seeds.length}社 / API照会: ${apiCalls}回）${usageFooter()}`,
+                }],
+        };
+    }
+    // ---- Step 3: 部署 + キーマン検索 ----
+    const deptKeywords = proposal_axis ? axisToKeywords(proposal_axis) : "";
+    const prospects = [];
+    for (const { doc, seed } of verified.slice(0, count)) {
+        const companyName = f(doc.shogo);
+        let department = "-";
+        let phone = f(doc.tel) || "-";
+        let keyman;
+        // 部署検索
+        if (deptKeywords) {
+            try {
+                const { docs: deptDocs } = await client.searchDepartments({
+                    shogo: companyName, bKwd: deptKeywords, bKOpr: "0",
+                });
+                apiCalls++;
+                if (deptDocs.length > 0) {
+                    department = f(deptDocs[0].bumon) || "-";
+                    if (f(deptDocs[0].tel))
+                        phone = f(deptDocs[0].tel);
+                }
+            }
+            catch {
+                apiCalls++;
+            }
+        }
+        // キーマン検索
+        if (skeyKeyman && skeyKeymanName) {
+            try {
+                const { docs: keyDocs } = await client.searchKeymanWithNames({
+                    shogo: companyName, bKwd: deptKeywords || undefined, limit: 1,
+                });
+                apiCalls += 2; // 一覧1回 + 詳細1回
+                if (keyDocs.length > 0) {
+                    keyman = {
+                        name: f(keyDocs[0].ceo) || "(不明)",
+                        title: f(keyDocs[0].bumon) || "(不明)",
+                    };
+                    if (f(keyDocs[0].tel))
+                        phone = f(keyDocs[0].tel);
+                }
+            }
+            catch {
+                apiCalls += 1;
+            }
+        }
+        // アプローチノート生成
+        const axes = proposal_axis
+            ? (Array.isArray(proposal_axis) ? proposal_axis : [proposal_axis])
+            : [];
+        const axisLabel = axes.join("・") || "汎用";
+        const approachNote = `${axisLabel}の導入提案。${f(doc.gyoshu_facet) || ""}${doc.emp ? `、${doc.emp}` : ""}。`;
+        prospects.push({
+            name: companyName,
+            prefecture: seed.prefecture,
+            city: seed.city,
+            corporate_number: seed.corporate_number,
+            industry: f(doc.gyoshu_facet) || "-",
+            revenue: doc.revenue ?? "-",
+            department,
+            keyman,
+            phone,
+            approach_note: approachNote,
+        });
+        if (apiCalls >= MAX_API_CALLS_HARD_LIMIT)
+            break;
+    }
+    // ---- Step 4: 結果フォーマット ----
+    // キーマンあり > 部署あり > 会社のみ でソート
+    prospects.sort((a, b) => {
+        const scoreA = (a.keyman ? 2 : 0) + (a.department !== "-" ? 1 : 0);
+        const scoreB = (b.keyman ? 2 : 0) + (b.department !== "-" ? 1 : 0);
+        return scoreB - scoreA;
+    });
+    const header = `## プロスペクトリスト（${prospects.length}社）\n\n`;
+    const table = `| # | 会社名 | 部署 | キーマン | 電話 | アプローチ角度 |\n|---|--------|------|---------|------|---------------|\n` +
+        prospects
+            .map((p, i) => {
+            const keymanStr = p.keyman ? `${p.keyman.name}（${p.keyman.title}）` : "-";
+            return `| ${i + 1} | ${p.name} | ${p.department} | ${keymanStr} | ${p.phone} | ${p.approach_note} |`;
+        })
+            .join("\n");
+    const stats = `\n\n---\nシード: ${seedTotal}社中${seeds.length}社取得 / API照会: ${apiCalls}回 / マッチ: ${prospects.length}社`;
+    return {
+        content: [{ type: "text", text: header + table + stats + usageFooter() }],
+    };
+});
 // ---------- 起動 ----------
 async function main() {
     const transport = new StdioServerTransport();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bizgate-mcp-server",
-  "version": "0.3.5",
+  "version": "0.3.7",
   "description": "BizGate APIとClaudeを連携するMCPサーバー",
   "type": "module",
   "main": "dist/index.js",