@zonuexe/techbook-mcp 0.2.3 → 0.3.1

package/docs/design-doc.md

@@ -5,8 +5,14 @@
 
 ## 概要
 
-日本語技術書の書誌情報を出版社公式サイト・APIから取得するMCPサーバー。
+日本語技術書（および一部の海外技術書）の書誌情報を出版社公式サイト・APIから取得するMCPサーバー。
 書名・著者名での検索と、URLからの詳細情報取得を提供する。
+価格は原則 税込円（整数）だが、海外出版社は当該通貨の数値と `BookRecord.currency`（ISO 4217）で表す。
+言語は `BookRecord.language`（ISO 639-1、省略時 `"ja"`）で表す。
+
+書籍管理アプリ [Riida](https://github.com/zonuexe/riida) の `riida-mcp` とシームレスに連携することを目標とし、
+利用エージェント側の試行錯誤を減らしてスムーズに書誌を取得できることを重視する。
+`publishedAt`（YYYY-MM-DD）は riida の `release_date` に対応する。
 
 ## アーキテクチャ
 
@@ -49,20 +55,21 @@ 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 インターフェース
+│   │   ├── publisher.ts     # PublisherAdapter インターフェース (language, scale)
+│   │   ├── text-match.ts    # 照合用テキスト正規化・matchScore 算出
+│   │   └── isbn.ts          # ISBN 正規化・looksLikeIsbn 判定
 │   ├── ports/
 │   │   ├── http.ts          # HttpClient インターフェース
 │   │   ├── html-parser.ts   # HtmlParser インターフェース
 │   │   └── cache.ts         # CacheStore インターフェース
 │   ├── adapters/
 │   │   ├── http/
-│   │   │   ├── fetch-client.ts  # fetch() ベース実装
+│   │   │   ├── fetch-client.ts  # fetch() ベース実装 (charset を見て EUC-JP/Shift_JIS をデコード)
 │   │   │   └── mock-client.ts   # テスト用モック
 │   │   ├── html/
 │   │   │   └── cheerio-parser.ts
@@ -74,14 +81,17 @@ techbook-mcp/
 │   │       ├── book-tech.ts     # BOOK TECH
 │   │       ├── born-digital.ts  # ボーンデジタル
 │   │       ├── coronasha.ts     # コロナ社
+│   │       ├── cq-publishing.ts # CQ出版社 (Tech Village 書庫＆販売)
 │   │       ├── gihyo.ts         # 技術評論社
 │   │       ├── lambdanote.ts    # ラムダノート
+│   │       ├── leanpub.ts       # Leanpub (海外・セルフ出版・DRM-free)
 │   │       ├── manatee.ts       # マナティ (マイナビ出版直販)
 │   │       ├── maruzen-publishing.ts  # 丸善出版
 │   │       ├── optronics.ts     # オプトロニクス社
 │   │       ├── oreilly-japan.ts # オライリー・ジャパン
 │   │       ├── peaks.ts         # PEAKS
 │   │       ├── personal-media.ts  # パーソナルメディア
+│   │       ├── pragprog.ts      # Pragmatic Bookshelf (海外・DRM-free)
 │   │       ├── rutles.ts        # ラトルズ
 │   │       ├── saiensu.ts       # サイエンス社
 │   │       ├── seshop.ts        # SEshop (翔泳社)
@@ -89,8 +99,10 @@ techbook-mcp/
 │   │       ├── techbookfest.ts  # 技術書典
 │   │       └── registry.ts      # 出版社リスト (DEFAULT_PUBLISHERS)
 │   ├── application/
-│   │   ├── search-books.ts
-│   │   └── get-book-detail.ts
+│   │   ├── search-books.ts   # 横断検索・スケジューリング・matchScore 付与
+│   │   ├── get-book-detail.ts
+│   │   ├── get-book-by-isbn.ts
+│   │   └── concurrency.ts    # mapWithConcurrency / withTimeout
 │   ├── mcp/
 │   │   ├── server.ts
 │   │   └── tools.ts
@@ -105,11 +117,14 @@ techbook-mcp/
 
 ## 対応出版社
 
+### 国内出版社
+
 | ID | 名称 | 取得方式 | 備考 |
 |----|------|---------|------|
 | `book-tech` | BOOK TECH | HTML scraping | カラーミーショップ |
 | `born-digital` | ボーンデジタル | HTML scraping | カラーミーショップ・EUC-JP エンコード必須 |
 | `coronasha` | コロナ社 | HTML scraping | 電子版フラグで絞り込み・外部ストアへ委託販売 |
+| `cq-publishing` | CQ出版社 | HTML scraping | 電子書籍直販サイト「Tech Village」・検索キーワードはパスに埋め込む |
 | `gihyo` | 技術評論社 | JSON API | `/api_gh/site/search` |
 | `lambdanote` | ラムダノート | HTML scraping | Shopify ストア |
 | `manatee` | マナティ (マイナビ出版直販) | HTML scraping | 複数出版社を委託販売 |
@@ -124,6 +139,15 @@ techbook-mcp/
 | `tatsu-zine` | 達人出版会 | HTML scraping | 複数出版社を委託販売 |
 | `techbookfest` | 技術書典オンラインマーケット | GraphQL POST API | XSRF-TOKEN 必須 |
 
+### 海外出版社
+
+価格は USD（`BookRecord.currency: "USD"`）、`language: "en"`。
+
+| ID | 名称 | 取得方式 | 備考 |
+|----|------|---------|------|
+| `pragprog` | Pragmatic Bookshelf | JSON index | 米国・`/search/index.json` をローカルフィルタ・DRM-free |
+| `leanpub` | Leanpub | HTML scraping | 米国・セルフ出版・DRM-free・価格/日付は埋め込みJSONストリームから取得 |
+
 ### 各アダプターの実装メモ
 
 **BOOK TECH (book-tech)** — カラーミーショップ
@@ -158,6 +182,17 @@ GET https://www.coronasha.co.jp/np/result.html?q={keyword}
 - 電子書籍ストアは `extractEbookStoresFromDoc()` で自動検出（Kindle, Kinoppy, VarsityWave eBooks 等）
 - Knowledge Worker (`kw.maruzen.co.jp`) はパターン未登録のため自動除外
 
+**CQ出版社 (cq-publishing)** — Tech Village 書庫＆販売
+```
+GET https://cc.cqpub.co.jp/lib/system/doclib_search/q={UTF-8 percent-encoded keyword}/
+```
+- CQ出版の電子書籍直販サイト（`cc.cqpub.co.jp/lib/`）。物販サイト `shop.cqpub.co.jp` とは別ドメインで、後者は紙の書籍・雑誌のみ・ネイティブ検索なし
+- 検索キーワードは CakePHP の名前付きパラメータとして**パスに埋め込む**（`?q=` ではない）。複数語はスペース区切り（OR検索）
+- 検索結果: `ul.itemList.books04 li` の `.mainTitle a`（タイトル・リンク）・`.subTitle`・`.price span`・`dt img`
+- 詳細ページ: `/lib/system/doclib_item/{id}/`。`table[summary='商品詳細']` の th/td から著者・発行元・価格（ライセンス料金）・発行日を取得。**ISBN は持たず**コンテンツコード（例 `DP45551`）のみ
+- タイトル末尾の形式マーカー `【PDF版】`（重複表記あり）・`【EPUB版】` 等を除去
+- DRM: `"social"`（2017年導入の電子透かしで購入者情報を埋め込み、標準PDFビューアで閲覧可）
+
 **技術評論社 (gihyo)** — JSON API
 ```
 GET https://gihyo.jp/api_gh/site/search?search={keyword}&limit={n}
@@ -247,6 +282,29 @@ GET https://tatsu-zine.com/books/?search={keyword}
 ```
 複数出版社の電子書籍を委託販売。全書籍ソーシャルDRM。
 
+**Pragmatic Bookshelf (pragprog)** — 海外（米国）・JSONインデックス
+```
+GET https://pragprog.com/search/index.json   # 全書籍インデックス（lunr.js 用）
+```
+- 唯一の海外（英語）出版社。サイト内検索は lunr.js のクライアントサイド検索なので、インデックス JSON を取得して**ローカルフィルタ**する
+- インデックスの各レコード: `record_type`（`"book"`/`"errata"`）・`href`・`title`・`subtitle`・`author`・`keywords[]`・`code`・`image`。`"book"` のみ対象
+- 検索: タイトル語は title+subtitle+keywords に全トークン一致、著者は `author` 部分一致。インデックスに価格・ISBN・発行日はない
+- 詳細: `/titles/{code}/{slug}/`。`<meta property="book:isbn|book:author|og:*">` と `.book-about-text`（"Published: July 2026" → `2026-07-01`）・`.buybox`（"$39.95 (USD)"）から取得
+- 著者: "A with B, C, and D" を `with`/`and`/カンマで分割（オックスフォードカンマの "and" 残りも除去）
+- 価格は **USD** なので `price` に数値・`currency: "USD"` を付与
+- DRM: `"free"`（PDF/epub/mobi 全フォーマット提供・技術的DRMなし）
+
+**Leanpub (leanpub)** — 海外（米国）・セルフ出版プラットフォーム
+```
+GET https://leanpub.com/store?search={keyword}   # サーバーレンダリングのストア検索
+```
+- 海外のセルフパブリッシング・プラットフォーム。React Router (Remix系) アプリだが、ストア検索結果は静的HTMLでレンダリングされる
+- 検索結果: 書影付き `<li>`（書影 `cloudfront.net/{slug}/s_featured`）を走査。slug は書影URLから取得し、`a[href="/{slug}"]` のテキストをタイトル、`.text-neutral-500` を著者、`.italic` をサブタイトルとして取得
+- 詳細 `/{slug}`: タイトル・著者・説明・書影は `<meta property="og:*">`・`<meta name="author">` から取得
+- **価格・更新日は埋め込み React Router ストリーム（`<script>`内）から正規表現で取得**: `minimumPaidPrice\",{数値}`（最低価格）・`lastPublishedAt\",\"{YYYY-MM-DD}`。静的HTMLの表示テキスト（"Last updated on ..." 等）は CDN/SSR 状態で揺れて不安定なため使わない
+- 価格は pay-what-you-want の**最低価格**・**USD**（`currency: "USD"`）。ISBN は持たない
+- DRM: `"free"`（PDF/EPUB、技術的DRMなし）。`publisher` はセルフ出版のため `"Leanpub"`
+
 **技術書典 (techbookfest)** — GraphQL
 ```
 POST https://techbookfest.org/api/graphql
@@ -278,10 +336,12 @@ type DrmType = "free" | "social" | "password_pdf" | "drm";
 | ラトルズ | `free` | 購入・確認済み |
 | PEAKS | `free` | 利用規約に明記 |
 | オプトロニクス社 | `free` | 購入・確認済み |
+| Pragmatic Bookshelf | `free` | PDF/epub/mobi 全フォーマット提供・DRMなし |
 | Gihyo Digital Publishing | `social` | 公式方針 |
 | SEshop (翔泳社) | `social` | メールアドレス埋め込み透かし |
 | BOOK TECH | `social` | 購入者情報透かし |
 | ボーンデジタル | `social` | PDFにメールアドレス印字 |
+| CQ出版 Tech Village | `social` | 2017年導入の電子透かしで購入者情報を埋め込み |
 | マナティ | `social` | 公式 about ページに明記 |
 | ラムダノート | `social` | 公式方針 |
 | 達人出版会 | `social` | 公式方針 |
@@ -303,13 +363,73 @@ type DrmType = "free" | "social" | "password_pdf" | "drm";
 |---------|------|---------|
 | `search_books` | 書名・著者名で検索 | `title?`, `author?`, `publisher?`, `limit?` |
 | `get_book_detail` | URLから詳細情報取得 | `url` |
+| `get_book_by_isbn` | ISBNから書誌情報取得（openBD→出版社サイト→カーリル） | `isbn` |
 | `list_publishers` | 対応出版社一覧 | なし |
 
+## 検索の挙動
+
+利用エージェント側の試行錯誤を減らすため、`search_books` は以下の前処理・後処理を行う。
+
+- **ベストマッチ順ソート**: 各候補にクエリとの一致度 `matchScore`（0〜1、1が完全一致）を付与し降順に並べる。
+  先頭ほど本命候補なので、PDF奥付から推定した曖昧な title/author でも候補選びに迷わない。
+  スコアは `src/domain/text-match.ts` の `normalizeForMatch()`（NFKC で全半角統一・装飾括弧/長音/約物/空白を除去）＋
+  書名はクエリを空白でトークン分割して候補書名への包含割合で算出する（純日本語の部分語が助詞を跨いでも拾える）。
+  `matchScore` はクエリ相対値のためドメインの `BookRecord` には載せず、検索結果境界の `ScoredBook` 型に限定する
+- **ゼロ関連度のフォールバックを除外**: クエリ語があるのに `matchScore` が 0 の候補（検索サイトが「該当なし」時に返す新着順の無関係本）は除外する。
+  「該当なし」を空配列で表し、「該当なし」と「誤ヒット」を呼び出し側が区別できるようにする（誤メタデータ混入を防ぐ）
+- **著者の重複排除**: `src/domain/authors.ts` の `dedupeAuthors()` で著者配列の重複を除く（`normalizeForMatch` をキーに表記ゆれも同一視）。search/detail/isbn の全経路に適用
+- **openBD による欠損補完**: ISBN を持つ結果は `enrichWithOpenBD()` で `authors`（空のとき）・`publishedAt`・`price`・`coverImageUrl`・`description` を補完する。出版社の検索APIが著者や紹介文を返さない場合の救済（アダプタ間の取得項目の不揃いを平準化）
+- **大規模出版社を優先スケジュール**: `PublisherAdapter.scale === "minor"` の小規模・専門/ローカルフィルタ型サイトは大規模出版社の後に回す。
+  小規模サイトのカタログは変動が少ないため `CATALOG_CACHE_TTL_SECONDS`（24時間）で全キャッシュし、ライブ負荷を抑える
+- **並列度制限・タイムアウト**: `src/application/concurrency.ts` の `mapWithConcurrency`（`SEARCH_CONCURRENCY = 6`）と
+  `withTimeout`（`SEARCH_TIMEOUT_MS = 12s`）で、遅い1社が全体をブロックしないようにする（部分結果を返す）
+- **errors の集約**: 失敗理由を `type`（`robots` / `timeout` / `http` / `other`）に分類し、MCP 層で種別×出版社に集約して静音化する
+- **ISBN ショートカット**: `title` が ISBN 形式（`src/domain/isbn.ts` の `looksLikeIsbn`）かつ `author` 未指定なら、
+  全社横断をやめて `get_book_by_isbn` 経路に振り分ける
+
+## カバレッジの制約
+
+各アダプターは出版社の**現行ストアの生カタログ**（検索結果ページ・電子書籍一覧・JSON索引）をスクレイプする。
+このため、出版社がストアから**販売終了・取り下げした旧刊**は構造的に `search_books` でヒットしない。
+共通パターンは2008〜2013年頃の短編・電子書籍専売タイトル。書籍自体は実在するが、現行の検索可能な索引のどこにも載っていない。
+
+riida-mcp フィードバック「現象9」で報告された未ヒット例の調査結果（2026-06-02 確認）:
+
+- **オライリー・ジャパン（旧刊 Ebook版のみタイトル）**: `CSS3の値、単位、色`（9784873116266）・`セレクタ、詳細度、カスケード`（9784873116037）・
+  `D3をはじめよう`（9784873115979）・`Web Workers`（9784873115962）・`OAuth 2.0をはじめよう`（9784873115580）・
+  `PHP開発者のためのJavaScript`（9784873116433）等。
+  これらは `/books/{isbn}/` の詳細ページは生きている（HTTP 200）が、`oreilly-japan` がフィルタする `/ebook/` 一覧
+  （現行ストアで販売中の約580冊）にも `/catalog/`・カテゴリページ（`/books/{topic}/`）にも載っていない。
+  詳細ページの `buying-options` は空（=現行ストアで購入導線なし。og:description に「本書はEbook版のみの販売となります」と残るが実売は終了）。
+  `sitemap.xml` も無く（404）、旧刊を網羅する代替の生インデックスは存在しない → **一覧ソースの差し替えでは救済不能**。
+  さらにこれら電子書籍専売 ISBN は openBD にも未登録（紙流通前提の JPRO/openBD に載らない）なため、
+  `search_books` だけでなく `get_book_by_isbn` の通常経路（openBD → カーリル）でも失敗する。
+- **翔泳社 / SEshop（旧刊）**: `レガシーソフトウェア改善ガイド`・`実用Common Lisp`・`初めての人のためのLISP［増補改訂版］`・
+  `エンジニアのための文章術 再入門講座 新版` 等。SEshop 検索（全カテゴリ）でそもそも 0 件＝**ストアに商品ページ自体が残っていない**
+  （O'Reilly と違い詳細ページも消えている）。電子版が存在しないか取り下げ済みで、`seshop` アダプタの取りこぼしではない。
+
+### 旧刊救済: ISBN からの詳細ページ直引き（`detailUrlForIsbn`）
+
+部分的な救済余地があるのはオライリーのみ。詳細ページ `/books/{isbn}/` が生きているため、以下を実装済み:
+
+- `PublisherAdapter.detailUrlForIsbn?(isbn)`（任意メソッド）— ISBN ベースの安定 URL を持つサイトが詳細ページ URL を構成する。
+  `oreilly-japan` が `/books/{isbn}/` を返す。
+- `isbn-publisher-codes.ts` の `oreilly-japan` に旧記号 `87311` を追加（従来は新記号 `8144` のみ）。
+- `get_book_by_isbn` は openBD ミス時、カーリルより先に `detailUrlForIsbn` 経路（robots.txt 確認 → `getDetail`）を試みる
+  （`fetchDetailByIsbnCode`）。これで `CSS3の値、単位、色`（9784873116266）等は**価格を除く書誌**（書名・著者・発行日・説明・書影）が回収できる。
+  価格は詳細ページの `buying-options` が空のため取得不可。
+
+ただし `search_books`（横断検索）では依然ヒットしない（`/ebook/` 一覧に無いため）。回収には ISBN が分かっている必要がある。
+SEshop 旧刊は詳細ページごと消えているため `detailUrlForIsbn` でも回収不能。
+
 ## 新しいアダプターの追加手順
 
 1. `src/adapters/publishers/{id}.ts` を作成し `PublisherAdapter` を実装
    - `search()`: 検索APIまたはHTMLスクレイピングで `BookRecord[]` を返す
    - `getDetail()`: 詳細ページをスクレイピングして `BookRecord` を返す
+   - 海外出版社など日本語以外なら `language`（ISO 639-1）を宣言する（省略時はアプリ層で `"ja"` とみなす）
+   - ラインナップが小さい/検索APIがなく全カタログをローカルフィルタするサイトは `scale: "minor"` を宣言し、
+     カタログ取得を `fetchText(url, deps, undefined, CATALOG_CACHE_TTL_SECONDS)` で長期キャッシュする
 2. `tests/fixtures/{id}-search.html` (または `.json`) を作成
 3. `tests/fixtures/{id}-detail.html` を作成
 4. `tests/unit/adapters/publishers/{id}.test.ts` を作成
@@ -317,7 +437,7 @@ type DrmType = "free" | "social" | "password_pdf" | "drm";
 6. `src/adapters/publishers/registry.ts` に登録
 
 よく使う共通ユーティリティ (`base.ts`):
-- `fetchText(url, deps, extraHeaders?)` — キャッシュ付きHTTP GET
+- `fetchText(url, deps, extraHeaders?, ttlSeconds?)` — キャッシュ付きHTTP GET（`ttlSeconds` 省略時 1時間、小規模カタログは `CATALOG_CACHE_TTL_SECONDS`）
 - `parseJapanesePrice(text)` — "3,740円（税込）" → 3740
 - `resolveUrl(base, path)` — 相対URLを絶対URLに解決
 - `extractEbookStoresFromDoc(doc)` — ページ内リンクから電子書籍ストアを自動検出

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zonuexe/techbook-mcp",
-  "version": "0.2.3",
+  "version": "0.3.1",
   "description": "MCP server for searching Japanese technical book bibliographic information",
   "license": "AGPL-3.0-or-later",
   "type": "module",
@@ -10,23 +10,22 @@
   "bin": {
     "techbook-mcp": "dist/main.js"
   },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "cheerio": "^1.2.0",
+    "iconv-lite": "^0.7.2",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "oxlint": "^1.68.0",
+    "tsx": "^4.22.4",
+    "typescript": "^6.0.3"
+  },
   "scripts": {
     "build": "tsc",
     "lint": "oxlint --config .oxlintrc.json src/",
-    "prepublishOnly": "npm run build",
     "test": "node --import tsx/esm --test 'tests/**/*.test.ts'",
     "test:watch": "node --import tsx/esm --test --watch 'tests/**/*.test.ts'"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.11.0",
-    "cheerio": "^1.0.0",
-    "iconv-lite": "^0.6.0",
-    "zod": "^3.24.0"
-  },
-  "devDependencies": {
-    "@types/node": "^22.0.0",
-    "oxlint": "^1.59.0",
-    "tsx": "^4.0.0",
-    "typescript": "^5.8.0"
   }
-}
+}

package/.claude/settings.local.json

@@ -1,38 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(npm info:*)",
-      "Bash(python3 -c \"import sys,json; d=json.load\\(sys.stdin\\); print\\('version:', d.get\\('version'\\)\\); print\\('exports:', list\\(d.get\\('exports', {}\\).keys\\(\\)\\)[:20]\\)\")",
-      "WebFetch(domain:gihyo.jp)",
-      "WebFetch(domain:www.lambdanote.com)",
-      "Bash(curl:*)",
-      "Bash(python3 -c ':*)",
-      "Bash(npx vitest:*)",
-      "Bash(git mv:*)",
-      "Bash(git add:*)",
-      "Bash(git commit -m ':*)",
-      "Bash(node:*)",
-      "Bash(npm install:*)",
-      "Bash(curl -s \"https://wgn-obs.shop-pro.jp/?mode=srh&keyword=HTML\" -A \"Mozilla/5.0\")",
-      "Read(//tmp/**)",
-      "Bash(npm test:*)",
-      "Bash(python3:*)",
-      "WebFetch(domain:www.personal-media.co.jp)",
-      "Bash(grep -rn \"export.*Element\" node_modules/cheerio/dist/esm/*.d.ts)",
-      "Bash(npx tsc:*)",
-      "Bash(npx oxlint:*)",
-      "Bash(npm run:*)",
-      "Bash(curl -s \"https://book.impress.co.jp/books/1124101031\")",
-      "Bash(curl -s \"https://book.impress.co.jp/books/1125101113\")",
-      "Bash(cp /tmp/impress-detail-social.html tests/fixtures/impress-detail-social.html)",
-      "Bash(cp /tmp/impress-detail-nodrm.html tests/fixtures/impress-detail-epub.html)",
-      "Bash(wc -c tests/fixtures/impress-detail-*.html)",
-      "Bash(git -C /Users/megurine/repo/js/techbook-mcp status)",
-      "Bash(git -C /Users/megurine/repo/js/techbook-mcp diff)",
-      "Bash(git:*)",
-      "Bash(npm pkg:*)",
-      "WebFetch(domain:api.openbd.jp)",
-      "WebFetch(domain:calil.jp)"
-    ]
-  }
-}

package/.codex/skills/techbook-mcp-release-prep/SKILL.md

@@ -1,105 +0,0 @@
----
-name: techbook-mcp-release-prep
-description: Prepare a techbook-mcp release by bumping the version, updating the changelog, and running verification. Use when the user asks to prepare the next version, cut a release, or make sure versioned files are consistent before tagging.
----
-
-# techbook-mcp Release Prep
-
-Follow this workflow when preparing a new `techbook-mcp` release.
-
-## Decide the Next Version
-
-Choose the next semantic version before touching any files.
-
-- `patch` (0.x.Y) — bug fixes, no new functionality
-- `minor` (0.X.0) — new adapters, new features, backward-compatible changes
-- `major` (X.0.0) — breaking changes to the MCP tool interface or `BookRecord` schema
-
-If the user specifies a version, use it. Otherwise infer from the unreleased commits since the last tag.
-
-## Update Versioned Files
-
-Update these files together in one pass:
-
-- `CHANGELOG.md`
-- `package.json` — `"version"` field
-- `package-lock.json` — `"version"` field in the root object (same value as `package.json`)
-
-### CHANGELOG.md Rules
-
-- If `CHANGELOG.md` does not exist yet, create it with the standard Keep a Changelog header.
-- Add a new `## [x.y.z] - YYYY-MM-DD` section directly below `## [Unreleased]`.
-- Use Keep a Changelog section headings as needed: `Added`, `Changed`, `Deprecated`, `Removed`, `Fixed`, `Security`.
-- Group the same kinds of changes under the same heading.
-- Write entries user-facing: what changed, not how. Skip internal refactors unless they affect users.
-- List new publisher adapters under `Added`.
-- Preserve the release date in every version heading.
-- Keep the `[Unreleased]` section empty after moving its contents to the new release section.
-- Update the `[Unreleased]` compare link and add the new release compare link at the bottom of the file.
-- Keep version headings and bottom-of-file links consistent so releases and compare ranges remain linkable.
-
-### CHANGELOG.md Template (first release)
-
-```markdown
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [Unreleased]
-
-## [x.y.z] - YYYY-MM-DD
-
-### Added
-
-- ...
-
-[Unreleased]: https://github.com/zonuexe/techbook-mcp/compare/vx.y.z...HEAD
-[x.y.z]: https://github.com/zonuexe/techbook-mcp/releases/tag/vx.y.z
-```
-
-## Verify Before Committing
-
-Run all checks in order:
-
-```bash
-npm test
-```
-
-```bash
-npm run lint
-```
-
-```bash
-npm run build
-```
-
-All three must pass. Do not commit if any check fails.
-
-## Commit the Release
-
-Prefer a single release-prep commit containing:
-
-- version bump in `package.json` and `package-lock.json`
-- `CHANGELOG.md` update
-
-Use this commit message format:
-
-```text
-Bump up version to x.y.z
-```
-
-Do not include other unrelated changes in the release commit.
-
-## Quick Checklist
-
-- Working tree starts clean or you understand every pending change.
-- `CHANGELOG.md` has a new `## [x.y.z] - YYYY-MM-DD` section with user-facing entries.
-- `package.json` and `package-lock.json` both show the new version.
-- Bottom-of-file links in `CHANGELOG.md` are consistent.
-- `npm test` passed.
-- `npm run lint` passed.
-- `npm run build` passed.
-- Commit message follows `chore: release x.y.z`.

package/.github/workflows/test.yml

@@ -1,72 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches: [main, master]
-  pull_request:
-    branches: [main, master]
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-
-    strategy:
-      matrix:
-        node-version: [22.x]
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v4
-        with:
-          node-version: ${{ matrix.node-version }}
-          cache: npm
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Lint
-        run: npm run lint
-
-      - name: Type check
-        run: npx tsc --noEmit
-
-      - name: Run tests
-        run: npm test
-
-      - name: Build
-        run: npm run build
-
-  bun:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: oven-sh/setup-bun@v2
-
-      - name: Install dependencies
-        run: bun install
-
-      - name: Run tests
-        run: bun test
-
-  deno:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: denoland/setup-deno@v2
-        with:
-          deno-version: v2.x
-
-      - name: Install Node deps (for node_modules)
-        uses: actions/setup-node@v4
-        with:
-          node-version: 22.x
-          cache: npm
-
-      - run: npm ci
-
-      - name: Run tests
-        run: deno test --allow-read --no-check --sloppy-imports tests/

package/.oxlintrc.json

@@ -1,12 +0,0 @@
-{
-  "$schema": "https://raw.githubusercontent.com/oxc-project/oxc/main/npm/oxlint/configuration_schema.json",
-  "plugins": ["typescript", "unicorn"],
-  "rules": {
-    "no-unused-vars": "error",
-    "no-console": "warn",
-    "unicorn/no-array-for-each": "error",
-    "unicorn/prefer-string-slice": "error",
-    "typescript/consistent-type-imports": "error"
-  },
-  "ignorePatterns": ["dist/**", "node_modules/**"]
-}

package/AGENTS.md

@@ -1,100 +0,0 @@
-# techbook-mcp — AI エージェント向けガイド
-
-日本語技術書の書誌情報を出版社公式サイト・APIから取得するMCPサーバー。
-詳細な設計は [docs/design-doc.md](docs/design-doc.md) を参照。
-
-## コミットメッセージ規約
-
-Conventional Commits は使わない。コミットメッセージは端的な日本語または英語の命令形で書く。
-
-```
-robots.txt チェックを追加し結果を6時間キャッシュする
-Add robots.txt check with 6-hour cache
-```
-
-## 開発コマンド
-
-```bash
-npm install
-npm test           # ユニットテスト実行 (node:test)
-npm run build      # TypeScript コンパイル → dist/
-```
-
-## コーディング規約
-
-- **新しいアダプターを追加するときは必ずテストも書く**（`tests/unit/adapters/publishers/{id}.test.ts`）
-- テストは `MockHttpClient` + `NullCacheStore` + `CheerioHtmlParser` の組み合わせで書く
-- フィクスチャHTMLは `tests/fixtures/` に配置し、実サイトの構造を忠実に再現する
-- `fetchText()` はキャッシュ・ヘッダーを内包するため、アダプター内では直接 `deps.http.get()` を呼ばない
-- Referer ヘッダーが必要なサイトは `fetchText(url, deps, { Referer: "..." })` の第3引数を使う
-- 著者名から役割語（著・訳・編・監修・監訳など）を除去すること
-- 価格は税込み整数（円）で `BookRecord.price` に格納する
-- `publisher` フィールドには実際の出版社名を入れる（ストアプラットフォーム名ではない）
-
-## 新しい出版社アダプターを追加するとき
-
-`docs/design-doc.md` の「新しいアダプターの追加手順」を参照。要点は以下:
-
-1. `src/adapters/publishers/{id}.ts` — `PublisherAdapter` インターフェースを実装
-2. `tests/fixtures/{id}-search.html` + `{id}-detail.html` — 実サイトHTMLのスナップショット
-3. `tests/unit/adapters/publishers/{id}.test.ts` — `MockHttpClient` でユニットテスト
-4. `src/adapters/publishers/base.ts` — 必要に応じて `EBOOK_STORE_PATTERNS` に追加
-5. `src/adapters/publishers/registry.ts` — `DEFAULT_PUBLISHERS` に登録
-
-## DRM 分類の判断基準
-
-新しいストアを `EBOOK_STORE_PATTERNS` に追加する際の判断順:
-1. **free** — 公式が明言、または購入して透かし等がないことを確認済み
-2. **social** — 購入者情報（メールアドレス等）が埋め込まれるが技術的制限なし
-3. **password_pdf** — PDFにパスワードがかかる（標準ビューアで開ける）
-4. **drm** — 専用ビューアーが必要、または上記いずれでもない場合
-
-## アーキテクチャ上の制約
-
-- ポート (`HttpClient`, `HtmlParser`, `CacheStore`) はインターフェースのみ。実装を直接 import しない
-- `DrmType` に新しい値を追加するときは `src/domain/book.ts` と `src/mcp/server.ts` の両方を更新する
-
-## テスト方針
-
-テストフレームワークは `node:test` + `node:assert/strict` を使う（vitest は使わない）。
-
-```typescript
-import { describe, it } from "node:test";
-import assert from "node:assert/strict";
-
-// 標準的なテストセットアップ
-function makeDeps(http: MockHttpClient) {
-  return { http, parser: new CheerioHtmlParser(), cache: new NullCacheStore() };
-}
-
-// GET のモック（URL前方一致）
-const http = new MockHttpClient()
-  .addResponse("https://example.com/search", { status: 200, body: html });
-
-// POST のモック (GraphQL等)
-const http = new MockHttpClient()
-  .addPostResponse("https://api.example.com/graphql", { status: 200, body: json });
-
-// vitest → node:assert の主な対応
-// expect(x).toBe(y)          → assert.strictEqual(x, y)
-// expect(x).toEqual(y)       → assert.deepStrictEqual(x, y)
-// expect(x).toMatchObject(y) → assert.partialDeepStrictEqual(x, y)
-// expect(x).toHaveLength(n)  → assert.strictEqual(x.length, n)
-// expect(x).toContain(s)     → assert.ok(x.includes(s))
-// expect(x).toMatch(/r/)     → assert.match(x, /r/)
-// await expect(p).rejects.toThrow("msg") → await assert.rejects(p, /msg/)
-
-// モック関数: node:test の mock.fn() は Bun 非対応のため、テストファイル内に
-// ローカルで mockFn() ヘルパーを定義して使う（Node.js・Bun・Deno 共通で動作）
-// vi.fn().mockResolvedValue(v) → mockFn(async () => v)
-// fn.toHaveBeenCalledOnce()    → assert.strictEqual(fn.mock.callCount(), 1)
-```
-
-## よくある落とし穴
-
-- **EUC-JP サイト**: `shop.rutles.net` はクエリを EUC-JP エンコードしないとヒットしない → `iconv-lite` を使用
-- **XSRF-TOKEN**: `techbookfest.org` GraphQL はダブルサブミットCookieパターン必須
-- **Referer 必須**: `maruzen-publishing.co.jp` の検索は Referer なしで 403
-- **機関向けストア除外**: `kw.maruzen.co.jp`（Knowledge Worker）は個人向けではないため除外
-- **ローカルフィルタ型**: `oreilly-japan` と `peaks` は検索APIがなくトップページ/一覧をローカルフィルタ
-- **著者のみ検索不可**: ローカルフィルタ型アダプターは `!query.title` のとき `[]` を返す（HTTP呼ばない）

package/deno.json

@@ -1,3 +0,0 @@
-{
-  "nodeModulesDir": "auto"
-}

package/src/adapters/cache/memory-cache.ts

@@ -1,31 +0,0 @@
-import type { CacheStore } from "../../ports/cache.js";
-
-interface CacheEntry {
-  value: string;
-  expiresAt?: number;
-}
-
-export class MemoryCacheStore implements CacheStore {
-  private readonly store = new Map<string, CacheEntry>();
-
-  async get(key: string): Promise<string | null> {
-    const entry = this.store.get(key);
-    if (!entry) return null;
-    if (entry.expiresAt !== undefined && Date.now() > entry.expiresAt) {
-      this.store.delete(key);
-      return null;
-    }
-    return entry.value;
-  }
-
-  async set(key: string, value: string, ttlSeconds?: number): Promise<void> {
-    this.store.set(key, {
-      value,
-      expiresAt: ttlSeconds !== undefined ? Date.now() + ttlSeconds * 1000 : undefined,
-    });
-  }
-
-  async delete(key: string): Promise<void> {
-    this.store.delete(key);
-  }
-}