30book

30book-mcp：面向 AI Agent 的 30book MCP 服务

让你的 AI Agent 搜索伊朗的 30book 书店（۳۰بوک）。
这是一个非官方、只读的 MCP 服务，适用于 30book——一家伊朗在线书店，藏有约 200,000 本纸质书： 可按书名搜索、比较不同版本和出版社，查看标价和折扣价（单位为托曼）、库存、ISBN、作者、译者、评论、畅销书和折扣信息，均可通过 Claude、Cursor 或 Copilot 获取。

面向 AI Agent · 原因 · 功能 · 快速开始 · 工具 · 工作原理 · 须知 · 常见问题 · 配置 · فارسی · 开发 · 相关服务 · 免责声明 · 许可证

面向 AI Agent

• **简介：**适用于 30book（30book.com）的非官方 MCP 服务，这是一家伊朗在线书店。搜索词使用波斯语（书名、人名）效果最佳；价格单位为托曼。
• 安装：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，或以逗号分隔的 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 为整数）。库存仅显示有或无，不显示数量。每页约有 20 本书（奖项页面约有 22 本）。
• **适用场景：**比较 30book 上伊朗及外国纸质书的版本、出版社、价格、库存或评分。
• **不适用场景：**用户想购买或下单（无购物车或结账功能）、需要运费（结账时才会报价）、想要电子书或有声书，或要查询其他书店时。
• 机器可读信息：server.json 和 iran-mcp 目录（TOOLS.md、servers.json、llms.txt）。

原因

30book 没有公开 API，其列表页面通过实时 Blazor Server 会话生成，因此普通爬虫只能获取空页面。此服务使用该协议（SignalR 长轮询，无需浏览器）并解析图书页面，让 Agent 只需几次调用即可回答“精装版《小王子》最便宜的是哪个版本”“这位译者的所有作品中，价格低于 300,000 托曼的有哪些”或“历史类畅销书有哪些”等问题。

功能

• 按书名搜索（精确短语或逐词匹配），并可按排序、库存、出版社、作者和译者筛选
• 比较版本和出版社：比较多家出版社出版的同名书籍，以及标价与实付价格
• 图书详情：价格、折扣、库存、作者、译者、出版社、页数、封面、开本、ISBN、语言、版次（印次）、年份（波斯历）、重量、分类、评分、标签、简介
• 浏览分类、小说题材、各国文学、文学奖项列表和标签
• 出版社和人物：查看某家出版社的图书目录、某位作者或译者的全部作品，以及按姓名查询 ID
• 读者评价：查看带星级的书评和评分摘要，以及相似图书
• 热门和低价图书：全站畅销书、最新图书、折扣力度最大的畅销书
• 专为只读设计：无需登录，无购物车，不下订单

示例提示词：

• “30book 上硬皮封面的《小王子》（شازده کوچولو）哪个版本最便宜？”
• “列出这位译者价格低于 300,000 Toman 的图书，并显示评分。”
• “现在最畅销的历史类图书有哪些？哪本折扣最大？”
• ارزان‌ترین چاپ رمان «صد سال تنهایی» در ۳۰بوک کدام است؟
• پرفروش‌ترین کتاب‌های روانشناسی را با قیمت و تخفیف نشان بده.
• کتاب‌های این ناشر را از ارزان به گران مرتب کن.

快速开始

你需要安装 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_。价格单位为 Toman。请在工具之间传递书籍、出版社和人物的 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 长轮询建立连接，将二进制渲染批次应用到小型 DOM 中，然后读取书籍卡片。分页、排序和筛选均通过 URL 查询参数实现，因此不会模拟点击；只有出版社和作者索引页面上的名称输入框会触发事件。
• 程序运行在你的计算机上，并直接调用 30book；中间没有托管服务。

了解事项

• 价格单位为 Toman。 HTML 中的价格单位是 Toman；书籍页面上的 JSON-LD 使用 Rial（乘以 10），且仅用于已售罄的书籍。
• price 是标价，final_price 是实际支付价格，discount_pct 为计算所得。in_stock: false 表示已售罄（显示的价格可能是最后一次记录的价格）。
• 库存状态只有有／无，绝不显示数量。
• **速度：**列表页面需要 2 到 5 秒（每个列表都会建立一个 Blazor 会话），书籍页面约需 1 秒。书籍页面会缓存 5 分钟，因此依次查询书籍、相似书籍和评论只需获取一次数据。
• **搜索依据名称片段进行。**网站存储的部分名称使用阿拉伯语字母 yeh／kaf，因此按人物或出版社查询时可能找不到；请尝试使用更短的词。
• 类别：bts-N 分区页面仅为着陆页；主题和话题代码才可用于浏览列表（参见 sb_categories）。奖项页面每页约显示 22 本书，且忽略排序设置。
• 没有价格范围筛选，也不提供结果总数；仅能获知最后一页的页码。
• 网站上的特价商品大多是文具，因此 sb_deals 使用畅销书或按折扣排序的单个主题。
• **不支持：**运费（登录后结账时显示）、电子书、有声书和购买。
• **请求频率：**最多同时发送 2 个请求，且请求间会有短暂随机延迟；超时、429 和 5xx 错误最多重试两次。请控制自身的调用频率；网站的 robots.txt 禁止爬虫访问 */search。
• 代理：SIBOOK_MCP_PROXY（参见配置）。

常见问题

npx @modelcontextprotocol/inspector uvx 30book-mcp

配置

波斯语：30بوک 图书 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，因为模块名不能以数字开头）；每个工具都是带类型标注的异步函数，并附有说明何时使用该工具的文档字符串。测试会检查本 README 中的工具表是否与服务一致。欢迎提交问题和 PR。

发布：更新 pyproject.toml 和 server.json 中的版本，然后推送一个 v* 标签。GitHub Actions 会运行测试、发布到 PyPI 和 MCP Registry，并创建 GitHub Release。

相关服务

• Taaghche MCP 服务，提供伊朗电子书和有声书
• Fidibo MCP 服务，提供波斯语电子书和有声书
• Shopino MCP 服务，另一个伊朗网上商店
• Digikala MCP 服务，伊朗最大的网上商店
• iran-mcp：伊朗各类服务的 MCP 服务目录

免责声明

这是非官方项目，与 30book 无关联，也未获其认可。它读取网站的公开页面，这些页面可能随时更改。该服务为只读，不会登录，也不会更改网站上的任何内容。请合理控制请求频率。

作者

由 Sepehr Radmard（سپهر رادمرد）开发并维护。可通过 LinkedIn 联系，或在 GitHub 上关注 @sepehr071，了解更多面向伊朗网站的 MCP 服务；所有服务均列于 iran-mcp。如果这个项目为您节省了时间，欢迎给仓库点个星，帮助其他人发现它。

许可证

MIT

如果这个项目为您省去了几次点击，欢迎点个星，帮助其他人发现它。