@zonuexe/techbook-mcp 0.2.2 → 0.2.4

package/src/adapters/publishers/techbookfest.ts

@@ -1,179 +0,0 @@
-import type { PublisherAdapter, PublisherDeps } from "../../domain/publisher.js";
-import type { BookRecord, SearchQuery } from "../../domain/book.js";
-import { fetchText, parseJapanesePrice, extractEbookStoresFromDoc } from "./base.js";
-
-const BASE_URL = "https://techbookfest.org";
-const GRAPHQL_URL = `${BASE_URL}/api/graphql`;
-const XSRF_CACHE_KEY = "techbookfest:xsrf-token";
-const XSRF_TTL_SECONDS = 3600;
-
-const DEFAULT_HEADERS = {
-  "User-Agent": "techbook-mcp/0.1.0 (+https://github.com/zonuexe/techbook-mcp; bibliographic search bot)",
-  "Accept": "application/json",
-};
-
-// node.product は ProductInfoSearchResult のインラインフラグメント経由でアクセスする
-const SEARCH_QUERY = `
-query MarketSearchQuery($query: String!, $first: Int!) {
-  searchProducts(first: $first, query: $query, orderBy: CREATED_AT_DESC) {
-    pageInfo { hasNextPage endCursor }
-    edges {
-      node {
-        ... on ProductInfoSearchResult {
-          product {
-            id
-            databaseID
-            name
-            description
-            organization { name }
-            coverImage { url }
-            ebookVariant: productVariant(kind: MARKET_EBOOK) { price }
-            firstPublishedAt
-            status
-          }
-        }
-      }
-    }
-  }
-}
-`.trim();
-
-interface TechbookfestProduct {
-  id: string;
-  databaseID: string;
-  name: string;
-  description: string | null;
-  organization: { name: string } | null;
-  coverImage: { url: string } | null;
-  ebookVariant: { price: number } | null;
-  firstPublishedAt: string | null;
-  status: string;
-}
-
-interface GraphQLResponse {
-  data?: {
-    searchProducts?: {
-      edges: Array<{ node: { product?: TechbookfestProduct } }>;
-    };
-  };
-}
-
-/**
- * トップページの Set-Cookie から XSRF-TOKEN を取得してキャッシュする。
- * 技術書典の GraphQL API は XSRF トークンを Cookie + X-XSRF-TOKEN ヘッダーの
- * ダブルサブミット方式で検証する。
- */
-async function fetchXsrfToken(deps: PublisherDeps): Promise<string> {
-  const cached = await deps.cache.get(XSRF_CACHE_KEY);
-  if (cached !== null) return cached;
-
-  const response = await deps.http.get(BASE_URL, { headers: DEFAULT_HEADERS });
-  const setCookie = response.header("set-cookie") ?? "";
-
-  // Set-Cookie: XSRF-TOKEN=<urlencoded-value>; Path=/; Secure; SameSite=Lax
-  const match = setCookie.match(/XSRF-TOKEN=([^;,\s]+)/);
-  if (!match) throw new Error("techbookfest: XSRF-TOKEN not found in Set-Cookie");
-
-  const token = decodeURIComponent(match[1]);
-  await deps.cache.set(XSRF_CACHE_KEY, token, XSRF_TTL_SECONDS);
-  return token;
-}
-
-function productToBookRecord(product: TechbookfestProduct): BookRecord {
-  const url = `${BASE_URL}/product/${product.databaseID}`;
-  const publishedAt = product.firstPublishedAt
-    ? product.firstPublishedAt.slice(0, 10)
-    : undefined;
-
-  return {
-    title: product.name,
-    authors: product.organization ? [product.organization.name] : [],
-    publisher: "技術書典",
-    url,
-    price: product.ebookVariant?.price,
-    description: product.description ?? undefined,
-    coverImageUrl: product.coverImage?.url,
-    publishedAt,
-    ebookStores: [{ name: "技術書典", url, drm: "free" }],
-  };
-}
-
-export const techbookfestAdapter: PublisherAdapter = {
-  id: "techbookfest",
-  name: "技術書典オンラインマーケット",
-  baseUrl: BASE_URL,
-
-  async search(query: SearchQuery, deps: PublisherDeps): Promise<BookRecord[]> {
-    const word = [query.title, query.author].filter(Boolean).join(" ");
-    if (!word) return [];
-
-    const limit = query.limit ?? 10;
-    const xsrf = await fetchXsrfToken(deps);
-
-    const body = JSON.stringify({
-      operationName: "MarketSearchQuery",
-      query: SEARCH_QUERY,
-      variables: { query: word, first: limit },
-    });
-
-    const response = await deps.http.post(GRAPHQL_URL, body, {
-      headers: {
-        ...DEFAULT_HEADERS,
-        "Content-Type": "application/json",
-        "Cookie": `XSRF-TOKEN=${encodeURIComponent(xsrf)}`,
-        "X-XSRF-TOKEN": xsrf,
-      },
-    });
-
-    if (response.status !== 200) {
-      throw new Error(`HTTP ${response.status}: ${GRAPHQL_URL}`);
-    }
-
-    const json = JSON.parse(await response.text()) as GraphQLResponse;
-    const edges = json.data?.searchProducts?.edges ?? [];
-
-    return edges
-      .map(e => e.node.product)
-      .filter((p): p is TechbookfestProduct => p != null)
-      .slice(0, limit)
-      .map(productToBookRecord);
-  },
-
-  async getDetail(url: string, deps: PublisherDeps): Promise<BookRecord> {
-    const html = await fetchText(url, deps);
-    const doc = deps.parser.parse(html);
-
-    const title =
-      doc.selectOne('meta[property="og:title"]')?.attr("content") ??
-      doc.selectOne("h1")?.text() ??
-      "";
-
-    const description =
-      doc.selectOne('meta[property="og:description"]')?.attr("content") ??
-      doc.selectOne('meta[name="description"]')?.attr("content") ??
-      undefined;
-
-    const coverImageUrl =
-      doc.selectOne('meta[property="og:image"]')?.attr("content") ??
-      undefined;
-
-    const priceText = doc.selectOne('[class*="price"]')?.text();
-    const price = priceText ? parseJapanesePrice(priceText) : undefined;
-
-    const ebookStores = extractEbookStoresFromDoc(doc);
-    if (!ebookStores.some(s => s.name === "技術書典")) {
-      ebookStores.unshift({ name: "技術書典", url, drm: "free" });
-    }
-
-    return {
-      title,
-      authors: [],
-      publisher: "技術書典",
-      url,
-      price,
-      description,
-      coverImageUrl,
-      ebookStores,
-    };
-  },
-};

package/src/application/get-book-detail.ts

@@ -1,24 +0,0 @@
-import type { BookRecord } from "../domain/book.js";
-import type { PublisherAdapter, PublisherDeps } from "../domain/publisher.js";
-import { checkRobotsTxt } from "../adapters/publishers/base.js";
-
-export async function getBookDetail(
-  url: string,
-  publishers: readonly PublisherAdapter[],
-  deps: PublisherDeps,
-): Promise<BookRecord> {
-  const publisher = publishers.find(p => url.startsWith(p.baseUrl));
-  if (!publisher) {
-    throw new Error(
-      `このURLに対応する出版社アダプターがありません: ${url}\n` +
-      `対応URL: ${publishers.map(p => p.baseUrl).join(", ")}`,
-    );
-  }
-
-  const allowed = await checkRobotsTxt(url, deps);
-  if (!allowed) {
-    throw new Error(`robots.txt によりアクセスが禁止されています: ${url}`);
-  }
-
-  return publisher.getDetail(url, deps);
-}

package/src/application/search-books.ts

@@ -1,44 +0,0 @@
-import type { BookRecord, SearchQuery } from "../domain/book.js";
-import type { PublisherAdapter, PublisherDeps } from "../domain/publisher.js";
-import { checkRobotsTxt } from "../adapters/publishers/base.js";
-
-export interface SearchBooksResult {
-  books: BookRecord[];
-  errors: Array<{ publisherId: string; message: string }>;
-}
-
-export async function searchBooks(
-  query: SearchQuery,
-  publishers: readonly PublisherAdapter[],
-  deps: PublisherDeps,
-): Promise<SearchBooksResult> {
-  const targets = query.publisherId
-    ? publishers.filter(p => p.id === query.publisherId)
-    : publishers;
-
-  const results = await Promise.allSettled(
-    targets.map(async (p) => {
-      const allowed = await checkRobotsTxt(p.baseUrl, deps);
-      if (!allowed) throw new Error(`robots.txt によりアクセスが禁止されています: ${p.baseUrl}`);
-      return p.search(query, deps);
-    }),
-  );
-
-  const books: BookRecord[] = [];
-  const errors: Array<{ publisherId: string; message: string }> = [];
-
-  for (let i = 0; i < results.length; i++) {
-    const result = results[i];
-    const publisher = targets[i];
-    if (result.status === "fulfilled") {
-      books.push(...result.value);
-    } else {
-      const message = result.reason instanceof Error
-        ? result.reason.message
-        : String(result.reason);
-      errors.push({ publisherId: publisher.id, message });
-    }
-  }
-
-  return { books, errors };
-}

package/src/domain/book.ts

@@ -1,35 +0,0 @@
-/**
- * - `"free"`         : 技術的DRMなし (DRM-free PDF/EPUB)
- * - `"social"`       : ソーシャルDRM (購入者情報を透かし刻印、技術的制限なし)
- * - `"password_pdf"` : パスワード認証付きPDF (標準PDFビューアで閲覧可、パスワード必須)
- * - `"drm"`          : 技術的DRM付き (専用ビューアー必須)
- */
-export type DrmType = "free" | "social" | "password_pdf" | "drm";
-
-export interface EbookStore {
-  name: string;
-  url: string;
-  drm: DrmType;
-}
-
-export interface BookRecord {
-  title: string;
-  authors: string[];
-  publisher: string;
-  publishedAt?: string;   // "YYYY-MM-DD"
-  isbn?: string;          // ISBN-13、ハイフンなし数字のみ
-  asin?: string;          // Amazon ASIN (Amazonリンクが存在する場合)
-  url: string;            // 出版社公式ページURL
-  price?: number;         // 税込価格（円）
-  coverImageUrl?: string;
-  description?: string;
-  tags?: string[];
-  ebookStores?: EbookStore[];
-}
-
-export interface SearchQuery {
-  title?: string;
-  author?: string;
-  publisherId?: string;  // 出版社IDでフィルタ (例: "gihyo", "lambdanote")
-  limit?: number;        // デフォルト: 10
-}

package/src/domain/publisher.ts

@@ -1,18 +0,0 @@
-import type { BookRecord, SearchQuery } from "./book.js";
-import type { HttpClient } from "../ports/http.js";
-import type { HtmlParser } from "../ports/html-parser.js";
-import type { CacheStore } from "../ports/cache.js";
-
-export interface PublisherDeps {
-  http: HttpClient;
-  parser: HtmlParser;
-  cache: CacheStore;
-}
-
-export interface PublisherAdapter {
-  readonly id: string;
-  readonly name: string;
-  readonly baseUrl: string;
-  search(query: SearchQuery, deps: PublisherDeps): Promise<BookRecord[]>;
-  getDetail(url: string, deps: PublisherDeps): Promise<BookRecord>;
-}

package/src/main.ts

@@ -1,14 +0,0 @@
-#!/usr/bin/env node
-import { startServer } from "./mcp/server.js";
-import { DEFAULT_PUBLISHERS } from "./adapters/publishers/registry.js";
-import { FetchHttpClient } from "./adapters/http/fetch-client.js";
-import { CheerioHtmlParser } from "./adapters/html/cheerio-parser.js";
-import { MemoryCacheStore } from "./adapters/cache/memory-cache.js";
-
-const deps = {
-  http: new FetchHttpClient(),
-  parser: new CheerioHtmlParser(),
-  cache: new MemoryCacheStore(),
-};
-
-await startServer(DEFAULT_PUBLISHERS, deps);

package/src/mcp/server.ts

@@ -1,103 +0,0 @@
-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 type { PublisherAdapter, PublisherDeps } from "../domain/publisher.js";
-import type { BookRecord, EbookStore, DrmType, SearchQuery } from "../domain/book.js";
-import { searchBooks } from "../application/search-books.js";
-import { getBookDetail } from "../application/get-book-detail.js";
-import { TOOLS } from "./tools.js";
-
-// --- 出力フォーマット ---
-
-const DRM_LABELS: Record<DrmType, string> = {
-  free:         "DRMフリー",
-  social:       "DRMフリー (ソーシャル)",
-  password_pdf: "パスワード付きPDF",
-  drm:          "DRM付き",
-};
-
-function formatEbookStore(store: EbookStore): Record<string, unknown> {
-  return { ...store, drmLabel: DRM_LABELS[store.drm] };
-}
-
-function formatBook(book: BookRecord): Record<string, unknown> {
-  if (!book.ebookStores) return book as unknown as Record<string, unknown>;
-  return { ...book, ebookStores: book.ebookStores.map(formatEbookStore) };
-}
-
-export function createServer(
-  publishers: readonly PublisherAdapter[],
-  deps: PublisherDeps,
-): Server {
-  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: SearchQuery = {
-          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: Record<string, unknown> = { 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: readonly PublisherAdapter[],
-  deps: PublisherDeps,
-): Promise<void> {
-  const server = createServer(publishers, deps);
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
-}

package/src/mcp/tools.ts

@@ -1,54 +0,0 @@
-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: {},
-    },
-  },
-] as const;

package/src/ports/cache.ts

@@ -1,5 +0,0 @@
-export interface CacheStore {
-  get(key: string): Promise<string | null>;
-  set(key: string, value: string, ttlSeconds?: number): Promise<void>;
-  delete(key: string): Promise<void>;
-}

package/src/ports/html-parser.ts

@@ -1,15 +0,0 @@
-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;
-}

package/src/ports/http.ts

@@ -1,17 +0,0 @@
-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>;
-}

package/tests/fixtures/book-tech-detail.html

@@ -1,51 +0,0 @@
-<!DOCTYPE html>
-<html lang="ja">
-<head><meta charset="utf-8"><title>BOOK TECH | 次のステップへ！React実践開発　サクサク作って学ぶ UI/テスト/デプロイ</title></head>
-<body>
-<div class="contents-base">
-  <div class="contents-book">
-    <div class="contents-book-inner">
-      <div class="contents-book-item">
-        <div class="contents-book-item-detail-wrap">
-          <div class="contents-book-item-detail-thumb">
-            <img src="https://booktech-share.s3-ap-northeast-1.amazonaws.com/books/d80ffe3d.webp" class="thumb" alt="次のステップへ！React実践開発　サクサク作って学ぶ UI/テスト/デプロイ">
-          </div>
-          <div class="contents-book-item-detail-price_include_tax">
-            2,178円<span class="tax">（税込）</span>
-          </div>
-        </div>
-      </div>
-
-      <div class="contents-book-about">
-        <div class="contents-book-about-title">
-          <h1>次のステップへ！React実践開発　サクサク作って学ぶ UI/テスト/デプロイ</h1>
-        </div>
-
-        <div class="contents-book-about-publicationdate my-1" style="font-size: 0.85em;">
-          発売日:
-          2026/2/20
-        </div>
-
-        <div class="d-flex flex-wrap align-items-center gap-1">
-          <a class="badge bg-light text-dark border" href="/books?q%5Bpublisher_relations_publisher_id_in%5D%5B%5D=4">
-            <i class="fas fa-building me-1"></i>インプレス NextPublishing
-          </a>
-          <a class="badge bg-light text-dark border" href="/books?q%5Bauthor_relations_author_id_in%5D%5B%5D=2205">
-            <i class="fas fa-user me-1"></i>philosophy (著)
-          </a>
-        </div>
-
-        <div class="contents-book-about-id" style="font-size: 0.85em;">
-          ISBN:
-          9784295604136
-        </div>
-
-        <div class="contents-book-about-description scroll">
-          TypeScriptによる型安全な開発、各種ホスティングサービスへの公開方法などを解説します。
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-</body>
-</html>

package/tests/fixtures/book-tech-search.html

@@ -1,91 +0,0 @@
-<!DOCTYPE html>
-<html lang="ja">
-<head><meta charset="utf-8"><title>BOOK TECH | 「TypeScript」の検索結果</title></head>
-<body>
-<div class="contents-base">
-  <div class="contents-index">
-    <div class="contents-index-wrap">
-
-      <div class="contents-index-item">
-        <div class="contents-index-item-lang">
-          <a class="contents-index-item-large-lang-wrap" href="/books?q%5Bbook_category_in%5D%5B%5D=%E3%82%B3%E3%83%B3%E3%83%94%E3%83%A5%E3%83%BC%E3%82%BF%E3%83%BBIT">コンピュータ・IT</a>
-        </div>
-        <div class="contents-index-item-detail-wrap">
-          <div class="contents-index-item-detail">
-            <div class="contents-index-item-detail-thumb">
-              <a class="book-ribbon-link" href="/books/d80ffe3d-f3fe-458b-95ee-b4dd3327fab2">
-                <img src="https://booktech-share.s3-ap-northeast-1.amazonaws.com/books/d80ffe3d.webp" class="thumb" alt="次のステップへ！React実践開発　サクサク作って学ぶ UI/テスト/デプロイ">
-              </a>
-            </div>
-          </div>
-          <div class="contents-index-item-detail">
-            <div class="contents-index-item-detail-title">
-              次のステップへ！React実践開発　サクサク作って学ぶ UI/テスト/デプロイ
-            </div>
-            <div class="my-1" style="font-size: 0.85em;">
-              発売日: 2026/2/20
-            </div>
-            <div class="d-none d-lg-block d-flex flex-wrap align-items-center gap-1">
-              <a class="badge bg-light text-dark border" href="/books?q%5Bpublisher_relations_publisher_id_in%5D%5B%5D=4">
-                <i class="fas fa-building me-1"></i>インプレス NextPublishing
-              </a>
-              <a class="badge bg-light text-dark border" href="/books?q%5Bauthor_relations_author_id_in%5D%5B%5D=2205">
-                <i class="fas fa-user me-1"></i>philosophy (著)
-              </a>
-            </div>
-            <div class="contents-index-item-detail-description scroll">
-              TypeScriptによる型安全な開発を解説します。
-            </div>
-            <div class="contents-index-item-detail-price_include_tax">
-              <div>
-                2,178円<span class="tax">（税込）</span>
-              </div>
-            </div>
-          </div>
-        </div>
-      </div>
-
-      <div class="contents-index-item">
-        <div class="contents-index-item-lang">
-          <a class="contents-index-item-large-lang-wrap" href="/books?q%5Bbook_category_in%5D%5B%5D=%E3%82%B3%E3%83%B3%E3%83%94%E3%83%A5%E3%83%BC%E3%82%BF%E3%83%BBIT">コンピュータ・IT</a>
-        </div>
-        <div class="contents-index-item-detail-wrap">
-          <div class="contents-index-item-detail">
-            <div class="contents-index-item-detail-thumb">
-              <a class="book-ribbon-link" href="/books/a52f6467-5d0c-4d76-9351-19a0ab76eb96">
-                <img src="https://booktech-share.s3-ap-northeast-1.amazonaws.com/books/a52f6467.webp" class="thumb" alt="React環境構築の教科書">
-              </a>
-            </div>
-          </div>
-          <div class="contents-index-item-detail">
-            <div class="contents-index-item-detail-title">
-              React環境構築の教科書
-            </div>
-            <div class="my-1" style="font-size: 0.85em;">
-              発売日: 2020/8/21
-            </div>
-            <div class="d-none d-lg-block d-flex flex-wrap align-items-center gap-1">
-              <a class="badge bg-light text-dark border" href="/books?q%5Bpublisher_relations_publisher_id_in%5D%5B%5D=4">
-                <i class="fas fa-building me-1"></i>インプレス NextPublishing
-              </a>
-              <a class="badge bg-light text-dark border" href="/books?q%5Bauthor_relations_author_id_in%5D%5B%5D=107">
-                <i class="fas fa-user me-1"></i>井手 優太 (著)
-              </a>
-            </div>
-            <div class="contents-index-item-detail-description scroll">
-              TypeScriptを使ったコンパイル環境を解説します。
-            </div>
-            <div class="contents-index-item-detail-price_include_tax">
-              <div>
-                3,300円<span class="tax">（税込）</span>
-              </div>
-            </div>
-          </div>
-        </div>
-      </div>
-
-    </div>
-  </div>
-</div>
-</body>
-</html>