bizgate-mcp-server 0.3.1 → 0.3.4

package/README.md

@@ -58,17 +58,27 @@ Mac の場合：
 
 ターミナルに以下を **そのままコピーして貼り付け** → Enter を押してください。
 
+```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 <(curl -sL https://raw.githubusercontent.com/digiman-hq/bizgate-mcp-server/dev/install.sh)
-```
-
-画面の案内に従って、管理者から受け取った認証情報を入力してください。
 
-- ユーザー名
-- パスワード（入力しても画面に表示されません）
-- サービスキー
-
-すべて入力すると、自動でセットアップが完了します。
+- サービスキーを誤って入力した場合
+    
+    ```bash
+    claude mcp remove bizgate -s user
+    ```
+    
+    その後、再度入力してください。
 
 ---
 
@@ -108,6 +118,33 @@ claude
 | 採用活動をしている会社か確認 | 「○○のマーケティングタグを教えて」 |
 | 全情報をまとめて見たい | 「○○の全情報を調べて」 |
 | Excelに入力したい | 「○○の情報を調べてExcelに入れて」 |
+| DigiManのサービスに合う部署を探したい | 「○○にDigiManのサービスが売れそうな部署を探して」 |
+
+### prospect-match スキル（部署マッチング）
+
+企業の部署一覧から、DigiManの各サービス（営業代行・Solution・AI）に適した営業ターゲット部署を自動で提案するスキルです。
+
+```
+/prospect-match 兼松株式会社
+```
+
+または自然言語でもOK：
+```
+「兼松株式会社にDigiManのサービスが売れそうな部署を探して」
+```
+
+**出力内容：**
+- サービスごとの推薦部署（最大5件ずつ）+ 電話番号
+- マッチ理由
+- 最優先アプローチ先
+
+**すでにBizGate MCPをインストール済みの方** は、以下でスキルだけ追加できます：
+
+```bash
+bash install-skill.sh
+```
+
+新規インストールの場合は `install.sh` にスキルも含まれています。
 
 ### 注意点
 
@@ -124,7 +161,7 @@ claude
 本サーバーには以下の最適化が組み込まれています。
 
 ### APIコール節約
-- **60秒キャッシュ**: 同じ会社を60秒以内に再検索した場合、APIを消費しません
+- **5分キャッシュ**: 同じ会社を5分以内に再検索した場合、APIを消費しません
 - **キーマン詳細の並列取得**: 5件ずつ並列リクエストで高速化
 
 ### LLMトークン節約

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

@@ -8,6 +8,12 @@ export function first(field) {
 }
 // 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

@@ -1,4 +1,10 @@
 #!/usr/bin/env node
+// ---------- --install-skill サブコマンド ----------
+if (process.argv.includes("--install-skill")) {
+    const { main: installSkill } = await import("./install-skill.js");
+    installSkill();
+    process.exit(0);
+}
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
@@ -6,7 +12,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 +58,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() {

package/dist/install-skill.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export declare function main(): void;

package/dist/install-skill.js

@@ -0,0 +1,111 @@
+#!/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
+`;
+export 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のサービスが売れそうな部署を探して」');
+}
+// 直接実行された場合のみ実行
+const isDirectRun = process.argv[1]?.endsWith("install-skill.js");
+if (isDirectRun) {
+    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,6 +1,6 @@
 {
   "name": "bizgate-mcp-server",
-  "version": "0.3.1",
+  "version": "0.3.4",
   "description": "BizGate APIとClaudeを連携するMCPサーバー",
   "type": "module",
   "main": "dist/index.js",