bizgate-mcp-server 0.4.0 → 0.4.1

package/README.md

@@ -60,8 +60,8 @@ Mac の場合：
 
 ```smalltalk
 claude mcp add bizgate --scope user \
-  -e "BIZGATE_USERNAME=digi-man_bizg1" \
-  -e "BIZGATE_PASSWORD=digi-man_bizg1" \
+  -e "BIZGATE_USERNAME=digi-man_testbizg1" \
+  -e "BIZGATE_PASSWORD=digi-man_testbizg1" \
   -e "BIZGATE_AUTH_MODE=basic" \
   -e "BIZGATE_DAILY_LIMIT=200" \
   -e "BIZGATE_SKEY_COMPANY=/EhMJ9YMCJtJgo73.DjLuew8rnnTlb.F6/MuiESFXmZwlCKvG8bMm" \

package/dist/index.d.ts

@@ -1,2 +1,6 @@
 #!/usr/bin/env node
 import "./shared/env.js";
+import { BizGateClient } from "./bizgate-client.js";
+import { UsageTracker } from "./usage-tracker.js";
+export declare const usageTracker: UsageTracker;
+export declare const client: BizGateClient;

package/dist/index.js

@@ -64,8 +64,8 @@ const config = {
     app: process.env.BIZGATE_APP,
     dailyLimit,
 };
-const usageTracker = new UsageTracker(usageFile, dailyLimit);
-const client = new BizGateClient(config, usageTracker);
+export const usageTracker = new UsageTracker(usageFile, dailyLimit);
+export const client = new BizGateClient(config, usageTracker);
 const seedCache = new SeedCache(seedCsvUrl);
 const resultCache = new BizGateResultCache(sharedCacheUrl);
 const jpxCache = new JpxCache(process.env.JPX_DATA_URL);

package/dist/papatto/friendly-errors.d.ts

@@ -0,0 +1,8 @@
+export declare function friendlyError(err: unknown, opts?: {
+    lang?: "ja" | "ko";
+    context?: string;
+}): {
+    message: string;
+    code: string;
+    raw: string;
+};

package/dist/papatto/friendly-errors.js

@@ -0,0 +1,103 @@
+const FRIENDLY_ERRORS = [
+    {
+        pattern: /econnreset|connection.*reset|timeout|ETIMEDOUT|ENOTFOUND|EAI_AGAIN/i,
+        ja: "😥 Papatto / BizGate サイトへの接続が一時的に不安定です。5 分後にもう一度同じご依頼をお願いします。",
+        ko: "😥 Papatto / BizGate 사이트 접속이 잠깐 불안정해요. 5분 후에 다시 같은 요청해주세요.",
+        code: "ERR-NET-CONN",
+    },
+    {
+        pattern: /drive.*storage.*quota|storage quota.*exceeded/i,
+        ja: "😥 Google Drive の保存容量が不足しています。管理者にご連絡ください。",
+        ko: "😥 구글 드라이브 저장 용량이 부족해요. IT 관리자에게 알려주세요.",
+        code: "ERR-DRIVE-QUOTA",
+    },
+    {
+        pattern: /caller does not have permission|permission_denied|403/i,
+        ja: "😥 Google Sheets へのアクセス権限が設定されていません。管理者にご確認ください。",
+        ko: "😥 구글 시트 권한 설정이 되어있지 않아요. IT 관리자에게 알려주세요.",
+        code: "ERR-SHEETS-PERM",
+    },
+    {
+        pattern: /今月のダウンロード.*上限|download.*quota.*exhausted/i,
+        ja: "📊 今月の Papatto ダウンロード上限に達しました。月初にリセットされます。今月は別のリストをご活用ください。",
+        ko: "📊 이번 달 Papatto 다운로드 한도에 도달했어요. 다음 달 1일에 리셋됩니다. 이번 달엔 기존 리스트 활용해주세요.",
+        code: "ERR-PAPATTO-DL-LIMIT",
+    },
+    {
+        pattern: /検索回数.*上限|search.*quota.*exceeded/i,
+        ja: "📊 今月の Papatto 検索回数上限に達しました。月初にリセットされます。",
+        ko: "📊 이번 달 Papatto 검색 회수 한도에 도달했어요.",
+        code: "ERR-PAPATTO-SEARCH-LIMIT",
+    },
+    {
+        pattern: /no papatto credential|credential not stored|credentials? not found/i,
+        ja: "🔑 Papatto のログイン情報がまだ登録されていません。先に「Papatto アカウントを登録」とお伝えください。",
+        ko: "🔑 Papatto 로그인 정보가 아직 없어요. 먼저 'Papatto 계정 등록' 이라고 알려주세요.",
+        code: "ERR-NO-CRED",
+    },
+    {
+        pattern: /papatto login failed|invalid.*credentials/i,
+        ja: "🔑 Papatto へのログインに失敗しました。パスワードを確認して再登録してください。",
+        ko: "🔑 Papatto 로그인에 실패했어요. 비밀번호 확인 후 재등록 부탁드려요.",
+        code: "ERR-LOGIN-FAIL",
+    },
+    {
+        pattern: /master.*未生成|papatto.*master.*not.*found/i,
+        ja: "📚 Papatto のカテゴリ一覧 (マスタ) がまだ準備されていません。管理者にご連絡ください (一度だけ実行が必要)。",
+        ko: "📚 Papatto 카테고리 마스터가 아직 준비 안 됐어요. 관리자에게 알려주세요 (1회만 실행 필요).",
+        code: "ERR-NO-MASTER",
+    },
+    {
+        pattern: /検索ボタン.*見つかりません|search button not found/i,
+        ja: "😥 Papatto サイトの構造が変わったようです。管理者にご連絡ください。",
+        ko: "😥 Papatto 사이트 구조가 바뀐 것 같아요. 관리자에게 알려주세요.",
+        code: "ERR-PAPATTO-UI-CHANGED",
+    },
+    {
+        pattern: /1日のリクエスト上限|daily limit reached/i,
+        ja: "📊 今日の BizGate 利用回数を使い切りました。明日リセットされます。",
+        ko: "📊 오늘 BizGate 사용 회수를 다 썼어요. 내일 리셋됩니다.",
+        code: "ERR-BIZGATE-DAILY",
+    },
+    {
+        pattern: /サービスキー.*無効|invalid.*service.*key/i,
+        ja: "🔑 BizGate のサービスキーが無効です。管理者にご確認ください。",
+        ko: "🔑 BizGate 서비스 키가 유효하지 않아요. 관리자에게 알려주세요.",
+        code: "ERR-BIZGATE-KEY",
+    },
+    {
+        pattern: /該当する企業が見つかりません|company not found/i,
+        ja: "🔍 該当する会社が見つかりませんでした。会社名を正式名称 (例: 株式会社○○) で入れてみてください。",
+        ko: "🔍 해당하는 회사를 못 찾았어요. 회사명을 정식명 (예: 株式会社○○)으로 입력해주세요.",
+        code: "ERR-NO-COMPANY",
+    },
+];
+const GENERIC_FALLBACK = {
+    ja: "😥 予期しないエラーが発生しました。下のエラーコードを IT 担当者にお伝えください。",
+    ko: "😥 예상치 못한 오류가 발생했어요. 아래 오류 코드를 IT 담당자에게 알려주세요.",
+};
+function timestamp() {
+    const d = new Date();
+    const pad = (n) => String(n).padStart(2, "0");
+    return `${d.getFullYear()}${pad(d.getMonth() + 1)}${pad(d.getDate())}-${pad(d.getHours())}${pad(d.getMinutes())}`;
+}
+export function friendlyError(err, opts = {}) {
+    const lang = opts.lang ?? "ja";
+    const raw = err instanceof Error ? err.message : String(err);
+    for (const entry of FRIENDLY_ERRORS) {
+        if (entry.pattern.test(raw)) {
+            const code = `${entry.code}-${timestamp()}`;
+            return {
+                message: `${entry[lang]}\n\n🔎 エラーコード: \`${code}\``,
+                code,
+                raw,
+            };
+        }
+    }
+    const code = `ERR-UNKNOWN-${timestamp()}`;
+    return {
+        message: `${GENERIC_FALLBACK[lang]}\n\n🔎 エラーコード: \`${code}\`\n📝 詳細: ${raw.slice(0, 200)}`,
+        code,
+        raw,
+    };
+}

package/dist/papatto/page-extract.d.ts

@@ -0,0 +1,55 @@
+import { type PapattoConditions } from "./search.js";
+export interface PageCompanyRow {
+    name: string;
+    corporate_number?: string;
+    industry?: string;
+    address?: string;
+    phone?: string;
+    capital_size?: string;
+    emp_size?: string;
+    fiscal_month?: string;
+    market_type?: string;
+    department_url?: string;
+    clicksearch_url?: string;
+    has_finance_report?: boolean;
+    raw_text?: string;
+}
+export interface PageExtractOutcome {
+    num_found: number | null;
+    company_count: number | null;
+    page_url: string;
+    pages_visited: number;
+    companies: PageCompanyRow[];
+    csv_local_path?: string;
+    search_quota?: {
+        used: number;
+        limit: number;
+    };
+    download_quota?: {
+        used: number;
+        limit: number;
+        exhausted: boolean;
+    };
+    error?: string;
+    error_screenshot_url?: string;
+    row_selector_used?: string;
+    debug_row_candidates?: Array<{
+        selector: string;
+        matched: number;
+        sample_text: string;
+    }>;
+    debug_body_snippet?: string;
+    debug_element_dist?: Record<string, number>;
+}
+export interface PageExtractOptions {
+    slack_user_id: string;
+    campaign_id: string;
+    conditions: PapattoConditions;
+    max_companies?: number;
+    throttle_ms?: number;
+    headless?: boolean;
+    search_url?: string;
+    row_selector?: string;
+    debug?: boolean;
+}
+export declare function runSearchOnly(opts: PageExtractOptions): Promise<PageExtractOutcome>;

package/dist/papatto/page-extract.js

@@ -0,0 +1,324 @@
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { openSession } from "./playwright-session.js";
+import { applyConditions, clickSearch, readCounts, readQuotas, activatedTabs, loadMaster, } from "./search.js";
+import { runQueued } from "../queue/playwright-queue.js";
+import { log } from "../shared/logger.js";
+const ROW_SELECTOR_CANDIDATES = [
+    ".result-document",
+    "table.result tbody tr",
+    "table.list tbody tr",
+    "table.companies tbody tr",
+    ".result-row",
+    ".company-row",
+    '[class*="result"] > [class*="row"]',
+    '[class*="company"] > [class*="row"]',
+    "table tbody tr",
+    "ol > li",
+    "ul.results > li",
+];
+const NEXT_BUTTON_CANDIDATES = [
+    'a:has-text("次へ")',
+    'a:has-text("次")',
+    'a[title*="次"]',
+    'a[rel="next"]',
+    'a.next',
+    'button:has-text("次へ")',
+];
+function escapeCsv(value) {
+    if (/[",\r\n]/.test(value))
+        return `"${value.replace(/"/g, '""')}"`;
+    return value;
+}
+function rowsToCsv(rows) {
+    const headers = [
+        "name",
+        "corporate_number",
+        "industry",
+        "address",
+        "phone",
+        "capital_size",
+        "emp_size",
+        "fiscal_month",
+        "market_type",
+        "has_finance_report",
+        "department_url",
+        "clicksearch_url",
+    ];
+    const lines = [headers.join(",")];
+    for (const r of rows) {
+        lines.push(headers
+            .map((h) => escapeCsv(r[h] ?? ""))
+            .join(","));
+    }
+    return lines.join("\n");
+}
+async function captureRowCandidates(page) {
+    return page.evaluate((candidates) => {
+        const out = [];
+        for (const sel of candidates) {
+            try {
+                const els = document.querySelectorAll(sel);
+                if (els.length > 0) {
+                    out.push({
+                        selector: sel,
+                        matched: els.length,
+                        sample_text: (els[0].textContent || "").trim().slice(0, 120),
+                    });
+                }
+            }
+            catch {
+                // invalid selector
+            }
+        }
+        return out;
+    }, ROW_SELECTOR_CANDIDATES);
+}
+async function pickRowSelector(page, hint) {
+    if (hint) {
+        const c = await page.locator(hint).count();
+        if (c > 1)
+            return hint;
+    }
+    const candidates = await captureRowCandidates(page);
+    if (candidates.length === 0)
+        return null;
+    const best = candidates
+        .filter((c) => c.matched >= 2 && c.matched <= 200)
+        .sort((a, b) => b.matched - a.matched)[0];
+    return best?.selector ?? null;
+}
+async function parseRowsOnPage(page, rowSelector) {
+    const raw = await page.evaluate((sel) => {
+        function textOf(el) {
+            if (!el)
+                return "";
+            return (el.textContent || "").replace(/\s+/g, " ").trim();
+        }
+        function pick(text, re) {
+            const m = text.match(re);
+            return m ? m[0] : undefined;
+        }
+        const rows = Array.from(document.querySelectorAll(sel));
+        const out = [];
+        for (const row of rows) {
+            // Papatto .result-document 構造想定. 他セレクタにも汎用フォールバック.
+            const titleEl = row.querySelector(".company_line .title") ??
+                row.querySelector(".company_link .title") ??
+                row.querySelector(".title");
+            const name = textOf(titleEl) || textOf(row.querySelector("a"));
+            if (!name)
+                continue;
+            const record = { name };
+            // 法人番号 (.company_line 안 13자리 숫자)
+            const companyLineText = textOf(row.querySelector(".company_line")) || textOf(row);
+            const compno = pick(companyLineText, /\b\d{13}\b/);
+            if (compno)
+                record.corporate_number = compno;
+            // .result-meta 의 텍스트에서 각 컬럼 추출
+            const metaEl = row.querySelector(".result-meta");
+            const metaText = textOf(metaEl) || textOf(row);
+            // 업종 (XXXX_명칭 형식)
+            const ind = pick(metaText, /\d{4}_[^\s０-９\d]+(?:[・･、]?[^\s０-９\d]+)?/);
+            if (ind)
+                record.industry = ind;
+            // 주소 (도도부현 시작)
+            const addr = pick(metaText, /(?:東京都|北海道|大阪府|京都府|[^\s]{2,3}県)[^\s０-９][^\s]*/);
+            if (addr)
+                record.address = addr;
+            // 전화
+            const phone = pick(metaText, /\b0\d{1,3}-\d{1,4}-\d{4}\b/);
+            if (phone)
+                record.phone = phone;
+            // 자본 규모 (例: "６．50億以上" / "2．1000万-3000万未満")
+            const cap = pick(metaText, /[０-９\d]+[．\.][\s]*[\d一-鿿,億万兆\-未満以上]+/);
+            if (cap)
+                record.capital_size = cap;
+            // 종업원 규모
+            const emp = pick(metaText, /[０-９\d]+[．\.][\s]*[\d一-鿿,人未満以上\-]+/g)
+                ? metaText.match(/[０-９\d]+[．\.][\s]*[\d一-鿿,人未満以上\-]+人[未満以上]*/)?.[0]
+                : undefined;
+            if (emp)
+                record.emp_size = emp;
+            // 결산월
+            const fiscal = pick(metaText, /(?<![\d])(?:1[0-2]|[1-9])月(?![\d])/);
+            if (fiscal)
+                record.fiscal_month = fiscal;
+            // 부서 페이지 URL
+            const deptHref = row.querySelector('a[href*="dptpapatto.php"]')?.getAttribute("href");
+            if (deptHref)
+                record.department_url = deptHref.startsWith("http") ? deptHref : `https://www.papatto.info${deptHref}`;
+            // ClickSearch URL
+            const csA = row.querySelector(".clicksrc")?.closest("a");
+            const csHref = csA?.getAttribute("href");
+            if (csHref)
+                record.clicksearch_url = csHref;
+            // 유가증권 보고서 보유 여부
+            if (row.querySelector(".financeR"))
+                record.has_finance_report = true;
+            out.push(record);
+        }
+        return out;
+    }, rowSelector);
+    return raw;
+}
+async function gotoNextPage(page) {
+    for (const sel of NEXT_BUTTON_CANDIDATES) {
+        const loc = page.locator(sel).first();
+        if ((await loc.count()) > 0 && (await loc.isEnabled().catch(() => false))) {
+            const beforeUrl = page.url();
+            try {
+                await Promise.all([
+                    page.waitForLoadState("domcontentloaded").catch(() => undefined),
+                    loc.click({ timeout: 5000 }),
+                ]);
+            }
+            catch {
+                return false;
+            }
+            const afterUrl = page.url();
+            return afterUrl !== beforeUrl;
+        }
+    }
+    return false;
+}
+export async function runSearchOnly(opts) {
+    const master = loadMaster();
+    if (!master) {
+        throw new Error("Papatto マスタ未生成。先に papatto__master_refresh を実行してください。");
+    }
+    return runQueued(() => runSearchOnlyInner(opts, master), `search_only:${opts.campaign_id}`);
+}
+async function runSearchOnlyInner(opts, master) {
+    const maxCompanies = Math.max(1, Math.min(opts.max_companies ?? 100, 2000));
+    const throttle = Math.max(300, opts.throttle_ms ?? 1500);
+    const session = await openSession(opts.slack_user_id, { headless: opts.headless ?? true });
+    let pagesVisited = 0;
+    let lastError;
+    let rowSelectorUsed;
+    let debugCandidates;
+    const collected = [];
+    try {
+        const { page } = session;
+        const searchUrl = opts.search_url ?? master.source_url;
+        await page.goto(searchUrl, { waitUntil: "domcontentloaded" });
+        await page.waitForTimeout(800);
+        activatedTabs.clear();
+        await applyConditions(page, opts.conditions, master);
+        await clickSearch(page);
+        await page.waitForLoadState("networkidle", { timeout: 15_000 }).catch(() => undefined);
+        await page.waitForTimeout(500);
+        const counts = await readCounts(page);
+        const quotas = await readQuotas(page);
+        const rowSelector = await pickRowSelector(page, opts.row_selector);
+        if (!rowSelector) {
+            const cand = await captureRowCandidates(page);
+            const dist = await page.evaluate(() => {
+                const out = {};
+                const all = document.querySelectorAll("body *");
+                for (const el of Array.from(all)) {
+                    const tag = el.tagName.toLowerCase();
+                    out[tag] = (out[tag] ?? 0) + 1;
+                }
+                return out;
+            });
+            const snippet = await page.evaluate(() => {
+                const knownIds = ["result_panel", "search_result", "search_results", "result", "results", "search-result", "main", "content"];
+                for (const id of knownIds) {
+                    const el = document.getElementById(id) ?? document.querySelector(`.${id}`);
+                    if (el && (el.innerHTML || "").length > 1000) {
+                        return `<!-- matched: #${id} or .${id} -->\n` + (el.innerHTML || "").slice(0, 8000);
+                    }
+                }
+                const all = document.querySelectorAll("body *");
+                for (const el of Array.from(all)) {
+                    const text = el.textContent || "";
+                    if (/会社数\s*[\d,]+\s*社/.test(text) && (el.innerHTML || "").length > 800 && (el.innerHTML || "").length < 200000) {
+                        return `<!-- matched: ${el.tagName.toLowerCase()}#${el.id}.${el.className} (件数 영역) -->\n` + (el.innerHTML || "").slice(0, 8000);
+                    }
+                }
+                return "<!-- fallback: body 끝 부분 -->\n" + document.body.innerHTML.slice(-8000);
+            });
+            return {
+                num_found: counts.records,
+                company_count: counts.companies,
+                page_url: page.url(),
+                pages_visited: 1,
+                companies: [],
+                search_quota: quotas.search,
+                download_quota: quotas.download,
+                error: "行セレクタが特定できませんでした。row_selector を明示するか、debug:true で候補を確認してください。",
+                debug_row_candidates: cand,
+                debug_element_dist: dist,
+                debug_body_snippet: snippet,
+            };
+        }
+        rowSelectorUsed = rowSelector;
+        if (opts.debug)
+            debugCandidates = await captureRowCandidates(page);
+        while (collected.length < maxCompanies) {
+            pagesVisited++;
+            const rows = await parseRowsOnPage(page, rowSelector);
+            for (const r of rows) {
+                if (collected.length >= maxCompanies)
+                    break;
+                collected.push(r);
+            }
+            if (collected.length >= maxCompanies)
+                break;
+            const movedNext = await gotoNextPage(page);
+            if (!movedNext)
+                break;
+            await page.waitForTimeout(throttle);
+            if (pagesVisited > 200) {
+                log("warn", "page-extract: exceeded 200 page cap", { campaign_id: opts.campaign_id });
+                break;
+            }
+        }
+        const destDir = join(homedir(), ".papatto-bizgate", "downloads", opts.campaign_id);
+        if (!existsSync(destDir))
+            mkdirSync(destDir, { recursive: true });
+        const csvPath = join(destDir, `page_extract__${Date.now()}.csv`);
+        writeFileSync(csvPath, rowsToCsv(collected), "utf-8");
+        log("info", "page-extract csv saved", {
+            campaign_id: opts.campaign_id,
+            companies: collected.length,
+            pages: pagesVisited,
+            throttle_ms: throttle,
+        });
+        return {
+            num_found: counts.records,
+            company_count: counts.companies,
+            page_url: page.url(),
+            pages_visited: pagesVisited,
+            companies: collected,
+            csv_local_path: csvPath,
+            search_quota: quotas.search,
+            download_quota: quotas.download,
+            row_selector_used: rowSelectorUsed,
+            debug_row_candidates: debugCandidates,
+        };
+    }
+    catch (e) {
+        lastError = e instanceof Error ? e : new Error(String(e));
+        log("error", "page-extract failed", {
+            campaign_id: opts.campaign_id,
+            error: lastError.message,
+            pages_visited: pagesVisited,
+        });
+        return {
+            num_found: null,
+            company_count: null,
+            page_url: session.page.url(),
+            pages_visited: pagesVisited,
+            companies: collected,
+            error: lastError.message,
+            row_selector_used: rowSelectorUsed,
+            debug_row_candidates: debugCandidates,
+        };
+    }
+    finally {
+        await session.close();
+    }
+}

package/dist/papatto/pipeline.d.ts

@@ -0,0 +1,67 @@
+import type { PapattoConditions } from "./search.js";
+export interface EnrichedCompany {
+    name: string;
+    papatto_industry?: string;
+    papatto_address?: string;
+    papatto_phone?: string;
+    papatto_capital?: string;
+    papatto_emp?: string;
+    papatto_fiscal_month?: string;
+    bizgate_matched: boolean;
+    match_pattern?: string;
+    corporate_number?: string;
+    ceo?: string;
+    revenue?: string;
+    industry?: string;
+    hp_url?: string;
+    email?: string;
+    capital?: string;
+    emp?: string;
+    departments?: Array<{
+        name: string;
+        phone?: string;
+    }>;
+    keymen?: Array<{
+        role: string;
+    }>;
+    priority_score: number;
+    priority_reason?: string;
+}
+export interface PipelineOptions {
+    slack_user_id: string;
+    campaign_id?: string;
+    conditions: PapattoConditions;
+    natural_language?: string;
+    candidates_limit?: number;
+    enrich_depth?: "basic" | "smart" | "full";
+    smart_top_n?: number;
+    smart_ranking?: "heuristic" | "llm";
+    headless?: boolean;
+    search_url?: string;
+}
+export interface PipelineOutcome {
+    campaign_id: string;
+    papatto_found: number;
+    papatto_extracted: number;
+    bizgate_matched: number;
+    bizgate_enriched_deep: number;
+    companies: EnrichedCompany[];
+    csv_local_path?: string;
+    r2_url?: string;
+    api_used: {
+        bizgate: number;
+    };
+    duration_ms: number;
+    error?: string;
+    search_quota?: {
+        used: number;
+        limit: number;
+    };
+    download_quota?: {
+        used: number;
+        limit: number;
+        exhausted: boolean;
+    };
+    ranking_mode: "heuristic" | "llm";
+}
+export declare function runPipeline(opts: PipelineOptions): Promise<PipelineOutcome>;

package/dist/papatto/pipeline.js

@@ -0,0 +1,295 @@
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { runSearchOnly } from "./page-extract.js";
+import { client as bizgateClient } from "../index.js";
+import { first } from "../bizgate-client.js";
+import * as r2 from "../cloud/r2-client.js";
+import * as neon from "../cloud/neon-client.js";
+import { log } from "../shared/logger.js";
+function genCampaignId() {
+    const d = new Date();
+    const pad = (n) => String(n).padStart(2, "0");
+    const dt = `${d.getFullYear()}${pad(d.getMonth() + 1)}${pad(d.getDate())}_${pad(d.getHours())}${pad(d.getMinutes())}`;
+    const rand = Math.random().toString(36).slice(2, 6);
+    return `${dt}_${rand}`;
+}
+function heuristicScore(c) {
+    let s = 50;
+    const reasons = [];
+    const cap = `${c.papatto_capital ?? ""} ${c.capital ?? ""}`;
+    if (/1兆|5000億|1000億/.test(cap)) {
+        s += 25;
+        reasons.push("超大企業規模");
+    }
+    else if (/500億|300億/.test(cap)) {
+        s += 18;
+        reasons.push("大企業");
+    }
+    else if (/100億|50億/.test(cap)) {
+        s += 10;
+        reasons.push("中堅規模");
+    }
+    const emp = `${c.papatto_emp ?? ""} ${c.emp ?? ""}`;
+    if (/5000人|1000人/.test(emp)) {
+        s += 12;
+        reasons.push("従業員 1000+");
+    }
+    else if (/500人|100人/.test(emp)) {
+        s += 6;
+        reasons.push("従業員 100~");
+    }
+    if (c.bizgate_matched) {
+        s += 5;
+        reasons.push("BizGate データ確保");
+    }
+    if (c.departments && c.departments.length >= 3) {
+        s += 5;
+        reasons.push(`部署 ${c.departments.length} 件`);
+    }
+    if (c.keymen && c.keymen.length > 0) {
+        s += 10;
+        reasons.push(`キーマン情報あり`);
+    }
+    if (c.hp_url) {
+        s += 2;
+    }
+    if (c.email) {
+        s += 3;
+        reasons.push("メール公開");
+    }
+    return {
+        score: Math.min(100, s),
+        reason: reasons.slice(0, 3).join(" / ") || "基本情報のみ",
+    };
+}
+async function enrichWithCompanySearch(rows) {
+    const items = [];
+    let calls = 0;
+    for (const r of rows) {
+        const ec = {
+            name: r.name,
+            papatto_industry: r.industry,
+            papatto_address: r.address,
+            papatto_phone: r.phone,
+            papatto_capital: r.capital_size,
+            papatto_emp: r.emp_size,
+            papatto_fiscal_month: r.fiscal_month,
+            corporate_number: r.corporate_number,
+            bizgate_matched: false,
+            priority_score: 0,
+        };
+        try {
+            const params = { shogo: r.name };
+            if (r.corporate_number)
+                params.compno = r.corporate_number;
+            const { matchPattern, docs } = await bizgateClient.searchCompany(params);
+            calls++;
+            if (docs.length > 0) {
+                const d = docs[0];
+                ec.bizgate_matched = true;
+                ec.match_pattern = matchPattern;
+                ec.corporate_number = d.compno;
+                ec.ceo = first(d.ceo);
+                ec.revenue = d.revenue ? String(d.revenue) : undefined;
+                ec.industry = first(d.gyoshu_facet);
+                ec.hp_url = first(d.hpurl);
+                ec.email = first(d.mail);
+                ec.capital = d.shihon ? String(d.shihon) : undefined;
+                ec.emp = d.emp ? String(d.emp) : undefined;
+            }
+        }
+        catch (e) {
+            log("warn", "bizgate company_search failed", { name: r.name, error: String(e) });
+        }
+        const sc = heuristicScore(ec);
+        ec.priority_score = sc.score;
+        ec.priority_reason = sc.reason;
+        items.push(ec);
+    }
+    return { items, api_calls: calls };
+}
+async function enrichDepartmentsAndKeymen(targets) {
+    let calls = 0;
+    for (const c of targets) {
+        if (!c.bizgate_matched)
+            continue;
+        try {
+            const dept = await bizgateClient.searchDepartments({
+                compno: c.corporate_number,
+                shogo: c.name,
+            });
+            calls++;
+            c.departments = dept.docs.slice(0, 10).map((d) => ({
+                name: first(d.bumon) || "(不明)",
+                phone: first(d.tel),
+            }));
+        }
+        catch (e) {
+            log("warn", "department_search failed", { name: c.name, error: String(e) });
+        }
+        try {
+            const km = await bizgateClient.searchKeyman({
+                compno: c.corporate_number,
+                shogo: c.name,
+            });
+            calls++;
+            c.keymen = km.docs.slice(0, 5).map((d) => ({ role: first(d.bumon) || "(不明)" }));
+        }
+        catch (e) {
+            log("warn", "keyman_search failed", { name: c.name, error: String(e) });
+        }
+        const sc = heuristicScore(c);
+        c.priority_score = sc.score;
+        c.priority_reason = sc.reason;
+    }
+    return calls;
+}
+function csvEscape(v) {
+    if (/[",\r\n]/.test(v))
+        return `"${v.replace(/"/g, '""')}"`;
+    return v;
+}
+function rowsToCsv(items) {
+    const headers = [
+        "priority_score",
+        "name",
+        "corporate_number",
+        "ceo",
+        "industry",
+        "revenue",
+        "capital",
+        "emp",
+        "papatto_address",
+        "papatto_phone",
+        "hp_url",
+        "email",
+        "departments",
+        "keymen",
+        "priority_reason",
+    ];
+    const lines = [headers.join(",")];
+    for (const c of items) {
+        const row = headers.map((h) => {
+            switch (h) {
+                case "departments":
+                    return csvEscape(c.departments?.map((d) => `${d.name}${d.phone ? `(${d.phone})` : ""}`).join("; ") ?? "");
+                case "keymen":
+                    return csvEscape(c.keymen?.map((k) => k.role).join("; ") ?? "");
+                default: {
+                    const v = c[h];
+                    return csvEscape(v != null ? String(v) : "");
+                }
+            }
+        });
+        lines.push(row.join(","));
+    }
+    return lines.join("\n");
+}
+export async function runPipeline(opts) {
+    const t0 = Date.now();
+    const campaign_id = opts.campaign_id ?? genCampaignId();
+    const ranking_mode = opts.smart_ranking ?? "heuristic";
+    const candidates_limit = Math.max(1, Math.min(opts.candidates_limit ?? 50, 200));
+    const depth = opts.enrich_depth ?? "smart";
+    const smart_top_n = Math.max(1, Math.min(opts.smart_top_n ?? 20, candidates_limit));
+    if (neon.isConfigured()) {
+        try {
+            await neon.insertCampaign({
+                campaign_id,
+                owner_slack_user_id: opts.slack_user_id,
+                natural_language_query: opts.natural_language,
+                papatto_conditions: opts.conditions,
+            });
+        }
+        catch (e) {
+            log("warn", "neon insertCampaign (pipeline) failed", { campaign_id, error: String(e) });
+        }
+    }
+    const search = await runSearchOnly({
+        slack_user_id: opts.slack_user_id,
+        campaign_id,
+        conditions: opts.conditions,
+        max_companies: candidates_limit,
+        headless: opts.headless ?? true,
+        search_url: opts.search_url,
+    });
+    if (search.error || search.companies.length === 0) {
+        if (neon.isConfigured()) {
+            await neon.updateCampaign({ campaign_id, status: "failed" }).catch(() => undefined);
+        }
+        return {
+            campaign_id,
+            papatto_found: search.company_count ?? 0,
+            papatto_extracted: 0,
+            bizgate_matched: 0,
+            bizgate_enriched_deep: 0,
+            companies: [],
+            api_used: { bizgate: 0 },
+            duration_ms: Date.now() - t0,
+            error: search.error ?? "検索結果が 0 件です",
+            search_quota: search.search_quota,
+            download_quota: search.download_quota,
+            ranking_mode,
+        };
+    }
+    const { items: enriched, api_calls: searchCalls } = await enrichWithCompanySearch(search.companies);
+    let deepCalls = 0;
+    let deeplyEnriched = 0;
+    if (depth === "smart") {
+        const sorted = [...enriched].sort((a, b) => b.priority_score - a.priority_score);
+        const top = sorted.slice(0, smart_top_n).filter((c) => c.bizgate_matched);
+        deepCalls = await enrichDepartmentsAndKeymen(top);
+        deeplyEnriched = top.length;
+    }
+    else if (depth === "full") {
+        const targets = enriched.filter((c) => c.bizgate_matched);
+        deepCalls = await enrichDepartmentsAndKeymen(targets);
+        deeplyEnriched = targets.length;
+    }
+    enriched.sort((a, b) => b.priority_score - a.priority_score);
+    const dir = join(homedir(), ".papatto-bizgate", "downloads", campaign_id);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    const csvPath = join(dir, `pipeline__${Date.now()}.csv`);
+    writeFileSync(csvPath, rowsToCsv(enriched), "utf-8");
+    let r2Url;
+    if (r2.isConfigured()) {
+        try {
+            const key = r2.csvKey(campaign_id, "pipeline.csv");
+            const up = await r2.uploadFile(key, csvPath, "text/csv; charset=utf-8");
+            r2Url = up.url;
+        }
+        catch (e) {
+            log("warn", "r2 upload (pipeline) failed", { campaign_id, error: String(e) });
+        }
+    }
+    if (neon.isConfigured()) {
+        try {
+            await neon.updateCampaign({
+                campaign_id,
+                status: "done",
+                extracted_count: enriched.length,
+                r2_extracted_url: r2Url,
+            });
+        }
+        catch (e) {
+            log("warn", "neon updateCampaign (pipeline) failed", { campaign_id, error: String(e) });
+        }
+    }
+    return {
+        campaign_id,
+        papatto_found: search.company_count ?? 0,
+        papatto_extracted: enriched.length,
+        bizgate_matched: enriched.filter((c) => c.bizgate_matched).length,
+        bizgate_enriched_deep: deeplyEnriched,
+        companies: enriched,
+        csv_local_path: csvPath,
+        r2_url: r2Url,
+        api_used: { bizgate: searchCalls + deepCalls },
+        duration_ms: Date.now() - t0,
+        search_quota: search.search_quota,
+        download_quota: search.download_quota,
+        ranking_mode,
+    };
+}

package/dist/papatto/search.d.ts

@@ -1,3 +1,5 @@
+import type { Page } from "playwright";
+import { type PapattoMaster } from "./master-extractor.js";
 export interface PapattoConditions {
     industries?: string[];
     papatto_tags?: string[];
@@ -39,6 +41,25 @@ export interface ExtractOutcome extends SearchOutcome {
     error?: string;
     error_screenshot_url?: string;
 }
+export declare function loadMaster(): PapattoMaster | null;
+export declare const activatedTabs: Set<string>;
+export declare function applyConditions(page: Page, conditions: PapattoConditions, master: PapattoMaster): Promise<SearchOutcome["applied"]>;
+export declare function readCounts(page: Page): Promise<{
+    records: number | null;
+    companies: number | null;
+}>;
+export declare function readQuotas(page: Page): Promise<{
+    download?: {
+        used: number;
+        limit: number;
+        exhausted: boolean;
+    };
+    search?: {
+        used: number;
+        limit: number;
+    };
+}>;
+export declare function clickSearch(page: Page): Promise<void>;
 export interface ExtractOptions {
     slack_user_id: string;
     campaign_id: string;

package/dist/papatto/search.js

@@ -8,7 +8,7 @@ import { runQueued } from "../queue/playwright-queue.js";
 import { log } from "../shared/logger.js";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const MASTER_PATH = join(__dirname, "..", "..", "data", "papatto_master.json");
-function loadMaster() {
+export function loadMaster() {
     if (!existsSync(MASTER_PATH))
         return null;
     try {
@@ -26,7 +26,7 @@ function findGroup(master, patterns) {
     }
     return undefined;
 }
-const activatedTabs = new Set();
+export const activatedTabs = new Set();
 async function activateTab(page, sectionId) {
     if (!sectionId)
         return;
@@ -208,7 +208,7 @@ async function applyFlags(page, master, flags) {
     }
     return ok;
 }
-async function applyConditions(page, conditions, master) {
+export async function applyConditions(page, conditions, master) {
     const applied = [];
     if (conditions.industries && conditions.industries.length > 0) {
         const { matched, missed } = await applyIndustries(page, master, conditions.industries);
@@ -264,7 +264,7 @@ async function applyConditions(page, conditions, master) {
     }
     return applied;
 }
-async function readCounts(page) {
+export async function readCounts(page) {
     const text = await page.locator("body").innerText().catch(() => "");
     const both = text.match(/([\d,]+)\s*件\s*\(\s*会社数\s*([\d,]+)\s*社\s*\)/);
     if (both) {
@@ -280,7 +280,7 @@ async function readCounts(page) {
     }
     return { records: null, companies: null };
 }
-async function readQuotas(page) {
+export async function readQuotas(page) {
     const text = await page.locator("body").innerText().catch(() => "");
     const out = {};
     const dl = text.match(/今月のダウンロード[:：]?\s*([\d,]+)\s*社\s*\/\s*([\d,]+)\s*社/);
@@ -298,7 +298,7 @@ async function readQuotas(page) {
     }
     return out;
 }
-async function clickSearch(page) {
+export async function clickSearch(page) {
     const candidates = [
         'input[value="Papatto検索"]',
         'button:has-text("Papatto検索")',

package/dist/papatto/tools.js

@@ -5,7 +5,10 @@ import { fileURLToPath } from "node:url";
 import { setCredential, deleteCredential, listAccounts, getCredential } from "./credentials.js";
 import { extractMaster, classifyGroup, } from "./master-extractor.js";
 import { runExtract } from "./search.js";
+import { runSearchOnly } from "./page-extract.js";
+import { runPipeline } from "./pipeline.js";
 import { parseCsv, sortRowsBy, takeTopN } from "./csv-parser.js";
+import { friendlyError } from "./friendly-errors.js";
 import * as r2 from "../cloud/r2-client.js";
 import * as neon from "../cloud/neon-client.js";
 import * as gsheets from "../sheets/client.js";
@@ -419,6 +422,287 @@ export function registerPapattoTools(server) {
             return fail(e instanceof Error ? e.message : String(e));
         }
     });
+    server.tool("papatto__pipeline", "【営業部向けメインフロー】自然言語 ICP → Papatto で会社発掘 → BizGate で精密データ補強 → 営業優先度評価 → Google Sheets まで一気通貫。" +
+        "Papatto ダウンロード上限 (月 4000 社) を使わず、検索回数 (月 500 回) のみ消費。" +
+        "enrich_depth=smart (デフォルト) で上位 N 社のみ部署 / キーマンまで深掘り (BizGate API 節約)。" +
+        "応答は営業部向けに親切なテキスト (上位 5 社プレビュー + 統計 + 次のアクション提案)。", {
+        slack_user_id: z.string().describe("Slack ユーザー ID"),
+        campaign_id: z.string().optional().describe("キャンペーン ID (未指定時は YYYYMMDD_HHMM_xxxx 自動生成)"),
+        natural_language: z.string().optional().describe("元の自然言語クエリ (DB 保存用、検索ロジック未使用)"),
+        conditions: z
+            .object({
+            industries: z.array(z.string()).optional(),
+            papatto_tags: z.array(z.string()).optional(),
+            intent_tags: z.array(z.string()).optional(),
+            flags: z
+                .array(z.enum(["tel", "email", "url", "updorg", "hasbusho", "isB2B", "isB2C", "financer"]))
+                .optional(),
+            keyword: z.string().optional(),
+            raw: z.record(z.union([z.string(), z.array(z.string())])).optional(),
+        })
+            .describe("papatto__extract と同形式の検索条件"),
+        candidates_limit: z.number().optional().describe("Papatto で発掘する会社数 (デフォルト 50、最大 200)"),
+        enrich_depth: z
+            .enum(["basic", "smart", "full"])
+            .optional()
+            .describe("BizGate 補強深度: basic=会社基本情報のみ / smart=上位 N 社のみ部署+キーマン (デフォルト) / full=全社の部署+キーマン"),
+        smart_top_n: z.number().optional().describe("smart 時の深堀対象数 (デフォルト 20)"),
+        smart_ranking: z
+            .enum(["heuristic", "llm"])
+            .optional()
+            .describe("優先度評価方式: heuristic=規模スコア (デフォルト) / llm=応答後 Claude が再評価する想定"),
+        headless: z.boolean().optional(),
+        search_url: z.string().optional(),
+    }, async ({ slack_user_id, campaign_id, natural_language, conditions, candidates_limit, enrich_depth, smart_top_n, smart_ranking, headless, search_url, }) => {
+        try {
+            const outcome = await runPipeline({
+                slack_user_id,
+                campaign_id,
+                natural_language,
+                conditions: conditions,
+                candidates_limit,
+                enrich_depth,
+                smart_top_n,
+                smart_ranking,
+                headless: headless ?? true,
+                search_url,
+            });
+            if (outcome.error) {
+                const f = friendlyError(outcome.error, { lang: "ja" });
+                return ok([
+                    `# 😥 申し訳ありません、リスト作成中に問題が発生しました`,
+                    ``,
+                    f.message,
+                    ``,
+                    `## 経過`,
+                    `- Papatto 検索ヒット数: ${outcome.papatto_found}`,
+                    `- 抽出済みデータ: ${outcome.papatto_extracted} 件 (途中まで)`,
+                    `- BizGate 利用: ${outcome.api_used.bizgate} 回`,
+                    ``,
+                    `💡 5 分後にもう一度同じご依頼をお試しください。`,
+                ].join("\n"));
+            }
+            const top5 = outcome.companies.slice(0, 5);
+            const stars = (s) => {
+                const n = Math.min(5, Math.max(1, Math.round(s / 20)));
+                return "⭐".repeat(n);
+            };
+            const lines = [
+                `# ✅ 営業リスト作成 完了!`,
+                ``,
+            ];
+            if (outcome.r2_url || outcome.csv_local_path) {
+                lines.push(`📄 結果 CSV (ローカル): ${outcome.csv_local_path}`);
+                if (outcome.r2_url)
+                    lines.push(`☁️ クラウド バックアップ: 保存済み`);
+                lines.push(``);
+            }
+            lines.push(`## 🥇 営業優先 おすすめ (上位 ${top5.length} 社)`, ``);
+            for (let i = 0; i < top5.length; i++) {
+                const c = top5[i];
+                lines.push(`### ${i + 1}. ${c.name}  ${stars(c.priority_score)}`);
+                if (c.priority_reason)
+                    lines.push(`   _${c.priority_reason}_`);
+                const meta = [];
+                if (c.industry || c.papatto_industry)
+                    meta.push(`業種: ${c.industry ?? c.papatto_industry}`);
+                if (c.revenue)
+                    meta.push(`売上: ${c.revenue}`);
+                if (c.papatto_address)
+                    meta.push(`所在: ${c.papatto_address}`);
+                if (c.ceo)
+                    meta.push(`代表: ${c.ceo}`);
+                if (meta.length > 0)
+                    lines.push(`   ${meta.join(" / ")}`);
+                if (c.departments && c.departments.length > 0) {
+                    const deptText = c.departments.slice(0, 3).map((d) => d.name).join(" / ");
+                    lines.push(`   📋 部署: ${deptText}${c.departments.length > 3 ? ` ほか${c.departments.length - 3}件` : ""}`);
+                }
+                if (c.keymen && c.keymen.length > 0) {
+                    lines.push(`   👤 キーマン: ${c.keymen.slice(0, 3).map((k) => k.role).join(" / ")}`);
+                }
+                if (c.papatto_phone || c.hp_url) {
+                    const contact = [];
+                    if (c.papatto_phone)
+                        contact.push(`📞 ${c.papatto_phone}`);
+                    if (c.hp_url)
+                        contact.push(`🌐 ${c.hp_url}`);
+                    lines.push(`   ${contact.join(" / ")}`);
+                }
+                lines.push(``);
+            }
+            lines.push(`## 📊 全体統計`, `- Papatto ヒット件数: ${outcome.papatto_found.toLocaleString()} 社`, `- 抽出: ${outcome.papatto_extracted} 社`, `- BizGate マッチ: ${outcome.bizgate_matched} 社`);
+            if (outcome.bizgate_enriched_deep > 0) {
+                lines.push(`- 部署 / キーマンまで調査: ${outcome.bizgate_enriched_deep} 社`);
+            }
+            lines.push(`- BizGate API 利用: ${outcome.api_used.bizgate} 回`, `- 所要時間: ${(outcome.duration_ms / 1000).toFixed(1)} 秒`);
+            if (outcome.search_quota) {
+                lines.push(`- Papatto 検索回数: ${outcome.search_quota.used} / ${outcome.search_quota.limit}`);
+            }
+            lines.push(``, `## 💡 次にできること`, `- "1 番の会社をもっと詳しく" — 特定の会社を深掘り`, `- "東京の会社だけに絞って" — 別条件で再検索`, `- "私の過去の営業リスト見せて" — 過去キャンペーン一覧`, ``, `📁 キャンペーン ID: \`${outcome.campaign_id}\` (後で参照する時に使えます)`);
+            return ok(lines.join("\n"));
+        }
+        catch (e) {
+            const f = friendlyError(e, { lang: "ja" });
+            return ok(`# 😥 エラーが発生しました\n\n${f.message}`);
+        }
+    });
+    server.tool("papatto__search_only", "⚠️ CSV ダウンロードクォータを使わず、検索結果ページから企業情報を直接抽出する。月間ダウンロード上限 (例 4,000 社/月) が枯渇した際の代替手段。検索回数 (月 500 回程度) のみ消費。" +
+        "規約グレーゾーン: 「画面に表示されている情報を自動化で読む」形態だが、明確にダウンロードの代替であるため Papatto 側ポリシー確認推奨。" +
+        "保守的な throttle (デフォルト 1500ms) でサイト負荷最小化。" +
+        "取得できる列: 会社名 / 業種 / 代表所在地 / 電話 / 資本規模 / 従業員規模 / 決算月 (ページ表示分のみ)。" +
+        "ダウンロード CSV と比較: 法人番号 / メール / インボイス / 部署データは含まれない (これらは papatto__extract または BizGate enrichment で補完)。", {
+        slack_user_id: z.string().describe("Slack ユーザー ID"),
+        campaign_id: z.string().describe("キャンペーン ID (R2 / Neon 保存キー)"),
+        conditions: z
+            .object({
+            industries: z.array(z.string()).optional(),
+            papatto_tags: z.array(z.string()).optional(),
+            intent_tags: z.array(z.string()).optional(),
+            flags: z
+                .array(z.enum(["tel", "email", "url", "updorg", "hasbusho", "isB2B", "isB2C", "financer"]))
+                .optional(),
+            keyword: z.string().optional(),
+            raw: z.record(z.union([z.string(), z.array(z.string())])).optional(),
+        })
+            .describe("papatto__extract と同形式の検索条件"),
+        max_companies: z.number().optional().describe("抽出する企業数の上限 (デフォルト 100、最大 2000 推奨)"),
+        throttle_ms: z.number().optional().describe("ページ間待機時間ミリ秒 (デフォルト 1500、最小 300)"),
+        headless: z.boolean().optional(),
+        search_url: z.string().optional(),
+        row_selector: z.string().optional().describe("ページの企業 row CSS セレクタを明示 (未指定時は自動推定)"),
+        debug: z.boolean().optional().describe("debug:true で row 候補セレクタ一覧を応答に含める (初回検証用)"),
+    }, async ({ slack_user_id, campaign_id, conditions, max_companies, throttle_ms, headless, search_url, row_selector, debug, }) => {
+        const dbActive = neon.isConfigured();
+        if (dbActive) {
+            try {
+                const cred = await getCredential(slack_user_id);
+                if (cred)
+                    await neon.upsertUser({ slack_user_id, papatto_email: cred.papatto_email });
+                await neon.insertCampaign({
+                    campaign_id,
+                    owner_slack_user_id: slack_user_id,
+                    papatto_conditions: conditions,
+                });
+            }
+            catch (e) {
+                log("warn", "neon insertCampaign (search_only) failed", { campaign_id, error: String(e) });
+            }
+        }
+        try {
+            const outcome = await runSearchOnly({
+                slack_user_id,
+                campaign_id,
+                conditions: conditions,
+                max_companies: max_companies ?? 100,
+                throttle_ms: throttle_ms ?? 1500,
+                headless: headless ?? true,
+                search_url,
+                row_selector,
+                debug,
+            });
+            const lines = [
+                `## Papatto Search-Only 抽出結果 (campaign_id=${campaign_id})`,
+                `- ページ URL: ${outcome.page_url}`,
+                `- ヒット件数 (件 / 社): ${outcome.num_found ?? "-"} / ${outcome.company_count ?? "-"}`,
+                `- 抽出企業数: ${outcome.companies.length}`,
+                `- 巡回ページ数: ${outcome.pages_visited}`,
+                `- 使用 row セレクタ: ${outcome.row_selector_used ?? "(未特定)"}`,
+            ];
+            if (outcome.search_quota) {
+                lines.push(`- 検索回数: ${outcome.search_quota.used} / ${outcome.search_quota.limit}`);
+            }
+            if (outcome.download_quota) {
+                const q = outcome.download_quota;
+                lines.push(`- 今月のダウンロード (参考): ${q.used} / ${q.limit} 社${q.exhausted ? " ⚠️ (このツールでは消費しません)" : ""}`);
+            }
+            if (outcome.error) {
+                lines.push(``, `## ⚠️ エラー`, `- ${outcome.error}`);
+                if (outcome.debug_row_candidates && outcome.debug_row_candidates.length > 0) {
+                    lines.push(`- row 候補 セレクタ (matched 数 / sample):`);
+                    for (const c of outcome.debug_row_candidates.slice(0, 10)) {
+                        lines.push(`    - \`${c.selector}\` → ${c.matched} 件 / sample="${c.sample_text}"`);
+                    }
+                }
+                else {
+                    lines.push(`- 11 種 row セレクタ全て matched 0`);
+                }
+                if (outcome.debug_element_dist) {
+                    const top = Object.entries(outcome.debug_element_dist).sort((a, b) => b[1] - a[1]).slice(0, 15);
+                    lines.push(``, `### element 分布 (top 15)`);
+                    for (const [tag, n] of top)
+                        lines.push(`  - ${tag}: ${n}`);
+                }
+                if (outcome.debug_body_snippet) {
+                    lines.push(``, `### body / main HTML snippet (先頭 4000 字)`);
+                    lines.push("```html");
+                    lines.push(outcome.debug_body_snippet);
+                    lines.push("```");
+                }
+            }
+            let r2Url;
+            if (outcome.csv_local_path) {
+                lines.push(``, `## 抽出 CSV`, `- ローカル: ${outcome.csv_local_path}`);
+                if (r2.isConfigured()) {
+                    try {
+                        const key = r2.csvKey(campaign_id, "page_extract.csv");
+                        const up = await r2.uploadFile(key, outcome.csv_local_path, "text/csv; charset=utf-8");
+                        r2Url = up.url;
+                        lines.push(`- R2: ${up.url}`);
+                    }
+                    catch (e) {
+                        lines.push(`- ⚠️ R2 アップロード失敗: ${e instanceof Error ? e.message : String(e)}`);
+                        log("warn", "r2 upload (search_only) failed", { campaign_id, error: String(e) });
+                    }
+                }
+                if (dbActive) {
+                    try {
+                        await neon.updateCampaign({
+                            campaign_id,
+                            status: "done",
+                            extracted_count: outcome.companies.length,
+                            r2_extracted_url: r2Url,
+                        });
+                    }
+                    catch (e) {
+                        log("warn", "neon updateCampaign (search_only done) failed", { campaign_id, error: String(e) });
+                    }
+                }
+            }
+            else if (dbActive) {
+                try {
+                    await neon.updateCampaign({ campaign_id, status: "failed" });
+                }
+                catch (e) {
+                    log("warn", "neon updateCampaign (search_only failed) failed", { campaign_id, error: String(e) });
+                }
+            }
+            if (outcome.companies.length > 0) {
+                lines.push(``, `## 先頭 5 社 サンプル`);
+                for (const c of outcome.companies.slice(0, 5)) {
+                    const fields = [c.name];
+                    if (c.industry)
+                        fields.push(`業: ${c.industry}`);
+                    if (c.address)
+                        fields.push(`住: ${c.address}`);
+                    if (c.phone)
+                        fields.push(`電: ${c.phone}`);
+                    if (c.capital_size)
+                        fields.push(`資: ${c.capital_size}`);
+                    if (c.emp_size)
+                        fields.push(`従: ${c.emp_size}`);
+                    if (c.fiscal_month)
+                        fields.push(`決: ${c.fiscal_month}`);
+                    lines.push(`- ${fields.join(" / ")}`);
+                }
+            }
+            lines.push(``, `> ⚠️ 規約グレー: Papatto 公式 CSV ダウンロード とは別ルート。Papatto 側ポリシー確認推奨。`, `> 補完情報 (法人番号 / メール / インボイス / 部署 など) は papatto__extract (CSV ダウンロード) または BizGate enrichment で取得可能。`);
+            return ok(lines.join("\n"));
+        }
+        catch (e) {
+            return fail(e instanceof Error ? e.message : String(e));
+        }
+    });
     server.tool("papatto__queue_status", "Playwright 실행 큐의 현재 상태를 반환한다. concurrency / active (실행 중) / pending (대기 중) / paused. 환경변수 PAPATTO_PLAYWRIGHT_CONCURRENCY 로 동시 실행 수 조정 (default 2).", {}, async () => {
         const s = getQueueStatus();
         return ok([
@@ -447,8 +731,8 @@ export function registerPapattoTools(server) {
                     `- オーナー: ${c.owner_slack_user_id}`,
                     `- ステータス: ${c.status}`,
                     `- 抽出件数: ${c.extracted_count ?? "-"}`,
-                    `- 作成: ${new Date(c.created_at).toISOString()}`,
-                    `- 更新: ${new Date(c.updated_at).toISOString()}`,
+                    `- 作成: ${new Date(Number(c.created_at)).toISOString()}`,
+                    `- 更新: ${new Date(Number(c.updated_at)).toISOString()}`,
                     `- R2: ${c.r2_extracted_url ?? "-"}`,
                     `- Sheet: ${c.sheet_url ?? "-"}`,
                 ];
@@ -468,7 +752,7 @@ export function registerPapattoTools(server) {
                 return ok(`${owner_slack_user_id} の campaign は見つかりませんでした。`);
             const header = `| campaign_id | status | 抽出件数 | 作成日時 | R2 |\n|-------------|--------|----------|----------|----|`;
             const lines = rows.map((c) => {
-                const dt = new Date(c.created_at).toISOString().replace("T", " ").slice(0, 16);
+                const dt = new Date(Number(c.created_at)).toISOString().replace("T", " ").slice(0, 16);
                 const r2_short = c.r2_extracted_url ? "✓" : "-";
                 return `| ${c.campaign_id} | ${c.status} | ${c.extracted_count ?? "-"} | ${dt} | ${r2_short} |`;
             });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bizgate-mcp-server",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "BizGate API + Papatto Cloud × Claude 連携 MCP サーバー (CSV → R2 → Neon → Google Sheets 一括ワークフロー)",
   "type": "module",
   "main": "dist/index.js",