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