Fidibo

fidibo-mcp：面向 AI Agent 的 Fidibo MCP 服务

让你的 AI Agent 在 Fidibo（فیدیبو）上选购波斯语电子书和有声书。
这是一个非官方的只读 MCP 服务，适用于 Fidibo，这家伊朗电子书和有声书商店隶属于 Digikala 集团。你可以按书名或作者搜索、比较以托曼计价的价格、查找免费书籍和 Fidibo Plus 书籍、阅读评论，以及浏览畅销书、新书、作者和出版社。
适用于 Claude、Cursor、Copilot 和任何其他 MCP 客户端。无需账户或 API 密钥。

面向 AI Agent · 为什么 · 功能 · 快速开始 · 工具 · 工作原理 · 须知 · 常见问题 · 配置 · فارسی · 开发

面向 AI Agent

• 简介： Fidibo（فیدیبو，fidibo.com）的非官方 MCP 服务。Fidibo 是一家伊朗商店，提供电子书、有声书、微型书籍和杂志。使用波斯语查询效果最佳；价格以托曼计价。
• 安装： uvx fidibo-mcp 或 claude mcp add fidibo -- uvx fidibo-mcp。传输方式：stdio。需要 uv（Python 3.10+）。
• 身份验证： 无需 API 密钥或账户。可选配置 FIDIBO_MCP_PROXY（HTTP 代理，或以逗号分隔的代理列表）。
• 访问权限： 只读。它无法登录、购买、添加到书库、评分或发表评论，因此调用任何工具前都无需确认。
• 工具： 共 11 个，名称均以 fd_ 开头。可从 fd_search、fd_book、fd_bestsellers、fd_free、fd_browse 开始。 典型调用顺序：fd_search -> fd_book -> fd_reviews；使用 fd_categories -> fd_browse 列出某个分类。
• 计价单位： 价格以托曼计价（final_price 是顾客实际支付的金额；price 是折扣前价格，仅在有折扣时显示）。评分为 0-5 星，评论星级为 1-5 星。
• 适用场景： 用户想在 Fidibo 查找波斯语或翻译版电子书或有声书、比较价格和折扣、查看免费书籍或 Fidibo Plus 书籍、阅读评论，或列出畅销书和新书。
• 不适用场景： 用户想购买或阅读书籍，或需要查看自己的书库、订单或订阅状态。
• 输出： 简洁的 JSON 书籍卡片。在不同工具之间传递书籍 id，并将 next_page 作为 page 参数传回以继续获取列表。
• 机器可读信息： server.json 和 iran-mcp 目录（TOOLS.md、servers.json、llms.txt）。

为什么

Fidibo 会以电子书、有声书，有时也以微型书籍的形式销售同一本书，并提供促销折扣、免费专区，以及独立的 Fidibo Plus 订阅目录。要回答“这本有声书免费吗？或者至少在打折吗？质量怎么样？”需要打开多个页面。使用 fidibo-mcp 的 Agent 只需调用几次工具即可完成：先调用 fd_search，再调用 fd_book，最后调用 fd_reviews。

功能

• 按书名、作者或关键词搜索图书和有声书；按价格或日期排序；按价格范围、免费和 Fidibo Plus 筛选
• 图书完整记录：价格和折扣（以 Toman 计）、格式、页数或时长、朗读者、星级分布评分、Plus 标记、简介、印刷版价格
• 读者评论、相似图书、作者、译者或朗读者的作品、出版社的图书
• 畅销书（周榜、月榜、总榜）、新书、免费图书、任意类别
• 设计为只读：无需登录、不支持购买、不支持写入书库或评论

示例提示词：

• “在 Fidibo 上查找《小王子》最便宜的有声书，并告诉我 Fidibo Plus 是否可以免费收听。”
• “本月历史类别的畅销电子书有哪些？价格是多少？”
• “展示 Fidibo 上的免费有声书，并朗读第一本的评论。”
• کتاب‌های صوتی رایگان فیدیبو درباره تاریخ کدامند؟
• پرفروش‌ترین کتاب‌های این هفته در فیدیبو را با قیمت فهرست کن.
• آثار این نویسنده در فیدیبو چه قیمتی دارند و کدام تخفیف دارند؟

快速开始

你需要 uv。无需 API 密钥或账户。

claude mcp add fidibo -- uvx fidibo-mcp

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

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

codex mcp add fidibo -- uvx fidibo-mcp

[mcp_servers.fidibo]
command = "uvx"
args = ["fidibo-mcp"]

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

工具

全部 11 个工具均为只读（标注为 readOnlyHint: true），且名称均以 fd_ 开头。结果中的每本书都以精简卡片呈现：id、title、type（ebook / audiobook / microbook / micro_audiobook / magazine）、authors、publisher、以 Toman 计的 final_price（实付价格）、price（折扣前价格，仅在有折扣时显示）、discount_pct、free、in_plus（这些字段仅在有值时显示）、rating、image、url。默认每页显示 10 本书。

查找图书

单本图书与相关人员

工作原理

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  fidibo-mcp  (runs on your machine)
      │
      │  HTTPS
      └──────▶  api.fidibo.com   books, prices, reviews, authors, publishers

fidibo-mcp 在本地运行，并调用 fidibo.com 网站使用的同一 JSON API。中间没有托管服务，也不需要 API 密钥。请求会伪装成 Chrome（TLS、HTTP/2 和标头），最多同时发送 2 个请求，并加入短暂的随机延迟；超时、连接中断以及 429/5xx 响应最多会在退避后重试 2 次。

注意事项

• 价格单位为 Toman。 API 返回 Toman（网站显示的 Rial 价格是其 10 倍）；不会进行换算。final_price 是活动折扣后的应付价格，price 是折扣前价格（仅在有折扣时提供）。免费图书的价格为 0，且 free: true。
• 缺失的标记表示 false 或 0： free、in_plus、discount_pct、ratings_count。available 仅在值为 false 时出现。无人投票时不会提供 rating。
• in_plus 表示该图书在 Fidibo Plus 订阅目录中；该图书仍有正常售价。
• 筛选在获取数据后应用。 fd_search 的价格范围、免费和 Plus 筛选条件（以及其他列表的价格范围）每次调用最多检查 3 页；筛选范围较窄时可能需要更多页面，因此请将 next_page 作为 page 传回。fd_browse 会在服务端筛选免费和 Plus 图书。
• 列表总数有上限： 图书列表最多报告 150 条匹配结果；fd_search 的 total_matches 则是真实数量。
• 文本默认会截断： 评论截断至 400 个字符，图书简介截断至 1500 个字符，出版商简介截断至 600 个字符。将 full_text=true 传给 fd_reviews、fd_book 或 fd_publisher 可获取完整文本。
• 没有相似图书端点： fd_similar 会返回该图书所属类别的畅销书。
• 使用波斯语查询效果最佳（شازده کوچولو）。
• 不支持的操作： 登录、购买或阅读图书，以及访问或管理书库、书架、收藏、评论、评分或 Fidibo Plus 订阅。
• 评论、简介和名称文本来自网站，会作为数据而非指令处理。
• 代理： FIDIBO_MCP_PROXY（参见配置）。系统代理变量会被有意忽略。

常见问题

npx @modelcontextprotocol/inspector uvx fidibo-mcp

配置

波斯语：Fidibo MCP 服务

claude mcp add fidibo -- uvx fidibo-mcp

开发

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

工具位于 src/fidibo_mcp/books.py、detail.py 和 people.py 中。每个工具都是带类型标注的异步函数，并附有说明其适用时机的文档字符串。欢迎提交问题和 PR。

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

相关服务

• Taaghche MCP server，用于查询 Taaghche 上伊朗电子书和有声书的价格
• 30book MCP server，用于查询伊朗和外国纸质书
• Digikala MCP server，用于查询伊朗最大的在线商店
• Shopino MCP server
• iran-mcp：伊朗各类服务 MCP 服务的目录

免责声明

本项目为非官方项目，与 Fidibo 或 Digikala 没有关联，也未获得其认可。项目只读访问公开页面的数据，并通过 fidibo.com 网页应用使用的接口获取数据；这些接口可能随时变更，恕不另行通知。请合理控制请求频率。

作者

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

许可证

MIT

如果这为您省去了几次点击，欢迎点星，帮助更多人发现它。