30book

io.github.sepehr071v0.1.0更新於 Oct 11, 2026

Unofficial read-only 30book: search Iranian printed books, compare editions and prices.

已驗證STDIO僅桌面網頁搜尋與抓取商業與電商

概覽

AI 產生的概覽

唯讀查詢伊朗 30book 書店，取得書籍資訊、版本、托曼價格、庫存與評論。

功能
提供以 sb_ 為前綴的唯讀工具，用來查詢 30book 書店：可用關鍵字搜尋並排序、篩選，也能依分類、類型、獎項或標籤瀏覽，並依出版社、作者或譯者查找。回傳書籍資訊，例如價格與折扣、庫存、頁數、封面、ISBN、印量、評分與簡介，以及相似書籍和讀者評論。也會列出暢銷書、新書與特價書。
適用情境
適合需要查找或比較 30book 上波斯語或外文紙本書的情況，例如某本書最便宜的精裝版本、某位譯者的全部作品，或目前的暢銷書與優惠。它只是唯讀的目錄查詢，無法下單購物。
執行需求
透過 stdio 在本機執行，使用 uvx 從 PyPI 套件 30book-mcp 啟動，因此需要 uv 執行環境。不需要帳號、API 金鑰或登入。需要連線至 30book.com；若在代理之後，請設定 SIBOOK_MCP_PROXY 環境變數，因為系統代理設定會被忽略。
安裝前請注意
唯讀：不會登入，也不會呼叫購物車、結帳、願望清單或評論端點，因此無法購買或修改任何內容。請求會送往第三方網站 30book.com，此專案為非官方，並建議維持較低的請求頻率。選用的 SIBOOK_MCP_PROXY 變數可能包含代理憑證，應視為機密。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 30book，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

30book-mcp

Let your AI agent search Iran's 30book bookstore. Unofficial, read-only MCP server for 30book (about 200,000 printed books, Persian and foreign): search by title, compare editions and publishers, see list and discounted price in Toman, stock, pages, cover type, ISBN, print run, authors, translators, reviews, best sellers and discounts. No account, no API key, no login, no cart.

Quick start · Tools · How it works · FAQ · فارسی

Why

30book has no public API and its list pages are drawn by a live Blazor Server session, so a plain scraper sees empty pages. This server speaks that protocol (SignalR long polling, no browser needed) and parses the book pages, so an agent can answer "cheapest edition of Little Prince with a hard cover", "everything by this translator under 300,000 Toman" or "what are the best sellers in history" in a few calls.

Quick start

You need uv.

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

Other clients (Claude Desktop, Cursor, VS Code): run the command uvx with argument 30book-mcp. Behind a proxy, set SIBOOK_MCP_PROXY=http://host:port (system proxy variables are ignored on purpose).

Tools

All tools are read-only and prefixed sb_. Prices are Toman.

Find books

ToolWhat it does
sb_searchSearch by title (exact phrase or word by word) with sort, in-stock, publisher, author and translator filters; 20 per page
sb_browseBooks of a category (section, subject, topic), fiction genre, national literature, literary award or tag
sb_publisherOne publisher's catalogue with a short description
sb_authorEverything by one author or translator
sb_find_publisherPublisher name to id
sb_find_personAuthor / translator name to id
sb_categoriesCategory sections and their subjects (codes for sb_browse)
sb_collectionsGenres, national literatures, award lists and current tags

One book

ToolWhat it does
sb_bookPrice, final price, discount %, stock, authors, translators, publisher, pages, cover, size, ISBN, print run, year, categories, rating, description
sb_similarSimilar books, more by the author, more by the translator
sb_reviewsReader comments with stars, plus the rating summary

Popular and cheap

ToolWhat it does
sb_bestsellersSite-wide best sellers
sb_new_releasesNewest books
sb_dealsThe discounted-books page, biggest discount first on request

How it works

  • Book pages, the home page and landing pages are plain server-rendered HTML and are parsed directly.
  • Search, category, publisher, author, genre and tag pages are built after load by a Blazor Server circuit. The server opens one over SignalR long polling, applies the binary render batches to a small DOM (blazor.py) and reads the cards. Paging, sort and filters are URL query parameters (pg, sort, qt, pub, wtr, inp, stp), so no clicks are simulated; only the name boxes on the publisher and author index pages use a fired event.
  • HTML prices are Toman; the JSON-LD on book pages is Rial (x10) and is only used for sold-out books.
  • List pages take 2 to 5 seconds, book pages about 1 second. Stock is yes/no only.

Development

bash
export HTTPS_PROXY=http://127.0.0.1:10898 HTTP_PROXY=http://127.0.0.1:10898   # uv downloads onlyuv syncuv run ruff check . && uv run ruff format --check .uv run pytest -q            # offline, recorded pagesuv run pytest -m live -q    # real site, one test per tool

API map and test report: ../30book/.

FAQ

Does it buy anything? No. It never logs in and never calls cart, checkout, wishlist or review endpoints.

Why is a search sometimes empty? The site stores some names with Arabic yeh / kaf; try a shorter word or extended=true.

Is it affiliated with 30book? No. Unofficial; keep the request rate low.

فارسی

سرور MCP غیررسمی و فقط‌خواندنی برای فروشگاه کتاب ۳۰بوک: جستجوی کتاب، مقایسهٔ چاپ‌ها و ناشران، قیمت (تومان) و تخفیف، موجودی، مشخصات کتاب، نویسنده و مترجم، نظرات، پرفروش‌ها و تخفیف‌ها. نیازی به حساب یا کلید ندارد.

نصب: claude mcp add 30book -- uvx 30book-mcp

來源：README.md，提交 31817e9

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v0.1.0最新Oct 11, 2026