bizgate-mcp-server 0.3.5 → 0.3.6

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.BIZGATE_SEED_API_URL ?? "";
 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,140 @@ server.tool("bizgate__usage_status", "本日のBizGate API残り利用回数を
         ],
     };
 });
+// ---------- Tool 7: プロスペクトリスト（シードAPI連携） ----------
+const REVENUE_CATEGORIES = {
+    1: "1. 1000万未満",
+    2: "2. 1000万-3000万未満",
+    3: "3. 3000万-1億未満",
+    4: "4. 1億-5億未満",
+    5: "5. 5億-10億未満",
+    6: "6. 10億-20億未満",
+    7: "7. 20億-100億未満",
+    8: "8. 100億以上",
+};
+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, minCategory) {
+    if (!revenue)
+        return false;
+    const match = revenue.match(/^(\d+)\./);
+    if (!match)
+        return false;
+    return Number(match[1]) >= minCategory;
+}
+server.tool("bizgate__prospect_list", "シードリスト（国税庁法人データ）から条件に合う企業を抽出し、BizGate APIで詳細を照会してプロスペクトリストを作成する。BIZGATE_SEED_API_URLの設定が必要。", {
+    pref: z.string().optional().describe("都道府県（例: 東京都）"),
+    keyword: z.string().optional().describe("会社名キーワード（部分一致）"),
+    industry: z.string().optional().describe("業種キーワード（例: IT,製造）。BizGateの業種情報でフィルタリング"),
+    minRevenue: z.number().optional().describe("最低売上カテゴリ番号（1=1000万未満, 2=1000万-3000万, 3=3000万-1億, 4=1億-5億, 5=5億-10億, 6=10億-20億, 7=20億-100億, 8=100億以上）"),
+    targetCount: z.number().optional().describe("取得したい企業数（デフォルト: 10、最大: 20）"),
+    maxApiCalls: z.number().optional().describe("このツール1回で使うAPI上限（デフォルト: 50、最大: 150）"),
+}, async ({ pref, keyword, industry, minRevenue, targetCount: rawTarget, maxApiCalls: rawMax }) => {
+    if (!seedApiUrl) {
+        return {
+            content: [{ type: "text", text: "エラー: BIZGATE_SEED_API_URL が設定されていません。管理者に連絡してください。" }],
+        };
+    }
+    const targetCount = Math.min(rawTarget ?? 10, 20);
+    const apiLimit = Math.min(rawMax ?? 50, MAX_API_CALLS_HARD_LIMIT);
+    const remaining = usageTracker.remaining();
+    const effectiveLimit = Math.min(apiLimit, remaining);
+    if (effectiveLimit < 5) {
+        return {
+            content: [{ type: "text", text: `エラー: 残りAPI回数が${remaining}回しかありません。明日以降にお試しください。${usageFooter()}` }],
+        };
+    }
+    // Step 1: シードAPIから候補取得
+    const seedParams = {
+        limit: String(targetCount * 5),
+        shuffle: "true",
+    };
+    if (pref)
+        seedParams.pref = pref;
+    if (keyword)
+        seedParams.keyword = keyword;
+    let seeds;
+    let seedTotal;
+    try {
+        const result = await fetchSeeds(seedParams);
+        seeds = result.results;
+        seedTotal = result.total;
+    }
+    catch (e) {
+        return {
+            content: [{ type: "text", text: `シードAPIへの接続に失敗しました: ${e instanceof Error ? e.message : "不明なエラー"}` }],
+        };
+    }
+    if (seeds.length === 0) {
+        return {
+            content: [{ type: "text", text: `条件に合う企業がシードリストに見つかりませんでした。${usageFooter()}` }],
+        };
+    }
+    // Step 2: BizGate APIで詳細照会 + フィルタリング
+    const matched = [];
+    let apiCalls = 0;
+    const batchSize = 5;
+    for (let i = 0; i < seeds.length && matched.length < targetCount && apiCalls < effectiveLimit; i += batchSize) {
+        const batch = seeds.slice(i, Math.min(i + batchSize, seeds.length));
+        const remaining2 = effectiveLimit - apiCalls;
+        const actualBatch = batch.slice(0, remaining2);
+        const results = await Promise.all(actualBatch.map(async (seed) => {
+            try {
+                const { docs } = await client.searchCompany({ compno: seed.compno });
+                apiCalls++;
+                return { seed, doc: docs[0] ?? null };
+            }
+            catch {
+                apiCalls++;
+                return { seed, doc: null };
+            }
+        }));
+        for (const { seed, doc } of results) {
+            if (!doc)
+                continue;
+            // 売上フィルタ
+            if (minRevenue && !revenueMatchesMin(doc.revenue, minRevenue))
+                continue;
+            // 業種フィルタ
+            if (industry) {
+                const docIndustry = f(doc.gyoshu_facet);
+                const keywords = industry.split(",").map((k) => k.trim());
+                if (!keywords.some((k) => docIndustry.includes(k)))
+                    continue;
+            }
+            matched.push({ doc, seed });
+        }
+    }
+    // Step 3: 結果フォーマット
+    if (matched.length === 0) {
+        return {
+            content: [{
+                    type: "text",
+                    text: `条件に合う企業が見つかりませんでした。\n（シード候補: ${seeds.length}社 / API照会: ${apiCalls}回 / シード全体: ${seedTotal}社）${usageFooter()}`,
+                }],
+        };
+    }
+    const header = `## プロスペクトリスト（${matched.length}社）\n\n`;
+    const table = `| # | 会社名 | 業種 | 売上 | 従業員 | 所在地 | HP |\n|---|--------|------|------|--------|--------|----|\n` +
+        matched
+            .map((m, i) => {
+            const d = m.doc;
+            return `| ${i + 1} | ${f(d.shogo)} | ${f(d.gyoshu_facet)} | ${d.revenue ?? "-"} | ${d.emp ?? "-"} | ${f(d.add)} | ${f(d.hpurl) || "-"} |`;
+        })
+            .join("\n");
+    const stats = `\n\n---\nシード候補: ${seeds.length}社（全${seedTotal}社中） / API照会: ${apiCalls}回 / マッチ: ${matched.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.6",
   "description": "BizGate APIとClaudeを連携するMCPサーバー",
   "type": "module",
   "main": "dist/index.js",