bizgate-mcp-server 0.3.0 → 0.3.3

package/README.md

@@ -33,7 +33,7 @@ Claude に話しかけるだけで、企業の担当者名・電話番号・住
 
 ---
 
-## セットアップ（所要時間：約10分）
+## セットアップ（所要時間：約3分）
 
 ### 事前に必要なもの
 
@@ -54,90 +54,43 @@ Mac の場合：
 
 ---
 
-### ステップ 2：MCP サーバーを登録する
+### ステップ 2：インストールスクリプトを実行する
 
 ターミナルに以下を **そのままコピーして貼り付け** → Enter を押してください。
 
-```
-claude mcp add --scope user bizgate -- npx bizgate-mcp-server
-```
-
-以下のように表示されれば OK です。
-```
-Added stdio MCP server bizgate...
-```
-
----
-
-### ステップ 3：設定ファイルを編集する
-
-ターミナルに以下を **そのままコピーして貼り付け** → Enter を押してください。
-
-```
-open ~/.claude.json
-```
-
-テキストエディタで設定ファイルが開きます。
-
-ファイルの中から `"bizgate"` というセクションを探してください。
-以下のように **書き換え** ます。
-
-#### 書き換え前
-
-```json
-"bizgate": {
-  "type": "stdio",
-  "command": "npx",
-  "args": ["bizgate-mcp-server"],
-  "env": {}
-}
-```
-
-#### 書き換え後
-
-```json
-"bizgate": {
-  "type": "stdio",
-  "command": "npx",
-  "args": ["bizgate-mcp-server"],
-  "env": {
-    "BIZGATE_USERNAME": "ここにユーザー名を入力",
-    "BIZGATE_PASSWORD": "ここにパスワードを入力",
-    "BIZGATE_AUTH_MODE": "basic",
-    "BIZGATE_DAILY_LIMIT": "200",
-    "BIZGATE_SKEY_COMPANY": "ここに企業APIキーを入力",
-    "BIZGATE_SKEY_DEPARTMENT": "ここに部署APIキーを入力",
-    "BIZGATE_SKEY_MARKETING": "ここにマーケAPIキーを入力",
-    "BIZGATE_SKEY_KEYMAN": "ここにキーマン(人名なし)APIキーを入力",
-    "BIZGATE_SKEY_KEYMAN_NAME": "ここにキーマン(人名あり)APIキーを入力"
-  }
-}
-```
-
-> **注意（よくあるミス）**
-> - `ここに〇〇を入力` の部分を、管理者から受け取った **実際の値** に置き換えてください
-> - ダブルクォーテーション `"` は **消さないで** ください
-> - カンマ `,` の位置を **変えないで** ください
-> - 最後の行（`"BIZGATE_SKEY_KEYMAN_NAME"` の行）の末尾には **カンマをつけないで** ください
-> - 編集後、`Command + S` で保存 → ファイルを閉じる
+```smalltalk
+claude mcp add bizgate --scope user \
+  -e "BIZGATE_USERNAME=digi-man_bizg1" \
+  -e "BIZGATE_PASSWORD=digi-man_bizg1" \
+  -e "BIZGATE_AUTH_MODE=basic" \
+  -e "BIZGATE_DAILY_LIMIT=200" \
+  -e "BIZGATE_SKEY_COMPANY=/EhMJ9YMCJtJgo73.DjLuew8rnnTlb.F6/MuiESFXmZwlCKvG8bMm" \
+  -e "BIZGATE_SKEY_DEPARTMENT=i08d/E8OwOtb2L0cdzbh1.Y5LvlTwpvZ49o3rBFVOnzRL7lDvR4Om" \
+  -e "BIZGATE_SKEY_MARKETING=X96mHxuTt4RExyo94/eGIOJwsFKr6aVlYQ80UozjTZaUVf9t/1CDu" \
+  -e "BIZGATE_SKEY_KEYMAN=3Rc3.RMt53yzVJ5zv28bjOIZVx8KjfIfo2PiCryGtF81feOv3hPZ." \
+  -e "BIZGATE_SKEY_KEYMAN_NAME=qT42YqynPg0uhPoGvquwbOUAYCotYSzxHhwiCHG5gZbTFMk75waAG" \
+  -- npx bizgate-mcp-server
+```
+
+- サービスキーを誤って入力した場合
+    
+    ```bash
+    claude mcp remove bizgate -s user
+    ```
+    
+    その後、再度入力してください。
 
 ---
 
-### ステップ 4：Claude Code を再起動する
-
-もし Claude Code が開いている場合は、一度閉じてください。
+### ステップ 3：Claude Code で接続を確認する
 
-ターミナルで以下を実行してください。
+Claude Code を起動（またはすでに開いていれば再起動）してください。
 
 ```
 claude
 ```
 
----
-
-### ステップ 5：接続を確認する
-
-Claude Code が起動したら、以下を入力してください。
+起動したら、以下を入力してください。
 
 ```
 /mcp
@@ -165,6 +118,33 @@ Claude Code が起動したら、以下を入力してください。
 | 採用活動をしている会社か確認 | 「○○のマーケティングタグを教えて」 |
 | 全情報をまとめて見たい | 「○○の全情報を調べて」 |
 | Excelに入力したい | 「○○の情報を調べてExcelに入れて」 |
+| DigiManのサービスに合う部署を探したい | 「○○にDigiManのサービスが売れそうな部署を探して」 |
+
+### prospect-match スキル（部署マッチング）
+
+企業の部署一覧から、DigiManの各サービス（営業代行・Solution・AI）に適した営業ターゲット部署を自動で提案するスキルです。
+
+```
+/prospect-match 兼松株式会社
+```
+
+または自然言語でもOK：
+```
+「兼松株式会社にDigiManのサービスが売れそうな部署を探して」
+```
+
+**出力内容：**
+- サービスごとの推薦部署（最大5件ずつ）+ 電話番号
+- マッチ理由
+- 最優先アプローチ先
+
+**すでにBizGate MCPをインストール済みの方** は、以下でスキルだけ追加できます：
+
+```bash
+bash install-skill.sh
+```
+
+新規インストールの場合は `install.sh` にスキルも含まれています。
 
 ### 注意点
 
@@ -176,6 +156,21 @@ Claude Code が起動したら、以下を入力してください。
 
 ---
 
+## パフォーマンス最適化
+
+本サーバーには以下の最適化が組み込まれています。
+
+### APIコール節約
+- **5分キャッシュ**: 同じ会社を5分以内に再検索した場合、APIを消費しません
+- **キーマン詳細の並列取得**: 5件ずつ並列リクエストで高速化
+
+### LLMトークン節約
+- **部署検索**: デフォルト30件のみ表示（`limit`で変更可能）。残りは絞り込みで取得
+- **一括取得**: 部署は上位15件、人事は役職一覧のみ（人名が必要な場合は個別ツールで）
+- 超過分は「残りN件あります」と案内し、必要に応じて追加取得
+
+---
+
 ## 提供ツール（参考情報）
 
 通常はツール名を意識する必要はありません。Claude が自動で適切なツールを選びます。
@@ -183,10 +178,10 @@ Claude Code が起動したら、以下を入力してください。
 | ツール名 | 説明 | API消費 |
 |---------|------|--------|
 | `bizgate__company_search` | 企業の基本情報（住所・電話・代表者・業種・資本金 等） | 1回（結果なしでも課金） |
-| `bizgate__department_search` | 部署情報（部署名・住所・電話番号）最大500件 | 1回（データなしは課金なし） |
+| `bizgate__department_search` | 部署情報（部署名・住所・電話番号）デフォルト30件表示 | 1回（データなしは課金なし） |
 | `bizgate__marketing_tags` | マーケティングタグ（SNS・MA・採用・活動） | 1回（データなしは課金なし） |
-| `bizgate__keyman_search` | 担当者情報（実名・役職・電話番号・住所） | 1回 + 詳細取得N回 |
-| `bizgate__company_full` | 企業＋部署＋キーマンを一括取得 | 3回〜 |
+| `bizgate__keyman_search` | 担当者情報（実名・役職・電話番号・住所）デフォルト10名 | 1回 + 詳細N回 |
+| `bizgate__company_full` | 企業＋部署(15件)＋キーマン(要約)を一括取得 | 3回 |
 | `bizgate__usage_status` | 本日の残りAPI回数を確認 | 0回 |
 
 ---

package/dist/bizgate-client.d.ts

@@ -32,7 +32,7 @@ export declare class BizGateClient {
     private cacheKey;
     /**
      * Company lookup (企業).
-     * Cached for 60s. Billed even on no-result.
+     * Cached for 5 minutes. Billed even on no-result.
      */
     searchCompany(params: {
         shogo?: string;
@@ -43,7 +43,7 @@ export declare class BizGateClient {
     }): Promise<CompanyResult>;
     /**
      * Department lookup (部署).
-     * Cached for 60s. Not billed on failure.
+     * Cached for 5 minutes. Not billed on failure.
      */
     searchDepartments(params: {
         shogo?: string;
@@ -55,7 +55,7 @@ export declare class BizGateClient {
     }): Promise<DepartmentResult>;
     /**
      * Marketing tags lookup (マーケティングタグ).
-     * Cached for 60s. Not billed on failure.
+     * Cached for 5 minutes. Not billed on failure.
      */
     searchMarketingTags(params: {
         shogo?: string;
@@ -63,7 +63,7 @@ export declare class BizGateClient {
     }): Promise<MarketingResult>;
     /**
      * Keyman lookup (キーマン・人名なし).
-     * Cached for 60s. Not billed on failure.
+     * Cached for 5 minutes. Not billed on failure.
      */
     searchKeyman(params: {
         shogo?: string;

package/dist/bizgate-client.js

@@ -6,8 +6,14 @@ export function first(field) {
         return field[0] ?? "";
     return field ?? "";
 }
-// Cache TTL: 60 seconds — same company searched within 60s won't hit the API again
-const CACHE_TTL = 60_000;
+// Cache TTL: 5 minutes — same company searched within 5min won't hit the API again
+const CACHE_TTL = 300_000;
+/** BizGate error codes that do NOT consume a billable request. */
+const NON_BILLABLE_ERRORS = new Set(["404", "504", "604"]);
+/** Pick only defined (non-null, non-undefined) string values from an object. */
+function pickDefined(obj) {
+    return Object.fromEntries(Object.entries(obj).filter((entry) => entry[1] != null));
+}
 export class BizGateClient {
     config;
     usageTracker;
@@ -62,7 +68,7 @@ export class BizGateClient {
     }
     /**
      * Company lookup (企業).
-     * Cached for 60s. Billed even on no-result.
+     * Cached for 5 minutes. Billed even on no-result.
      */
     async searchCompany(params) {
         const key = this.cacheKey(params);
@@ -70,17 +76,7 @@ export class BizGateClient {
         if (cached)
             return cached;
         this.usageTracker.increment();
-        const queryParams = {};
-        if (params.shogo)
-            queryParams.shogo = params.shogo;
-        if (params.compno)
-            queryParams.compno = params.compno;
-        if (params.hpurl)
-            queryParams.hpurl = params.hpurl;
-        if (params.email)
-            queryParams.email = params.email;
-        if (params.tel)
-            queryParams.tel = params.tel;
+        const queryParams = pickDefined(params);
         const result = await this.request(this.config.skeyCompany, queryParams);
         const data = {
             matchPattern: result.responseHeader.matchpatern ?? "",
@@ -91,7 +87,7 @@ export class BizGateClient {
     }
     /**
      * Department lookup (部署).
-     * Cached for 60s. Not billed on failure.
+     * Cached for 5 minutes. Not billed on failure.
      */
     async searchDepartments(params) {
         const key = this.cacheKey(params);
@@ -99,30 +95,26 @@ export class BizGateClient {
         if (cached)
             return cached;
         this.usageTracker.increment();
-        const queryParams = {};
-        if (params.shogo)
-            queryParams.shogo = params.shogo;
-        if (params.compno)
-            queryParams.compno = params.compno;
-        if (params.pList)
-            queryParams.pList = params.pList;
-        if (params.cList)
-            queryParams.cList = params.cList;
-        if (params.bKwd)
-            queryParams.bKwd = params.bKwd;
-        if (params.bKOpr)
-            queryParams.bKOpr = params.bKOpr;
-        const result = await this.request(this.config.skeyDepartment, queryParams);
-        const data = {
-            docs: result.response?.docs ?? [],
-            numFound: result.response?.numFound ?? 0,
-        };
-        this.departmentCache.set(key, data);
-        return data;
+        try {
+            const queryParams = pickDefined(params);
+            const result = await this.request(this.config.skeyDepartment, queryParams);
+            const data = {
+                docs: result.response?.docs ?? [],
+                numFound: result.response?.numFound ?? 0,
+            };
+            this.departmentCache.set(key, data);
+            return data;
+        }
+        catch (e) {
+            if (e instanceof BizGateApiError && NON_BILLABLE_ERRORS.has(e.code)) {
+                this.usageTracker.decrement();
+            }
+            throw e;
+        }
     }
     /**
      * Marketing tags lookup (マーケティングタグ).
-     * Cached for 60s. Not billed on failure.
+     * Cached for 5 minutes. Not billed on failure.
      */
     async searchMarketingTags(params) {
         const key = this.cacheKey(params);
@@ -130,21 +122,25 @@ export class BizGateClient {
         if (cached)
             return cached;
         this.usageTracker.increment();
-        const queryParams = {};
-        if (params.shogo)
-            queryParams.shogo = params.shogo;
-        if (params.compno)
-            queryParams.compno = params.compno;
-        const result = await this.request(this.config.skeyMarketing, queryParams);
-        const data = {
-            docs: result.response?.docs ?? [],
-        };
-        this.marketingCache.set(key, data);
-        return data;
+        try {
+            const queryParams = pickDefined(params);
+            const result = await this.request(this.config.skeyMarketing, queryParams);
+            const data = {
+                docs: result.response?.docs ?? [],
+            };
+            this.marketingCache.set(key, data);
+            return data;
+        }
+        catch (e) {
+            if (e instanceof BizGateApiError && NON_BILLABLE_ERRORS.has(e.code)) {
+                this.usageTracker.decrement();
+            }
+            throw e;
+        }
     }
     /**
      * Keyman lookup (キーマン・人名なし).
-     * Cached for 60s. Not billed on failure.
+     * Cached for 5 minutes. Not billed on failure.
      */
     async searchKeyman(params) {
         const key = this.cacheKey(params);
@@ -152,26 +148,22 @@ export class BizGateClient {
         if (cached)
             return cached;
         this.usageTracker.increment();
-        const queryParams = {};
-        if (params.shogo)
-            queryParams.shogo = params.shogo;
-        if (params.compno)
-            queryParams.compno = params.compno;
-        if (params.pList)
-            queryParams.pList = params.pList;
-        if (params.cList)
-            queryParams.cList = params.cList;
-        if (params.bKwd)
-            queryParams.bKwd = params.bKwd;
-        if (params.bKOpr)
-            queryParams.bKOpr = params.bKOpr;
-        const result = await this.request(this.config.skeyKeyman, queryParams);
-        const data = {
-            docs: result.response?.docs ?? [],
-            numFound: result.response?.numFound ?? 0,
-        };
-        this.keymanCache.set(key, data);
-        return data;
+        try {
+            const queryParams = pickDefined(params);
+            const result = await this.request(this.config.skeyKeyman, queryParams);
+            const data = {
+                docs: result.response?.docs ?? [],
+                numFound: result.response?.numFound ?? 0,
+            };
+            this.keymanCache.set(key, data);
+            return data;
+        }
+        catch (e) {
+            if (e instanceof BizGateApiError && NON_BILLABLE_ERRORS.has(e.code)) {
+                this.usageTracker.decrement();
+            }
+            throw e;
+        }
     }
     /**
      * Keyman with name lookup (キーマン・人名あり).
@@ -186,7 +178,10 @@ export class BizGateClient {
                 });
                 return result.response?.docs?.[0] ?? null;
             }
-            catch {
+            catch (e) {
+                if (e instanceof BizGateApiError && NON_BILLABLE_ERRORS.has(e.code)) {
+                    this.usageTracker.decrement();
+                }
                 return null;
             }
         };

package/dist/index.js

@@ -6,7 +6,9 @@ import { BizGateClient, first as f } from "./bizgate-client.js";
 import { BizGateApiError, DEPARTMENT_CATEGORIES } from "./types.js";
 import { UsageTracker } from "./usage-tracker.js";
 import { homedir } from "node:os";
-import { join } from "node:path";
+import { join, dirname } from "node:path";
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
 // ---------- 環境変数読み込み ----------
 const skeyCompany = process.env.BIZGATE_SKEY_COMPANY;
 const skeyDepartment = process.env.BIZGATE_SKEY_DEPARTMENT;
@@ -50,9 +52,11 @@ const config = {
 const usageTracker = new UsageTracker(usageFile, dailyLimit);
 const client = new BizGateClient(config, usageTracker);
 // ---------- MCPサーバー ----------
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8"));
 const server = new McpServer({
     name: "bizgate-mcp-server",
-    version: "0.3.0",
+    version: pkg.version,
 });
 // ---------- ヘルパー ----------
 function usageFooter() {
@@ -345,73 +349,54 @@ server.tool("bizgate__company_full", "会社名または法人番号で企業情
     const err = validateInput(shogo, compno);
     if (err)
         return { content: [{ type: "text", text: err }] };
-    const sections = [];
-    // 1. Company info
-    try {
-        const { matchPattern, docs } = await client.searchCompany({
-            shogo, compno, hpurl, email,
-        });
+    // Parallel fetch: company + department + keyman simultaneously
+    const companyPromise = client.searchCompany({ shogo, compno, hpurl, email })
+        .then(({ matchPattern, docs }) => {
         if (docs.length > 0) {
-            sections.push(docs.map(formatCompanyDoc).join("\n\n"));
-            sections.push(`マッチパターン: ${matchPattern}`);
+            return docs.map(formatCompanyDoc).join("\n\n") + `\nマッチパターン: ${matchPattern}`;
         }
-        else {
-            sections.push(`企業情報: 該当なし（マッチパターン: ${matchPattern}）`);
-        }
-    }
-    catch (e) {
-        sections.push(`企業情報: ${e instanceof Error ? e.message : "取得失敗"}`);
-    }
-    // 2. Department info (top 15 for token efficiency)
-    try {
-        const { docs, numFound } = await client.searchDepartments({
-            shogo, compno, bKwd, cList,
-        });
+        return `企業情報: 該当なし（マッチパターン: ${matchPattern}）`;
+    })
+        .catch((e) => `企業情報: ${e instanceof Error ? e.message : "取得失敗"}`);
+    const deptPromise = client.searchDepartments({ shogo, compno, bKwd, cList })
+        .then(({ docs, numFound }) => {
         if (docs.length > 0) {
             const displayed = docs.slice(0, 15);
             const companyName = f(docs[0].shogo);
-            sections.push(`\n## 部署情報${companyName ? `: ${companyName}` : ""}（全${numFound}件中${displayed.length}件表示）`);
-            sections.push(displayed.map((d, i) => formatDepartmentDoc(d, i + 1)).join("\n\n"));
+            let text = `\n## 部署情報${companyName ? `: ${companyName}` : ""}（全${numFound}件中${displayed.length}件表示）\n`;
+            text += displayed.map((d, i) => formatDepartmentDoc(d, i + 1)).join("\n\n");
             if (numFound > 15) {
-                sections.push(`\n> 残り${numFound - 15}件はbizgate__department_searchで個別に取得できます。`);
+                text += `\n\n> 残り${numFound - 15}件はbizgate__department_searchで個別に取得できます。`;
             }
+            return text;
         }
-        else {
-            sections.push("\n## 部署情報\n該当なし");
-        }
-    }
-    catch (e) {
-        if (e instanceof BizGateApiError && e.code === "504") {
-            sections.push("\n## 部署情報\nデータなし");
-        }
-        else {
-            sections.push(`\n## 部署情報\n${e instanceof Error ? e.message : "取得失敗"}`);
-        }
-    }
-    // 3. Keyman info
-    if (skeyKeyman) {
-        try {
-            const { docs, numFound } = await client.searchKeyman({
-                shogo, compno, bKwd, cList,
-            });
+        return "\n## 部署情報\n該当なし";
+    })
+        .catch((e) => {
+        if (e instanceof BizGateApiError && e.code === "504")
+            return "\n## 部署情報\nデータなし";
+        return `\n## 部署情報\n${e instanceof Error ? e.message : "取得失敗"}`;
+    });
+    const keymanPromise = skeyKeyman
+        ? client.searchKeyman({ shogo, compno, bKwd, cList })
+            .then(({ docs, numFound }) => {
             if (docs.length > 0) {
                 const companyName = f(docs[0].shogo);
-                sections.push(`\n## 人事情報${companyName ? `: ${companyName}` : ""}（全${numFound}件）`);
-                sections.push(docs.map((d, i) => formatKeymanDoc(d, i + 1)).join("\n\n"));
-            }
-            else {
-                sections.push("\n## 人事情報\n該当なし");
-            }
-        }
-        catch (e) {
-            if (e instanceof BizGateApiError && e.code === "604") {
-                sections.push("\n## 人事情報\nデータなし");
-            }
-            else {
-                sections.push(`\n## 人事情報\n${e instanceof Error ? e.message : "取得失敗"}`);
+                return `\n## 人事情報${companyName ? `: ${companyName}` : ""}（全${numFound}件）\n` +
+                    docs.map((d, i) => formatKeymanDoc(d, i + 1)).join("\n\n");
             }
-        }
-    }
+            return "\n## 人事情報\n該当なし";
+        })
+            .catch((e) => {
+            if (e instanceof BizGateApiError && e.code === "604")
+                return "\n## 人事情報\nデータなし";
+            return `\n## 人事情報\n${e instanceof Error ? e.message : "取得失敗"}`;
+        })
+        : Promise.resolve("");
+    const [companyText, deptText, keymanText] = await Promise.all([
+        companyPromise, deptPromise, keymanPromise,
+    ]);
+    const sections = [companyText, deptText, keymanText].filter(Boolean);
     return {
         content: [{ type: "text", text: sections.join("\n") + usageFooter() }],
     };

package/dist/install-skill.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/install-skill.js

@@ -0,0 +1,107 @@
+#!/usr/bin/env node
+import { mkdirSync, writeFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+const SKILL_DIR = join(homedir(), ".claude", "skills", "prospect-match");
+const SKILL_MD = `---
+name: prospect-match
+description: |
+  企業の部署リストとDigiManサービスをマッチングし、営業ターゲット部署を提案する。
+  "売れそうな部署", "部署マッチング", "prospect", "ターゲット部署", "영업 타겟",
+  "DigiManのサービスが売れそうな", "サービスが売れそう", "営業代行", "Solution", "AI",
+  "どの部署に売れる", "ターゲット探して", "部署を探して"
+user-invocable: true
+argument-hint: "[会社名] [サービス種別(営業代行/Solution/AI/全部)]"
+allowed-tools: mcp__bizgate__bizgate__department_search, mcp__bizgate__bizgate__keyman_search, mcp__bizgate__bizgate__company_search, Read, Grep, Glob, AskUserQuestion
+---
+
+# Prospect Match: 企業部署 × DigiManサービス マッチング
+
+企業名を受け取り、BizGate APIで部署情報を取得し、DigiManのサービスに適した営業ターゲット部署を提案するスキルです。
+
+## DigiManサービス定義
+
+### 1. 営業代行
+- **内容**: 営業チームのKPIダッシュボード、架電/アポ進捗管理、担当者別パフォーマンス分析
+- **ターゲット部署の特徴**: 営業組織を持つ部署、営業企画、営業管理、営業推進
+- **マッチキーワード**: 営業, 販売, 販促, 商品, 事業開発, マーケティング, 顧客
+
+### 2. Solution
+- **内容**: 内部管理システム（DB・データ分析・ダッシュボード構築）
+- **ターゲット部署の特徴**: DX推進、経営企画、総務、システム、業務改善担当
+- **マッチキーワード**: ICT, システム, DX, 情報, 企画, 経営企画, 総務, 管理, イノベーション, デジタル
+
+### 3. AI
+- **内容**: Claude × BizGate連携MCP。自然言語で企業情報を検索・取得
+- **ターゲット部署の特徴**: 新規事業、事業創造、戦略推進、営業企画
+- **マッチキーワード**: 戦略, 成長, 事業創造, イノベーション, 企画, 開発, 推進, DX, AI, ICT
+
+## プロセス
+
+### Step 1: 入力を解析
+- ユーザーの入力から **会社名** と **対象サービス** を特定する
+- サービスが指定されていない場合は「全部」として3サービスすべてをマッチングする
+- 会社名が不明な場合は \`AskUserQuestion\` で確認する
+
+### Step 2: 部署情報を取得
+- \`bizgate__department_search\` で部署一覧を取得する（limit: 200）
+- 電話番号がある部署は電話番号も含める
+
+### Step 3: サービスとマッチング
+各サービスについて、以下の基準で部署をマッチングする：
+
+1. **部署名にマッチキーワードが含まれるか** を確認
+2. **部署のカテゴリ（ctg_01〜15）** も参考にする：
+   - 営業代行 → ctg_02(営業企画), ctg_13(営業)
+   - Solution → ctg_01(経営企画), ctg_05(総務), ctg_10(システム)
+   - AI → ctg_01(経営企画), ctg_02(営業企画), ctg_10(システム)
+3. キーワードマッチだけでなく、**部署の役割から判断** して適切な部署を選ぶ
+
+### Step 4: 結果を出力
+以下のフォーマットで出力する：
+
+## [会社名] × DigiMan サービスマッチング
+
+### 1. 営業代行
+| 部署名 | 電話番号 | マッチ理由 |
+|--------|---------|----------|
+
+### 2. Solution
+| 部署名 | 電話番号 | マッチ理由 |
+|--------|---------|----------|
+
+### 3. AI
+| 部署名 | 電話番号 | マッチ理由 |
+|--------|---------|----------|
+
+### 最優先アプローチ先
+[3サービスに共通して関連性が高い部署をピックアップ]
+
+## 注意事項
+- 電話番号がない部署は「-」と表示する
+- 各サービスにつき最大5部署まで提案する（多すぎると選べない）
+- 明らかに関連のない部署（畜産、食品など事業部門）はスキップする
+- マッチ理由は1行で簡潔に書く
+- ユーザーの言語（日本語 or 韓国語）に合わせて出力する
+
+---
+
+$ARGUMENTS
+`;
+function main() {
+    const existed = existsSync(join(SKILL_DIR, "SKILL.md"));
+    mkdirSync(SKILL_DIR, { recursive: true });
+    writeFileSync(join(SKILL_DIR, "SKILL.md"), SKILL_MD, "utf-8");
+    if (existed) {
+        console.log("✔ prospect-match スキルを更新しました");
+    }
+    else {
+        console.log("✔ prospect-match スキルをインストールしました");
+    }
+    console.log(`  場所: ${SKILL_DIR}/SKILL.md`);
+    console.log("");
+    console.log("使い方:");
+    console.log("  /prospect-match 会社名");
+    console.log('  または「○○にDigiManのサービスが売れそうな部署を探して」');
+}
+main();

package/dist/usage-tracker.d.ts

@@ -8,6 +8,10 @@ export declare class UsageTracker {
     private writeState;
     /** Increment counter before making an API call. Throws if limit exceeded. */
     increment(cost?: number): number;
+    /** Check if limit allows the call, but don't increment yet. Throws if limit exceeded. */
+    checkLimit(cost?: number): void;
+    /** Decrement counter (rollback on API failure). */
+    decrement(cost?: number): void;
     /** Remaining requests for today. */
     remaining(): number;
     /** Current usage count for today. */

package/dist/usage-tracker.js

@@ -36,6 +36,19 @@ export class UsageTracker {
         this.writeState(state);
         return state.count;
     }
+    /** Check if limit allows the call, but don't increment yet. Throws if limit exceeded. */
+    checkLimit(cost = 1) {
+        const state = this.readState();
+        if (state.count + cost > this.limit) {
+            throw new Error(`本日のAPI利用上限（${this.limit}回）に達しました。明日以降に再度お試しください。`);
+        }
+    }
+    /** Decrement counter (rollback on API failure). */
+    decrement(cost = 1) {
+        const state = this.readState();
+        state.count = Math.max(0, state.count - cost);
+        this.writeState(state);
+    }
     /** Remaining requests for today. */
     remaining() {
         const state = this.readState();

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "bizgate-mcp-server",
-  "version": "0.3.0",
+  "version": "0.3.3",
   "description": "BizGate APIとClaudeを連携するMCPサーバー",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
-    "bizgate-mcp-server": "dist/index.js"
+    "bizgate-mcp-server": "dist/index.js",
+    "bizgate-install-skill": "dist/install-skill.js"
   },
   "files": [
     "dist"