30book

30book-mcp：AI エージェント向け 30book MCP サーバー

AI エージェントでイランの30book書店（۳۰بوک）を検索できます。
30book向けの非公式な読み取り専用 MCP サーバーです。30bookは約20万冊の印刷書籍を扱うイランのオンライン書店です。 Claude、Cursor、Copilotから、タイトルで検索したり、版や出版社を比較したり、定価や割引価格（トマン）、在庫、ISBN、著者、翻訳者、レビュー、ベストセラー、割引情報を確認したりできます。

AI エージェント向け · 理由 · できること · クイックスタート · ツール · 仕組み · 知っておくとよいこと · FAQ · 設定 · فارسی · 開発 · 関連サーバー · 免責事項 · ライセンス

AI エージェント向け

• 概要： 30book（30book.com）向けの非公式 MCP サーバーです。30bookはイランのオンライン書店です。検索語にはペルシア語（タイトル、名前）が最適です。価格の単位はトマンです。
• インストール： uvx 30book-mcp または claude mcp add 30book -- uvx 30book-mcp を実行します。トランスポート：stdio。uv（Python 3.10以降）が必要です。または、pip install 30book-mcp を実行します。
• 認証： 不要です。API キーやアカウントは必要ありません。任意で SIBOOK_MCP_PROXY（30book.comへのリクエストに使うHTTPプロキシURL、またはカンマ区切りのリスト）を設定できます。
• アクセス： 読み取り専用です。ログインは行わず、カート、チェックアウト、ウィッシュリスト、レビュー投稿のツールもないため、ツールの呼び出し前に確認する必要はありません。
• ツール： 14個あり、すべて sb_ が接頭辞です。まず sb_search、sb_book、sb_bestsellers、sb_deals、sb_browse を使ってください。 一般的な手順：sb_search -> sb_book -> sb_similar または sb_reviews。人物や出版社を調べる場合は、sb_find_person / sb_find_publisher -> sb_author / sb_publisher の順に使います。
• 単位： 価格の単位はトマンです（price は定価、final_price は支払額、discount_pct は整数の割引率）。在庫は有無のみで、数量は表示されません。1ページあたり約20冊です（受賞作品のページは約22冊）。
• 利用する場面： 30bookで扱うイランや海外の印刷書籍について、版、出版社、価格、在庫、評価を比較する場合。
• 利用しない場面： ユーザーが購入や注文を希望する場合（カートやチェックアウト機能はありません）、送料を知りたい場合（送料はチェックアウト時に表示されます）、電子書籍やオーディオブックを探す場合、または他の書店を探す場合。
• 機械可読情報： server.json と iran-mcpカタログ（TOOLS.md、servers.json、llms.txt）。

理由

30bookには公開APIがなく、一覧ページはライブのBlazor Serverセッションで描画されるため、通常のスクレイパーでは空のページしか取得できません。このサーバーはブラウザーを使わずにそのプロトコル（SignalRのロングポーリング）で通信し、書籍ページを解析するため、エージェントは数回の呼び出しで「ハードカバー版の『星の王子さま』の最安値の版は？」「この翻訳者の作品で30万トマン未満のものをすべて教えて」「歴史分野のベストセラーは？」といった質問に回答できます。

できること

• タイトルで書籍を検索（完全一致または単語ごとに検索）。並べ替え、在庫状況、出版社、著者、翻訳者で絞り込めます
• 版と出版社を比較：複数の出版社から出ている同じタイトルについて、定価と支払価格を一覧表示します
• 書籍の詳細：価格、割引、在庫、著者、翻訳者、出版社、ページ数、表紙、サイズ、ISBN、言語、版（刷数）、出版年（ヒジュラ太陽暦）、重量、カテゴリ、評価、タグ、説明
• 閲覧：カテゴリ、フィクションのジャンル、各国文学、文学賞のリスト、タグ
• 出版社と人物：出版社ごとの書籍一覧、著者または翻訳者の全著作、名前からIDを検索
• 読者の評価：星評価と評価の概要を含むレビュー、類似書籍
• 人気作品と格安書籍：サイト全体のベストセラー、新刊、割引率の高いベストセラー
• 読み取り専用の設計：ログイン、カート、注文には対応していません

プロンプトの例：

• 「30bookで、ハードカバーの『星の王子さま』（شازده کوچولو）の最安の版はどれですか？」
• 「この翻訳者の本のうち、300,000トマン未満のものを評価とともに一覧表示してください。」
• 「現在の歴史ジャンルのベストセラーは何ですか？また、最も割引率が高いのはどれですか？」
• ارزان‌ترین چاپ رمان «صد سال تنهایی» در ۳۰بوک کدام است؟
• پرفروش‌ترین کتاب‌های روانشناسی را با قیمت و تخفیف نشان بده.
• کتاب‌های این ناشر را از ارزان به گران مرتب کن.

クイックスタート

uv が必要です。API キーやアカウントは不要です。

claude mcp add 30book -- uvx 30book-mcp

{
  "mcpServers": {
    "30book": { "command": "uvx", "args": ["30book-mcp"] }
  }
}

{
  "servers": {
    "30book": { "type": "stdio", "command": "uvx", "args": ["30book-mcp"] }
  }
}

codex mcp add 30book -- uvx 30book-mcp

[mcp_servers.30book]
command = "uvx"
args = ["30book-mcp"]

{
  "mcpServers": {
    "30book": { "command": "uvx", "args": ["30book-mcp"] }
  }
}

プロキシ経由で接続する場合は、SIBOOK_MCP_PROXY=http://host:port を設定してください（システムのプロキシ環境変数は意図的に無視されます）。

ツール

14 個のツールはすべて読み取り専用で、sb_ が接頭辞として付いています。ツール間で書籍、出版社、人物の ID を渡します。価格の単位はトマンです。

すべてのツールには readOnlyHint: true の注釈が付いており、コンパクトな JSON を返します。

仕組み

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  30book-mcp  (runs on your machine)
      │
      │  HTTPS (Chrome TLS/HTTP2 fingerprint) + SignalR long polling
      └──────▶  30book.com   book pages, Blazor-drawn list pages

• 書籍ページ、ホームページ、ランディングページは、サーバー側でレンダリングされたプレーンな HTML で、直接解析されます。
• 検索、カテゴリー、出版社、著者、ジャンル、タグの各ページは、読み込み後に Blazor Server のサーキットによって構築されます。SignalR のロングポーリングでサーキットを 1 つ開き、バイナリーのレンダリングバッチを小さな DOM に適用して、カードを読み取ります。ページ送り、並べ替え、フィルターは URL のクエリパラメーターで指定されるため、クリック操作はシミュレートしません。イベントを発火させるのは、出版社と著者のインデックスページにある名前入力欄だけです。
• ご利用のマシン上で動作し、30book に直接アクセスします。間にホスト型サーバーはありません。

知っておくと便利なこと

• 価格の単位はトマンです。 HTML の価格はトマンです。書籍ページの JSON-LD はリアル（10 倍）ですが、在庫切れの書籍にのみ使用されます。
• price は定価、final_price は支払額で、discount_pct は計算値です。in_stock: false は在庫切れを意味します（価格は最後に確認された価格である可能性があります）。
• 在庫状況はあり／なしのみで、数量は表示されません。
• **速度：**一覧ページは 2～5 秒かかります（一覧ごとに Blazor セッションを開きます）。書籍ページは約 1 秒です。書籍ページは 5 分間キャッシュされるため、書籍 -> 類似書籍 -> レビューは 1 回の取得で済みます。
• **検索は名前の一部に基づいています。**サイトでは一部の名前にアラビア文字の yeh／kaf が使われているため、人物や出版社の検索に失敗することがあります。その場合は、より短い単語を試してください。
• カテゴリー：bts-N セクションページはランディングページのみです。主題とトピックのコードでは一覧を利用できます（sb_categories を参照）。文学賞のページは 1 ページあたり約 22 冊を表示し、並べ替えは適用されません。
• **価格帯フィルターと検索結果件数はありません。**最後のページ番号のみ確認できます。
• サイトの特別セールは主に文房具が対象のため、sb_deals はベストセラー、または割引率順に並べ替えた 1 つの主題を使用します。
• **対象外：**送料（ログイン後、購入手続き時に表示）、電子書籍、オーディオブック、購入。
• **リクエスト頻度：**同時リクエストは最大 2 件で、短いランダムな遅延を挟みます。タイムアウト、429、5xx は最大 2 回再試行します。ご自身の呼び出し頻度も低く抑えてください。サイトの robots.txt では、クローラーによる */search へのアクセスが禁止されています。
• プロキシ：SIBOOK_MCP_PROXY（設定を参照）。

よくある質問

npx @modelcontextprotocol/inspector uvx 30book-mcp

設定

ペルシャ語：۳۰بوک 書籍 MCP サーバー

claude mcp add 30book -- uvx 30book-mcp

開発

git clone https://github.com/sepehr071/30book-mcp && cd 30book-mcp
uv sync
uv run ruff check . && uv run ruff format --check .
uv run python -m pytest -q            # offline, recorded pages
uv run python -m pytest -m live -q    # real site, one test per tool

ツールは src/sibook_mcp/catalog.py と product.py にあります（Python パッケージ名は sibook_mcp です。モジュール名を数字で始めることはできないためです）。各ツールは、エージェントが使用するタイミングを説明する docstring を備えた、型付きの非同期関数です。この README のツール一覧がサーバーと一致していることを確認するテストがあります。Issue や PR を歓迎します。

リリース：pyproject.toml と server.json のバージョンを更新し、v* タグをプッシュします。GitHub Actions がテストを実行し、PyPI と MCP Registry に公開して、GitHub Release を作成します。

関連サーバー

• イランの電子書籍やオーディオブック向けの Taaghche MCP server
• ペルシャ語の電子書籍やオーディオブック向けの Fidibo MCP server
• 別のイランのオンラインショップ向けの Shopino MCP server
• イラン最大のオンラインストア向けの Digikala MCP server
• iran-mcp：イランのサービス向け MCP サーバーのカタログ

免責事項

非公式のプロジェクトであり、30book とは提携しておらず、同社から承認を受けていません。サイトの公開ページを読み取りますが、予告なく変更される場合があります。読み取り専用で、ログインしたり、サイト上の情報を変更したりすることはありません。リクエスト頻度は適切な範囲に抑えてください。

作者

Sepehr Radmard（سپهر رادمرد）が開発・保守しています。LinkedIn でつながるか、GitHub の @sepehr071 をフォローして、イランのウェブサイト向け MCP サーバーをご覧ください。すべて iran-mcp に掲載されています。このプロジェクトが役に立ったら、リポジトリにスターを付けていただけると、ほかの人にも見つけてもらいやすくなります。

ライセンス

MIT

クリックの手間が省けたら、スターを付けていただけると、ほかの人にも見つけてもらいやすくなります。