@zonuexe/techbook-mcp 0.1.0

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAMnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAuB9E,wBAAgB,YAAY,CAC1B,UAAU,EAAE,SAAS,gBAAgB,EAAE,EACvC,IAAI,EAAE,aAAa,GAClB,MAAM,CA4DR;AAED,wBAAsB,WAAW,CAC/B,UAAU,EAAE,SAAS,gBAAgB,EAAE,EACvC,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,IAAI,CAAC,CAIf"}

package/dist/mcp/server.js

@@ -0,0 +1,79 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { searchBooks } from "../application/search-books.js";
+import { getBookDetail } from "../application/get-book-detail.js";
+import { TOOLS } from "./tools.js";
+// --- 出力フォーマット ---
+const DRM_LABELS = {
+    free: "DRMフリー",
+    social: "DRMフリー (ソーシャル)",
+    drm: "DRM付き",
+};
+function formatEbookStore(store) {
+    return { ...store, drmLabel: DRM_LABELS[store.drm] };
+}
+function formatBook(book) {
+    if (!book.ebookStores)
+        return book;
+    return { ...book, ebookStores: book.ebookStores.map(formatEbookStore) };
+}
+export function createServer(publishers, deps) {
+    const server = new Server({
+        name: "@zonuexe/techbook-mcp",
+        version: "0.1.0",
+    }, {
+        capabilities: { tools: {} },
+    });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: TOOLS,
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args = {} } = request.params;
+        switch (name) {
+            case "search_books": {
+                const query = {
+                    title: typeof args["title"] === "string" ? args["title"] : undefined,
+                    author: typeof args["author"] === "string" ? args["author"] : undefined,
+                    publisherId: typeof args["publisher"] === "string" ? args["publisher"] : undefined,
+                    limit: typeof args["limit"] === "number" ? Math.min(args["limit"], 50) : 10,
+                };
+                const { books, errors } = await searchBooks(query, publishers, deps);
+                const output = { books: books.map(formatBook) };
+                if (errors.length > 0)
+                    output["errors"] = errors;
+                return {
+                    content: [{ type: "text", text: JSON.stringify(output, null, 2) }],
+                };
+            }
+            case "get_book_detail": {
+                const url = args["url"];
+                if (typeof url !== "string")
+                    throw new Error("url は必須です");
+                const book = await getBookDetail(url, publishers, deps);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(formatBook(book), null, 2) }],
+                };
+            }
+            case "list_publishers": {
+                const list = publishers.map(p => ({
+                    id: p.id,
+                    name: p.name,
+                    baseUrl: p.baseUrl,
+                }));
+                return {
+                    content: [{ type: "text", text: JSON.stringify(list, null, 2) }],
+                };
+            }
+            default:
+                throw new Error(`未知のツール: ${name}`);
+        }
+    });
+    return server;
+}
+export async function startServer(publishers, deps) {
+    const server = createServer(publishers, deps);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"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"}

package/dist/mcp/tools.d.ts

@@ -0,0 +1,47 @@
+export declare const TOOLS: readonly [{
+    readonly name: "search_books";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly title: {
+                readonly type: "string";
+                readonly description: "書名（部分一致）";
+            };
+            readonly author: {
+                readonly type: "string";
+                readonly description: "著者名（部分一致）";
+            };
+            readonly publisher: {
+                readonly type: "string";
+                readonly description: string;
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly description: "1出版社あたりの最大取得件数（デフォルト: 10、最大: 50）";
+                readonly default: 10;
+            };
+        };
+    };
+}, {
+    readonly name: "get_book_detail";
+    readonly description: "書籍の公式ページURLから詳細な書誌情報を取得します。";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly required: readonly ["url"];
+        readonly properties: {
+            readonly url: {
+                readonly type: "string";
+                readonly description: "書籍の公式ページURL（出版社サイトのURL）";
+            };
+        };
+    };
+}, {
+    readonly name: "list_publishers";
+    readonly description: "対応している出版社の一覧とIDを返します。";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}];
+//# sourceMappingURL=tools.d.ts.map

package/dist/mcp/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqDR,CAAC"}

package/dist/mcp/tools.js

@@ -0,0 +1,53 @@
+export const TOOLS = [
+    {
+        name: "search_books",
+        description: "書名・著者名から日本語技術書を検索し、書誌情報の一覧を返します。" +
+            "複数の出版社を横断して検索します。",
+        inputSchema: {
+            type: "object",
+            properties: {
+                title: {
+                    type: "string",
+                    description: "書名（部分一致）",
+                },
+                author: {
+                    type: "string",
+                    description: "著者名（部分一致）",
+                },
+                publisher: {
+                    type: "string",
+                    description: "出版社IDで検索対象を絞り込みます。指定しない場合は全出版社を検索します。" +
+                        "利用可能なIDは list_publishers で確認できます。",
+                },
+                limit: {
+                    type: "number",
+                    description: "1出版社あたりの最大取得件数（デフォルト: 10、最大: 50）",
+                    default: 10,
+                },
+            },
+        },
+    },
+    {
+        name: "get_book_detail",
+        description: "書籍の公式ページURLから詳細な書誌情報を取得します。",
+        inputSchema: {
+            type: "object",
+            required: ["url"],
+            properties: {
+                url: {
+                    type: "string",
+                    description: "書籍の公式ページURL（出版社サイトのURL）",
+                },
+            },
+        },
+    },
+    {
+        name: "list_publishers",
+        description: "対応している出版社の一覧とIDを返します。",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+];
+//# sourceMappingURL=tools.js.map

package/dist/mcp/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,kCAAkC;YAClC,mBAAmB;QACrB,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,UAAU;iBACxB;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,WAAW;iBACzB;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,uCAAuC;wBACvC,mCAAmC;iBACtC;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,kCAAkC;oBAC/C,OAAO,EAAE,EAAE;iBACZ;aACF;SACF;KACF;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,6BAA6B;QAC1C,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC,KAAK,CAAC;YACjB,UAAU,EAAE;gBACV,GAAG,EAAE;oBACH,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,yBAAyB;iBACvC;aACF;SACF;KACF;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,uBAAuB;QACpC,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf;KACF;CACO,CAAC"}

package/dist/ports/cache.d.ts

@@ -0,0 +1,6 @@
+export interface CacheStore {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, ttlSeconds?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/ports/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/ports/cache.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC"}

package/dist/ports/cache.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cache.js.map

package/dist/ports/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/ports/cache.ts"],"names":[],"mappings":""}

package/dist/ports/html-parser.d.ts

@@ -0,0 +1,14 @@
+export interface HtmlElement {
+    text(): string;
+    html(): string | null;
+    attr(name: string): string | undefined;
+    find(selector: string): HtmlElement[];
+}
+export interface HtmlDocument {
+    select(selector: string): HtmlElement[];
+    selectOne(selector: string): HtmlElement | null;
+}
+export interface HtmlParser {
+    parse(html: string): HtmlDocument;
+}
+//# sourceMappingURL=html-parser.d.ts.map

package/dist/ports/html-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-parser.d.ts","sourceRoot":"","sources":["../../src/ports/html-parser.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,IAAI,IAAI,MAAM,CAAC;IACf,IAAI,IAAI,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACvC,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;IACxC,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAAC;CACnC"}

package/dist/ports/html-parser.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=html-parser.js.map

package/dist/ports/html-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-parser.js","sourceRoot":"","sources":["../../src/ports/html-parser.ts"],"names":[],"mappings":""}

package/dist/ports/http.d.ts

@@ -0,0 +1,16 @@
+export interface RequestOptions {
+    headers?: Record<string, string>;
+    timeout?: number;
+}
+export interface HttpResponse {
+    readonly status: number;
+    readonly url: string;
+    text(): Promise<string>;
+    /** ヘッダー値を取得する。複数値は `, ` 結合。存在しない場合は null。 */
+    header(name: string): string | null;
+}
+export interface HttpClient {
+    get(url: string, options?: RequestOptions): Promise<HttpResponse>;
+    post(url: string, body: string, options?: RequestOptions): Promise<HttpResponse>;
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/ports/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/ports/http.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACxB,6CAA6C;IAC7C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAClE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAClF"}

package/dist/ports/http.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=http.js.map

package/dist/ports/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/ports/http.ts"],"names":[],"mappings":""}

package/docs/design-doc.md

@@ -0,0 +1,365 @@
+# techbook-mcp 設計書
+
+パッケージ名: `@zonuexe/techbook-mcp`
+ライセンス: AGPL-3.0-only
+
+## 概要
+
+日本語技術書の書誌情報を出版社公式サイト・APIから取得するMCPサーバー。
+書名・著者名での検索と、URLからの詳細情報取得を提供する。
+
+## アーキテクチャ
+
+ポート＆アダプター（Hexagonal Architecture）を採用し、HTTP・HTML解析・キャッシュの各I/Oを抽象化する。
+これによりビジネスロジックをランタイムやネットワーク環境から分離し、ユニットテストを容易にする。
+
+```
+┌─────────────────────────────────────────────────────┐
+│                   MCP Layer (stdio)                 │
+│  search_books / get_book_detail / list_publishers   │
+└──────────────────────┬──────────────────────────────┘
+                       │
+┌──────────────────────▼──────────────────────────────┐
+│              Application Layer                      │
+│  searchBooks()          getBookDetail()             │
+└──────────┬───────────────────────┬──────────────────┘
+           │                       │
+┌──────────▼──────────┐  ┌─────────▼──────────────────┐
+│    Domain Layer     │  │     Publisher Registry      │
+│  BookRecord         │  │  PublisherAdapter[]         │
+│  SearchQuery        │  │                             │
+└─────────────────────┘  └────────────┬───────────────┘
+                                      │ uses ports
+┌─────────────────────────────────────▼───────────────┐
+│                  Ports (interfaces)                 │
+│   HttpClient       HtmlParser      CacheStore       │
+└──────┬─────────────────┬────────────────┬───────────┘
+       │                 │                │
+┌──────▼──────┐  ┌───────▼──────┐  ┌─────▼───────────┐
+│  Adapters   │  │   Adapters   │  │    Adapters     │
+│ FetchHttp   │  │CheerioParser │  │  MemoryCache    │
+│ MockHttp    │  │              │  │  NullCache      │
+└─────────────┘  └──────────────┘  └─────────────────┘
+```
+
+## ディレクトリ構成
+
+```
+techbook-mcp/
+├── flake.nix              # Nix flake (devShell + package build)
+├── package.json
+├── tsconfig.json
+├── vitest.config.ts
+├── docs/
+│   └── design-doc.md      # 本ドキュメント
+├── src/
+│   ├── domain/
+│   │   ├── book.ts          # BookRecord, SearchQuery, DrmType 型定義
+│   │   └── publisher.ts     # PublisherAdapter インターフェース
+│   ├── ports/
+│   │   ├── http.ts          # HttpClient インターフェース
+│   │   ├── html-parser.ts   # HtmlParser インターフェース
+│   │   └── cache.ts         # CacheStore インターフェース
+│   ├── adapters/
+│   │   ├── http/
+│   │   │   ├── fetch-client.ts  # fetch() ベース実装
+│   │   │   └── mock-client.ts   # テスト用モック
+│   │   ├── html/
+│   │   │   └── cheerio-parser.ts
+│   │   ├── cache/
+│   │   │   ├── memory-cache.ts
+│   │   │   └── null-cache.ts
+│   │   └── publishers/
+│   │       ├── base.ts          # 共通ユーティリティ (fetchText, parsePrice, EBOOK_STORE_PATTERNS)
+│   │       ├── book-tech.ts     # BOOK TECH
+│   │       ├── born-digital.ts  # ボーンデジタル
+│   │       ├── coronasha.ts     # コロナ社
+│   │       ├── gihyo.ts         # 技術評論社
+│   │       ├── lambdanote.ts    # ラムダノート
+│   │       ├── manatee.ts       # マナティ (マイナビ出版直販)
+│   │       ├── maruzen-publishing.ts  # 丸善出版
+│   │       ├── optronics.ts     # オプトロニクス社
+│   │       ├── oreilly-japan.ts # オライリー・ジャパン
+│   │       ├── peaks.ts         # PEAKS
+│   │       ├── personal-media.ts  # パーソナルメディア
+│   │       ├── rutles.ts        # ラトルズ
+│   │       ├── saiensu.ts       # サイエンス社
+│   │       ├── seshop.ts        # SEshop (翔泳社)
+│   │       ├── tatsu-zine.ts    # 達人出版会
+│   │       ├── techbookfest.ts  # 技術書典
+│   │       └── registry.ts      # 出版社リスト (DEFAULT_PUBLISHERS)
+│   ├── application/
+│   │   ├── search-books.ts
+│   │   └── get-book-detail.ts
+│   ├── mcp/
+│   │   ├── server.ts
+│   │   └── tools.ts
+│   └── main.ts
+└── tests/
+    ├── unit/
+    │   └── adapters/publishers/
+    │       └── *.test.ts        # 各アダプターのユニットテスト
+    └── fixtures/
+        └── *                    # HTTPレスポンスのスナップショット
+```
+
+## 対応出版社
+
+| ID | 名称 | 取得方式 | 備考 |
+|----|------|---------|------|
+| `book-tech` | BOOK TECH | HTML scraping | カラーミーショップ |
+| `born-digital` | ボーンデジタル | HTML scraping | カラーミーショップ・EUC-JP エンコード必須 |
+| `coronasha` | コロナ社 | HTML scraping | 電子版フラグで絞り込み・外部ストアへ委託販売 |
+| `gihyo` | 技術評論社 | JSON API | `/api_gh/site/search` |
+| `lambdanote` | ラムダノート | HTML scraping | Shopify ストア |
+| `manatee` | マナティ (マイナビ出版直販) | HTML scraping | 複数出版社を委託販売 |
+| `maruzen-publishing` | 丸善出版 | HTML scraping | Referer ヘッダー必須 |
+| `optronics` | オプトロニクス社 | HTML scraping | EC-CUBE ベース |
+| `oreilly-japan` | オライリー・ジャパン | HTML scraping | 検索APIなし・ローカルフィルタ |
+| `peaks` | PEAKS | HTML scraping | 検索APIなし・ローカルフィルタ |
+| `personal-media` | パーソナルメディア | HTML scraping | 検索APIなし・ローカルフィルタ |
+| `rutles` | ラトルズ | HTML scraping | クエリを EUC-JP エンコード必須 |
+| `saiensu` | サイエンス社 | HTML scraping | 電子書籍のみ (`mediaName === "電子"`) |
+| `seshop` | SEshop (翔泳社) | HTML scraping | `category_id=327` で電子書籍に絞り込み |
+| `tatsu-zine` | 達人出版会 | HTML scraping | 複数出版社を委託販売 |
+| `techbookfest` | 技術書典オンラインマーケット | GraphQL POST API | XSRF-TOKEN 必須 |
+
+### 各アダプターの実装メモ
+
+**BOOK TECH (book-tech)** — カラーミーショップ
+```
+GET https://book-tech.com/books?q%5Btitle_or_overview_or_identification_number_1_or_product_code_cont%5D={keyword}
+```
+- `div.contents-index-item` が書籍アイテム
+- 著者: `a[href*='author_relations']` テキストから役割語（`（著）` 等）を除去
+- ISBN: `.contents-book-about-id` の13桁数字列
+- 価格: `.price` テキストから税込価格を取得
+- DRM: `"social"`
+
+**ボーンデジタル (born-digital)** — カラーミーショップ
+```
+GET https://wgn-obs.shop-pro.jp/?mode=srh&keyword={EUC-JP encoded keyword}
+```
+- クエリを **EUC-JP** でパーセントエンコード（`iconv-lite` 使用）
+- 電子書籍の絞り込み: タイトルが `【` で始まるもの（`【PDFダウンロード版】`・`【電子書籍版】`）
+- アイテム: `li.c-product-list__item`
+- 価格: `var Colorme = {...}` JSON の `product.sales_price_including_tax`
+- 著者・発行日: 詳細ページの説明テキストをタブまたは全角コロン `：` で分割して解析
+- DRM: `"social"`（PDFにメールアドレスが印字）
+
+**コロナ社 (coronasha)**
+```
+GET https://www.coronasha.co.jp/np/result.html?q={keyword}
+```
+- 電子版フラグ: `ul.status-list li` に `"電子版あり"` があるものだけ対象
+- タイトル: `.tunogaki` と `.book-title` を結合（例: `"1から始める"` + `"Juliaプログラミング大全"`）
+- 書誌情報: `.book-info dl` の dt/dd から定価・ISBN・発行年月日を取得
+- 価格は詳細ページのサイドバー `.price` から取得（`.book-info dl` には含まれない）
+- 電子書籍ストアは `extractEbookStoresFromDoc()` で自動検出（Kindle, Kinoppy, VarsityWave eBooks 等）
+- Knowledge Worker (`kw.maruzen.co.jp`) はパターン未登録のため自動除外
+
+**技術評論社 (gihyo)** — JSON API
+```
+GET https://gihyo.jp/api_gh/site/search?search={keyword}&limit={n}
+```
+レスポンス: `list[isbn]` オブジェクト。`author` は `{ 役割: { 名前: "<ruby>markup</ruby>" } }` 形式なのでHTML除去が必要。
+
+**ラムダノート (lambdanote)** — Shopify
+```
+GET https://www.lambdanote.com/search?q={keyword}&type=product
+```
+詳細ページの `<script type="application/json">` 埋め込みJSONからISBN・著者情報を取得。
+
+**マナティ (manatee)** — マイナビ出版直販
+```
+GET https://book.mynavi.jp/manatee/list/?topics_keyword={keyword}
+```
+ソーシャルDRM（公式 about ページに明記）。
+
+**丸善出版 (maruzen-publishing)**
+```
+GET https://www.maruzen-publishing.co.jp/search/?search_keyword={keyword}&format=1
+```
+- **Referer ヘッダー必須**（なければ 403）
+- 価格・ISBNはJS動的ロードのため取得不可
+- `kw.maruzen.co.jp`（Knowledge Worker / Maruzen eBook Library）は機関向けなので除外
+
+**オプトロニクス社 (optronics)** — EC-CUBE ベース
+```
+GET https://optronics-ebook.com/products/list.php?name={keyword}&category_id=1
+```
+`listcomment` / `main_comment` の自由テキストから `著者:` / `発行:` 行を正規表現で解析。
+
+**オライリー・ジャパン (oreilly-japan)** — ローカルフィルタ
+```
+GET https://www.oreilly.co.jp/ebook/
+```
+検索APIなし。全一覧ページをタイトルキーワードでローカルフィルタリング。著者のみ検索は非対応。
+
+**PEAKS (peaks)** — ローカルフィルタ
+```
+GET https://peaks.cc/
+```
+検索APIなし。トップページに全書籍（27冊程度）が掲載されており、ローカルフィルタリング。
+
+**ラトルズ (rutles)** — EUC-JP ショッピングカート
+```
+GET https://shop.rutles.net/?mode=srh&keyword={EUC-JP encoded keyword}
+```
+- クエリを **EUC-JP** でパーセントエンコード（UTF-8では検索ヒットなし）
+- `iconv-lite` を使用してエンコード
+- 電子書籍は `【電子版】` がタイトルに含まれる
+- 詳細ページの `var Colorme = {...}` JSON から ISBN・価格を取得
+
+**サイエンス社 (saiensu)**
+```
+GET https://www.saiensu.co.jp/search/?keyword={keyword}
+```
+電子書籍のみ: `article.bookListItem` の `.bookListItemData_mediaName` が `"電子"` のもの。
+DRM: `"password_pdf"`（パスワード付きPDF）
+
+**SEshop / 翔泳社 (seshop)**
+```
+GET https://www.seshop.com/search?keyword={keyword}&category_id=327&sort=newer
+```
+- `category_id=327` が電子書籍（PDF版）カテゴリ
+- さらに `div.product-data[data-category]` が `"電子書籍"` 始まりのものだけ返す
+- 詳細ページの `cxenseparse:sho-*` メタタグから ISBN・価格・発売日を取得
+- PDFにメールアドレスと著作権情報が埋め込まれる → `"social"` DRM
+
+**パーソナルメディア (personal-media)** — ローカルフィルタ
+```
+GET https://www.personal-media.co.jp/webshop/book/
+```
+- 検索APIなし。PDF直販書籍の全一覧テーブルをタイトルキーワードでローカルフィルタリング
+- 著者のみ検索は非対応（`!query.title` のとき `[]` を返す）
+- 詳細ページにセマンティックHTMLなし。`body` 全テキストを行分割して正規表現でメタデータを抽出
+  - 著者行: `^(.+?)\s+(?:著|監修|編|訳|...)$` パターンで役割語を検出・除去
+  - ISBN: `"ISBN"` を含む行から `\d[\d-]{12,}` で抽出
+  - 発行日: `"発売"` を含む行から `(\d{4})年(\d{1,2})月` を抽出 → `"YYYY-MM-01"` 形式
+- 電子書籍ストアは相対URLのため `extractEbookStoresFromDoc()` は不使用。パス文字列で手動検出
+  - `/webshop/book/` を含むリンク → パーソナルメディア (PDF版, `"social"`)
+  - `/smoothreader/store/` を含むリンク → Smooth Reader (専用ビューアー, `"drm"`)
+
+**達人出版会 (tatsu-zine)**
+```
+GET https://tatsu-zine.com/books/?search={keyword}
+```
+複数出版社の電子書籍を委託販売。全書籍ソーシャルDRM。
+
+**技術書典 (techbookfest)** — GraphQL
+```
+POST https://techbookfest.org/api/graphql
+```
+- **XSRF-TOKEN 必須**: GETホームページ → Set-Cookie から取得 → Cookie と `X-XSRF-TOKEN` ヘッダー両方に付与
+- インラインフラグメント必須: `node { ... on ProductInfoSearchResult { product { ... } } }`
+
+## DrmType
+
+```typescript
+type DrmType = "free" | "social" | "password_pdf" | "drm";
+```
+
+| 値 | 意味 |
+|----|------|
+| `"free"` | 技術的DRMなし (DRM-free PDF/EPUB) |
+| `"social"` | ソーシャルDRM (購入者情報の透かし入りPDF、技術的制限なし) |
+| `"password_pdf"` | パスワード付きPDF (標準PDFビューアで閲覧可、制限あり) |
+| `"drm"` | 技術的DRM付き (専用ビューアー必須) |
+
+## 電子書籍ストア分類 (EBOOK_STORE_PATTERNS)
+
+`src/adapters/publishers/base.ts` の `EBOOK_STORE_PATTERNS` で URL パターンから DRM 種別を自動判定する。
+
+| ストア | drm | 根拠 |
+|--------|-----|------|
+| 技術書典 | `free` | 公式方針 |
+| オライリー・ジャパン | `free` | 公式方針 |
+| ラトルズ | `free` | 購入・確認済み |
+| PEAKS | `free` | 利用規約に明記 |
+| オプトロニクス社 | `free` | 購入・確認済み |
+| Gihyo Digital Publishing | `social` | 公式方針 |
+| SEshop (翔泳社) | `social` | メールアドレス埋め込み透かし |
+| BOOK TECH | `social` | 購入者情報透かし |
+| ボーンデジタル | `social` | PDFにメールアドレス印字 |
+| マナティ | `social` | 公式 about ページに明記 |
+| ラムダノート | `social` | 公式方針 |
+| 達人出版会 | `social` | 公式方針 |
+| インプレスブックス | `social` | 公式方針 |
+| サイエンス社 | `password_pdf` | パスワード付きPDF |
+| Kindle | `drm` | — |
+| Kinoppy | `drm` | `kinokuniya.co.jp/kinoppystore` および `kinokuniya.co.jp/f/dsg-08` 形式 |
+| VarsityWave eBooks | `drm` | 大学生協電子書籍 (coop-ebook.jp) |
+| 楽天Kobo | `drm` | — |
+| BookLive | `drm` | — |
+| honto | `drm` | — |
+| BOOK☆WALKER | `drm` | — |
+| eBookJapan | `drm` | — |
+| LINEマンガ | `drm` | — |
+
+## MCPツール
+
+| ツール名 | 説明 | 主な引数 |
+|---------|------|---------|
+| `search_books` | 書名・著者名で検索 | `title?`, `author?`, `publisher?`, `limit?` |
+| `get_book_detail` | URLから詳細情報取得 | `url` |
+| `list_publishers` | 対応出版社一覧 | なし |
+
+## 新しいアダプターの追加手順
+
+1. `src/adapters/publishers/{id}.ts` を作成し `PublisherAdapter` を実装
+   - `search()`: 検索APIまたはHTMLスクレイピングで `BookRecord[]` を返す
+   - `getDetail()`: 詳細ページをスクレイピングして `BookRecord` を返す
+2. `tests/fixtures/{id}-search.html` (または `.json`) を作成
+3. `tests/fixtures/{id}-detail.html` を作成
+4. `tests/unit/adapters/publishers/{id}.test.ts` を作成
+5. 必要なら `base.ts` の `EBOOK_STORE_PATTERNS` にストアパターンを追加
+6. `src/adapters/publishers/registry.ts` に登録
+
+よく使う共通ユーティリティ (`base.ts`):
+- `fetchText(url, deps, extraHeaders?)` — キャッシュ付きHTTP GET
+- `parseJapanesePrice(text)` — "3,740円（税込）" → 3740
+- `resolveUrl(base, path)` — 相対URLを絶対URLに解決
+- `extractEbookStoresFromDoc(doc)` — ページ内リンクから電子書籍ストアを自動検出
+
+## ランタイム対応
+
+| ランタイム | 起動方法 |
+|----------|---------|
+| Node.js 22+ | `node dist/main.js` |
+| Bun | `bun src/main.ts` |
+| Deno | `deno run --allow-net src/main.ts` |
+
+グローバル `fetch` APIを使用しており、Node.js 18以降・Bun・Denoで動作する。
+
+## 開発環境 (Nix)
+
+```bash
+nix develop        # devShell に入る (Node.js 22, Bun, Deno が利用可能)
+npm install        # 初回のみ: node_modules と package-lock.json を生成
+npm test           # テスト実行
+npm run build      # TypeScript コンパイル (→ dist/)
+```
+
+## テスト戦略
+
+- `MockHttpClient` にフィクスチャデータを登録してネットワーク不要のユニットテストを実現
+- `NullCacheStore` でキャッシュをバイパス
+- `CheerioHtmlParser` を実際のパーサーとして使用（モック不要）
+- `tests/fixtures/` に各サイトのレスポンススナップショットを配置
+
+### MockHttpClient の使い方
+
+```typescript
+const http = new MockHttpClient()
+  .addResponse("https://example.com/search", { status: 200, body: searchHtml })
+  .addResponse("https://example.com/book/1", { status: 200, body: detailHtml });
+// URLプレフィックスで前方一致マッチ
+```
+
+### POST エンドポイントのテスト
+
+```typescript
+const http = new MockHttpClient()
+  .addPostResponse("https://api.example.com/graphql", { status: 200, body: jsonStr });
+```