@zonuexe/techbook-mcp 0.1.0

package/tests/unit/adapters/publishers/saiensu.test.ts

@@ -0,0 +1,167 @@
+import { describe, it, expect } from "vitest";
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { saiensuAdapter } from "../../../../src/adapters/publishers/saiensu.js";
+import { MockHttpClient } from "../../../../src/adapters/http/mock-client.js";
+import { CheerioHtmlParser } from "../../../../src/adapters/html/cheerio-parser.js";
+import { NullCacheStore } from "../../../../src/adapters/cache/null-cache.js";
+
+const FIXTURES_DIR = join(import.meta.dirname, "../../../fixtures");
+
+function makeDeps(http: MockHttpClient) {
+  return { http, parser: new CheerioHtmlParser(), cache: new NullCacheStore() };
+}
+
+async function loadFixture(name: string): Promise<string> {
+  return readFile(join(FIXTURES_DIR, name), "utf-8");
+}
+
+describe("saiensuAdapter", () => {
+  describe("search()", () => {
+    it("電子書籍のみ BookRecord[] を返す（紙は除外）", async () => {
+      const body = await loadFixture("saiensu-search.html");
+      const http = new MockHttpClient().addResponse(
+        "https://www.saiensu.co.jp/search/",
+        { status: 200, body },
+      );
+
+      const results = await saiensuAdapter.search({ title: "統計" }, makeDeps(http));
+
+      // フィクスチャには電子1件・紙1件あり、電子のみ返す
+      expect(results).toHaveLength(1);
+      expect(results[0]).toMatchObject({
+        title: "統計リテラシーI【電子版】 ―記述統計から推測統計へ",
+        authors: ["堀井俊佑"],
+        publisher: "サイエンス社",
+        url: "https://www.saiensu.co.jp/search/?isbn=978-4-7819-9049-1&y=2026",
+        isbn: "9784781990491",
+        price: 2695,
+        publishedAt: "2026-03-25",
+      });
+    });
+
+    it("coverImageUrl が設定される", async () => {
+      const body = await loadFixture("saiensu-search.html");
+      const http = new MockHttpClient().addResponse(
+        "https://www.saiensu.co.jp/search/",
+        { status: 200, body },
+      );
+
+      const results = await saiensuAdapter.search({ title: "統計" }, makeDeps(http));
+
+      expect(results[0].coverImageUrl).toBe(
+        "https://www.saiensu.co.jp/bookThumbs/2026-978-4-7819-9049-1.jpg",
+      );
+    });
+
+    it("ebookStores にサイエンス社(DRM付き)が含まれる", async () => {
+      const body = await loadFixture("saiensu-search.html");
+      const http = new MockHttpClient().addResponse(
+        "https://www.saiensu.co.jp/search/",
+        { status: 200, body },
+      );
+
+      const results = await saiensuAdapter.search({ title: "統計" }, makeDeps(http));
+
+      expect(results[0].ebookStores).toEqual([
+        {
+          name: "サイエンス社",
+          url: "https://www.saiensu.co.jp/search/?isbn=978-4-7819-9049-1&y=2026",
+          drm: "password_pdf",
+        },
+      ]);
+    });
+
+    it("著者の所属・役割語を除去する", async () => {
+      const body = await loadFixture("saiensu-search.html");
+      const http = new MockHttpClient().addResponse(
+        "https://www.saiensu.co.jp/search/",
+        { status: 200, body },
+      );
+
+      const results = await saiensuAdapter.search({ title: "統計" }, makeDeps(http));
+
+      expect(results[0].authors).toEqual(["堀井俊佑"]);
+    });
+
+    it("title も author も空の場合は [] を返しHTTPを呼ばない", async () => {
+      const http = new MockHttpClient();
+
+      const results = await saiensuAdapter.search({}, makeDeps(http));
+
+      expect(results).toEqual([]);
+      expect(http.calls).toHaveLength(0);
+    });
+
+    it("検索リクエストに keyword が含まれる", async () => {
+      const body = await loadFixture("saiensu-search.html");
+      const http = new MockHttpClient().addResponse(
+        "https://www.saiensu.co.jp/search/",
+        { status: 200, body },
+      );
+
+      await saiensuAdapter.search({ title: "意味論" }, makeDeps(http));
+
+      expect(http.calls[0]).toContain("keyword=%E6%84%8F%E5%91%B3%E8%AB%96");
+    });
+  });
+
+  describe("getDetail()", () => {
+    it("詳細情報を返す", async () => {
+      const body = await loadFixture("saiensu-detail.html");
+      const http = new MockHttpClient().addResponse(
+        "https://www.saiensu.co.jp/search/?isbn=978-4-7819-9049-1&y=2026",
+        { status: 200, body },
+      );
+
+      const book = await saiensuAdapter.getDetail(
+        "https://www.saiensu.co.jp/search/?isbn=978-4-7819-9049-1&y=2026",
+        makeDeps(http),
+      );
+
+      expect(book).toMatchObject({
+        title: "統計リテラシーI【電子版】 ―記述統計から推測統計へ",
+        publisher: "サイエンス社",
+        isbn: "9784781990491",
+        price: 2695,
+        publishedAt: "2026-03-25",
+      });
+    });
+
+    it("著者の所属・役割語を除去する", async () => {
+      const body = await loadFixture("saiensu-detail.html");
+      const http = new MockHttpClient().addResponse(
+        "https://www.saiensu.co.jp/search/?isbn=978-4-7819-9049-1&y=2026",
+        { status: 200, body },
+      );
+
+      const book = await saiensuAdapter.getDetail(
+        "https://www.saiensu.co.jp/search/?isbn=978-4-7819-9049-1&y=2026",
+        makeDeps(http),
+      );
+
+      expect(book.authors).toEqual(["堀井俊佑"]);
+    });
+
+    it("ebookStores にサイエンス社(DRM付き)が含まれる", async () => {
+      const body = await loadFixture("saiensu-detail.html");
+      const http = new MockHttpClient().addResponse(
+        "https://www.saiensu.co.jp/search/?isbn=978-4-7819-9049-1&y=2026",
+        { status: 200, body },
+      );
+
+      const book = await saiensuAdapter.getDetail(
+        "https://www.saiensu.co.jp/search/?isbn=978-4-7819-9049-1&y=2026",
+        makeDeps(http),
+      );
+
+      expect(book.ebookStores).toEqual([
+        {
+          name: "サイエンス社",
+          url: "https://www.saiensu.co.jp/search/?isbn=978-4-7819-9049-1&y=2026",
+          drm: "password_pdf",
+        },
+      ]);
+    });
+  });
+});

package/tests/unit/adapters/publishers/seshop.test.ts

@@ -0,0 +1,171 @@
+import { describe, it, expect } from "vitest";
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { seshopAdapter } from "../../../../src/adapters/publishers/seshop.js";
+import { MockHttpClient } from "../../../../src/adapters/http/mock-client.js";
+import { CheerioHtmlParser } from "../../../../src/adapters/html/cheerio-parser.js";
+import { NullCacheStore } from "../../../../src/adapters/cache/null-cache.js";
+
+const FIXTURES_DIR = join(import.meta.dirname, "../../../fixtures");
+
+function makeDeps(http: MockHttpClient) {
+  return { http, parser: new CheerioHtmlParser(), cache: new NullCacheStore() };
+}
+
+async function loadFixture(name: string): Promise<string> {
+  return readFile(join(FIXTURES_DIR, name), "utf-8");
+}
+
+describe("seshopAdapter", () => {
+  describe("search()", () => {
+    it("電子書籍のみ BookRecord[] を返す（紙書籍は除外）", async () => {
+      const body = await loadFixture("seshop-search.html");
+      const http = new MockHttpClient().addResponse(
+        "https://www.seshop.com/search",
+        { status: 200, body },
+      );
+
+      const results = await seshopAdapter.search({ title: "TypeScript" }, makeDeps(http));
+
+      // フィクスチャには電子2件・紙1件あり、電子のみ返す
+      expect(results).toHaveLength(2);
+      expect(results[0]).toMatchObject({
+        title: "TypeScript入門【PDF版】",
+        publisher: "翔泳社",
+        url: "https://www.seshop.com/product/detail/26500",
+        price: 3520,
+        publishedAt: "2024-06-10",
+      });
+    });
+
+    it("coverImageUrl が設定される", async () => {
+      const body = await loadFixture("seshop-search.html");
+      const http = new MockHttpClient().addResponse(
+        "https://www.seshop.com/search",
+        { status: 200, body },
+      );
+
+      const results = await seshopAdapter.search({ title: "TypeScript" }, makeDeps(http));
+
+      expect(results[0].coverImageUrl).toBe(
+        "https://www.seshop.com/static/images/product/26500/L.png",
+      );
+    });
+
+    it("ebookStores に SEshop (social DRM) が含まれる", async () => {
+      const body = await loadFixture("seshop-search.html");
+      const http = new MockHttpClient().addResponse(
+        "https://www.seshop.com/search",
+        { status: 200, body },
+      );
+
+      const results = await seshopAdapter.search({ title: "TypeScript" }, makeDeps(http));
+
+      expect(results[0].ebookStores).toEqual([
+        {
+          name: "SEshop",
+          url: "https://www.seshop.com/product/detail/26500",
+          drm: "social",
+        },
+      ]);
+    });
+
+    it("title も author も空の場合は [] を返しHTTPを呼ばない", async () => {
+      const http = new MockHttpClient();
+
+      const results = await seshopAdapter.search({}, makeDeps(http));
+
+      expect(results).toEqual([]);
+      expect(http.calls).toHaveLength(0);
+    });
+
+    it("検索リクエストに keyword と category_id=327 が含まれる", async () => {
+      const body = await loadFixture("seshop-search.html");
+      const http = new MockHttpClient().addResponse(
+        "https://www.seshop.com/search",
+        { status: 200, body },
+      );
+
+      await seshopAdapter.search({ title: "TypeScript" }, makeDeps(http));
+
+      expect(http.calls[0]).toContain("keyword=TypeScript");
+      expect(http.calls[0]).toContain("category_id=327");
+    });
+  });
+
+  describe("getDetail()", () => {
+    it("詳細情報を返す", async () => {
+      const body = await loadFixture("seshop-detail.html");
+      const http = new MockHttpClient().addResponse(
+        "https://www.seshop.com/product/detail/26500",
+        { status: 200, body },
+      );
+
+      const book = await seshopAdapter.getDetail(
+        "https://www.seshop.com/product/detail/26500",
+        makeDeps(http),
+      );
+
+      expect(book).toMatchObject({
+        title: "TypeScript入門【PDF版】",
+        publisher: "翔泳社",
+        isbn: "9784798190014",
+        price: 3520,
+        publishedAt: "2024-06-10",
+      });
+    });
+
+    it("複数著者を取得する", async () => {
+      const body = await loadFixture("seshop-detail.html");
+      const http = new MockHttpClient().addResponse(
+        "https://www.seshop.com/product/detail/26500",
+        { status: 200, body },
+      );
+
+      const book = await seshopAdapter.getDetail(
+        "https://www.seshop.com/product/detail/26500",
+        makeDeps(http),
+      );
+
+      expect(book.authors).toEqual(["山田 太郎", "鈴木 花子"]);
+    });
+
+    it("coverImageUrl が設定される", async () => {
+      const body = await loadFixture("seshop-detail.html");
+      const http = new MockHttpClient().addResponse(
+        "https://www.seshop.com/product/detail/26500",
+        { status: 200, body },
+      );
+
+      const book = await seshopAdapter.getDetail(
+        "https://www.seshop.com/product/detail/26500",
+        makeDeps(http),
+      );
+
+      expect(book.coverImageUrl).toBe(
+        "https://www.seshop.com/static/images/product/26500/L.png",
+      );
+    });
+
+    it("ebookStores に SEshop (social DRM) が含まれる", async () => {
+      const body = await loadFixture("seshop-detail.html");
+      const http = new MockHttpClient().addResponse(
+        "https://www.seshop.com/product/detail/26500",
+        { status: 200, body },
+      );
+
+      const book = await seshopAdapter.getDetail(
+        "https://www.seshop.com/product/detail/26500",
+        makeDeps(http),
+      );
+
+      expect(book.ebookStores).toEqual([
+        {
+          name: "SEshop",
+          url: "https://www.seshop.com/product/detail/26500",
+          drm: "social",
+        },
+      ]);
+    });
+  });
+});

package/tests/unit/adapters/publishers/tatsu-zine.test.ts

@@ -0,0 +1,130 @@
+import { describe, it, expect } from "vitest";
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { tatsuZineAdapter } from "../../../../src/adapters/publishers/tatsu-zine.js";
+import { MockHttpClient } from "../../../../src/adapters/http/mock-client.js";
+import { CheerioHtmlParser } from "../../../../src/adapters/html/cheerio-parser.js";
+import { NullCacheStore } from "../../../../src/adapters/cache/null-cache.js";
+
+const FIXTURES_DIR = join(import.meta.dirname, "../../../fixtures");
+
+function makeDeps(http: MockHttpClient) {
+  return { http, parser: new CheerioHtmlParser(), cache: new NullCacheStore() };
+}
+
+async function loadFixture(name: string): Promise<string> {
+  return readFile(join(FIXTURES_DIR, name), "utf-8");
+}
+
+describe("tatsuZineAdapter", () => {
+  describe("search()", () => {
+    it("検索結果から BookRecord[] を返す", async () => {
+      const body = await loadFixture("tatsu-zine-search.html");
+      const http = new MockHttpClient().addResponse(
+        "https://tatsu-zine.com/books/",
+        { status: 200, body },
+      );
+
+      const results = await tatsuZineAdapter.search({ title: "Go" }, makeDeps(http));
+
+      expect(results).toHaveLength(2);
+      expect(results[0]).toMatchObject({
+        title: "Goプログラミング実践入門",
+        authors: ["Sau Sheong Chang", "武舎 広幸"],
+        publisher: "達人出版会",
+      });
+      expect(results[0].url).toBe("https://tatsu-zine.com/books/go-programming");
+    });
+
+    it("ebookStores に達人出版会(ソーシャルDRM)が含まれる", async () => {
+      const body = await loadFixture("tatsu-zine-search.html");
+      const http = new MockHttpClient().addResponse(
+        "https://tatsu-zine.com/books/",
+        { status: 200, body },
+      );
+
+      const results = await tatsuZineAdapter.search({ title: "Go" }, makeDeps(http));
+
+      expect(results[0].ebookStores).toEqual([
+        { name: "達人出版会", url: "https://tatsu-zine.com/books/go-programming", drm: "social" },
+      ]);
+    });
+
+    it("limit を適用する", async () => {
+      const body = await loadFixture("tatsu-zine-search.html");
+      const http = new MockHttpClient().addResponse(
+        "https://tatsu-zine.com/books/",
+        { status: 200, body },
+      );
+
+      const results = await tatsuZineAdapter.search({ title: "Go", limit: 1 }, makeDeps(http));
+
+      expect(results).toHaveLength(1);
+    });
+
+    it("title も author も空の場合は [] を返しHTTPを呼ばない", async () => {
+      const http = new MockHttpClient();
+      const results = await tatsuZineAdapter.search({}, makeDeps(http));
+
+      expect(results).toEqual([]);
+      expect(http.calls).toHaveLength(0);
+    });
+
+    it("検索リクエストに search パラメータが含まれる", async () => {
+      const body = await loadFixture("tatsu-zine-search.html");
+      const http = new MockHttpClient().addResponse(
+        "https://tatsu-zine.com/books/",
+        { status: 200, body },
+      );
+
+      await tatsuZineAdapter.search({ title: "Go言語" }, makeDeps(http));
+
+      expect(http.calls[0]).toContain("search=Go%E8%A8%80%E8%AA%9E");
+    });
+  });
+
+  describe("getDetail()", () => {
+    it("詳細情報を返す（達人出版会は常にソーシャルDRM）", async () => {
+      const body = await loadFixture("tatsu-zine-detail-free.html");
+      const http = new MockHttpClient().addResponse(
+        "https://tatsu-zine.com/books/go-programming",
+        { status: 200, body },
+      );
+
+      const book = await tatsuZineAdapter.getDetail(
+        "https://tatsu-zine.com/books/go-programming",
+        makeDeps(http),
+      );
+
+      expect(book).toMatchObject({
+        title: "Goプログラミング実践入門",
+        authors: ["Sau Sheong Chang", "武舎 広幸"],
+        publisher: "インプレス",
+        price: 3520,
+      });
+      // 達人出版会は「ソーシャルDRM」と明記がなくても全書籍で購入者情報を印字
+      expect(book.ebookStores).toEqual([
+        { name: "達人出版会", url: "https://tatsu-zine.com/books/go-programming", drm: "social" },
+      ]);
+    });
+
+    it("出版社が達人出版会自身の場合はフォールバックする", async () => {
+      const body = `<!DOCTYPE html><html><body>
+        <h1>達人出版会刊行の本</h1>
+        <img src="/images/books/999/cover.jpg">
+        <dl><dt>著者</dt><dd>著者名(著)</dd><dt>定価</dt><dd>2,200円 (2,000円+税)</dd></dl>
+      </body></html>`;
+      const http = new MockHttpClient().addResponse(
+        "https://tatsu-zine.com/books/some-book",
+        { status: 200, body },
+      );
+
+      const book = await tatsuZineAdapter.getDetail(
+        "https://tatsu-zine.com/books/some-book",
+        makeDeps(http),
+      );
+
+      expect(book.publisher).toBe("達人出版会");
+    });
+  });
+});

package/tests/unit/adapters/publishers/techbookfest.test.ts

@@ -0,0 +1,93 @@
+import { describe, it, expect } from "vitest";
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { techbookfestAdapter } from "../../../../src/adapters/publishers/techbookfest.js";
+import { MockHttpClient } from "../../../../src/adapters/http/mock-client.js";
+import { CheerioHtmlParser } from "../../../../src/adapters/html/cheerio-parser.js";
+import { NullCacheStore } from "../../../../src/adapters/cache/null-cache.js";
+
+const FIXTURES_DIR = join(import.meta.dirname, "../../../fixtures");
+
+const XSRF_TOKEN = "test-xsrf-token-abc123";
+
+function makeDeps(http: MockHttpClient) {
+  return { http, parser: new CheerioHtmlParser(), cache: new NullCacheStore() };
+}
+
+/** トップページ GET → XSRF-TOKEN → GraphQL POST の 2 ステップを登録する */
+async function makeSearchHttp(fixtureName: string): Promise<MockHttpClient> {
+  const body = await readFile(join(FIXTURES_DIR, fixtureName), "utf-8");
+  return new MockHttpClient()
+    .addResponse("https://techbookfest.org", {
+      status: 200,
+      body: "",
+      headers: { "set-cookie": `XSRF-TOKEN=${encodeURIComponent(XSRF_TOKEN)}; Path=/; Secure` },
+    })
+    .addPostResponse("https://techbookfest.org/api/graphql", { status: 200, body });
+}
+
+describe("techbookfestAdapter", () => {
+  describe("search()", () => {
+    it("GraphQL レスポンスから BookRecord[] を返す", async () => {
+      const http = await makeSearchHttp("techbookfest-search.json");
+
+      const results = await techbookfestAdapter.search({ title: "TypeScript", limit: 10 }, makeDeps(http));
+
+      expect(results).toHaveLength(3);
+      expect(results[0]).toMatchObject({
+        title: "TypeScriptで学ぶデザインパターン",
+        authors: ["サークル名A"],
+        publisher: "技術書典",
+        url: "https://techbookfest.org/product/01HXXXX1",
+        price: 1000,
+        publishedAt: "2024-01-15",
+      });
+      expect(results[0].coverImageUrl).toBe("https://techbookfest.org/api/image/01HXXXX1.png");
+    });
+
+    it("ebookStores に技術書典(DRMフリー)が含まれる", async () => {
+      const http = await makeSearchHttp("techbookfest-search.json");
+
+      const results = await techbookfestAdapter.search({ title: "TypeScript" }, makeDeps(http));
+
+      expect(results[0].ebookStores).toEqual([
+        { name: "技術書典", url: "https://techbookfest.org/product/01HXXXX1", drm: "free" },
+      ]);
+    });
+
+    it("coverImage が null の場合 coverImageUrl は undefined", async () => {
+      const http = await makeSearchHttp("techbookfest-search.json");
+
+      const results = await techbookfestAdapter.search({ title: "TypeScript" }, makeDeps(http));
+
+      const book = results.find(b => b.url === "https://techbookfest.org/product/01HXXXX2");
+      expect(book?.coverImageUrl).toBeUndefined();
+    });
+
+    it("title も author も空の場合は [] を返しHTTPを呼ばない", async () => {
+      const http = new MockHttpClient();
+      const results = await techbookfestAdapter.search({}, makeDeps(http));
+
+      expect(results).toEqual([]);
+      expect(http.calls).toHaveLength(0);
+    });
+
+    it("トップページ GET で XSRF-TOKEN を取得してから GraphQL に POST する", async () => {
+      const http = await makeSearchHttp("techbookfest-search.json");
+
+      await techbookfestAdapter.search({ title: "TypeScript" }, makeDeps(http));
+
+      expect(http.calls[0]).toBe("https://techbookfest.org");
+      expect(http.calls[1]).toBe("https://techbookfest.org/api/graphql");
+    });
+
+    it("price が 0 の書籍も返す", async () => {
+      const http = await makeSearchHttp("techbookfest-search.json");
+
+      const results = await techbookfestAdapter.search({ title: "TypeScript" }, makeDeps(http));
+
+      const freeBook = results.find(b => b.url === "https://techbookfest.org/product/01HXXXX3");
+      expect(freeBook?.price).toBe(0);
+    });
+  });
+});

package/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/vitest.config.ts

@@ -0,0 +1,8 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    include: ["tests/**/*.test.ts"],
+    environment: "node",
+  },
+});