Fidibo

io.github.sepehr071v0.1.1更新于 Oct 11, 2026

Unofficial read-only Fidibo: search Persian ebooks and audiobooks, compare prices, free books.

已验证STDIO仅桌面网页搜索与抓取媒体与设计

概览

AI 生成的概览

只读检索 Fidibo 的波斯语电子书与有声书目录，提供以托曼计价的价格、免费与 Plus 书目、评论和畅销榜。

功能
这个非官方只读服务器提供以 fd_ 开头的工具，用于查询伊朗电子书与有声书商店 Fidibo。它可按书名、作者或关键词搜索，支持排序以及价格、免费和 Fidibo Plus 筛选；可浏览分类、畅销榜、新书和免费书目；并返回完整记录，包括以托曼计价的价格与折扣、格式、页数或时长、朗读者、评分分布和 Plus 状态。它还能获取读者评论、某位作者或出版社的书目，并以分类畅销榜代替相似书籍。
适用场景
当助手需要查找波斯语电子书或有声书、比较价格与折扣、确认某本书是否免费或包含在 Fidibo Plus 中，或收集评论与畅销榜时，适合使用。它适用于目录调研与推荐，而非购买。
运行要求
以 PyPI 包 fidibo-mcp 通过 stdio 在本地运行，使用 uvx 启动，因此需要安装 uv。它直接访问 api.fidibo.com，需要网络连接。无需账号或 API 密钥。可选环境变量 FIDIBO_MCP_PROXY 用于设置 HTTP 代理，因为系统代理设置会被忽略。
安装前请注意
只读：不会购买或修改任何内容，也不要求任何凭据。请求会发送到 api.fidibo.com，因此查询和浏览行为对该第三方可见。该服务器为非官方项目，与 Fidibo 或 Digikala 无关联，README 也要求用户保持较低的请求频率。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Fidibo，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

fidibo-mcp

Let your AI agent search Persian ebooks and audiobooks on Fidibo, compare prices, and find free and Fidibo Plus books.

Unofficial, read-only MCP server for Fidibo, the Iranian store for ebooks and audiobooks (Digikala group). Search by title or author, see the price in Toman with discount, check whether a book is free or in the Fidibo Plus subscription, read reviews, and browse bestsellers, new releases, categories, authors and publishers, all from Claude, Cursor or Copilot. No account, no API key, nothing is bought or changed.

Quick start

You need uv.

bash
claude mcp add fidibo -- uvx fidibo-mcp

Any other MCP client: command uvx, args ["fidibo-mcp"].

What it can do

  • Search books and audiobooks by title, author or keyword; sort by price or date; filter by price range, free, Fidibo Plus
  • Full record of a book: price and discount in Toman, format, pages or duration, narrators, rating with star distribution, Plus flag, description, printed price
  • Reader reviews, similar books, an author's or publisher's books
  • Bestsellers (week, month, all time), new releases, free books, any category

Tools

All tools are read-only and start with fd_. Every book in a result is a compact card: id, title, type (ebook / audiobook / microbook ...), authors, publisher, final_price (what you pay) and price (before discount) in Toman, discount_pct, free, in_plus, rating, url.

Find books

ToolWhat it does
fd_searchSearch by title, author or keyword; kind ebook / audio; sort relevance, cheapest, most expensive, newest; price range, free and Plus filters
fd_browseList books of a category (or everything) by bestseller, popular, newest or price; free / Plus / price filters
fd_bestsellersTop sellers of the week, month or all time, per kind and category
fd_newNewest books and audiobooks
fd_freeFree ebooks and audiobooks
fd_categoriesCategory and sub-category slugs of a top level (ebooks, audiobooks, education, magazines, podcasts)

One book, people

ToolWhat it does
fd_bookFull record: price, discount, pages or duration, size, narrators, rating distribution, Plus flag, description, printed price
fd_reviewsReader reviews with stars, date and likes
fd_similarBestsellers of the book's category (Fidibo has no similar-books endpoint)
fd_authorAn author's, translator's or narrator's profile and books (by id or name)
fd_publisherA publisher's profile and books (by id or name)

Good to know

  • Prices are Toman. The API returns Toman (checked against the site); final_price is the price to pay after a campaign discount, price is before it. Free books have price 0.
  • in_plus means the book is in the Fidibo Plus subscription catalog; it still has a normal buy price.
  • Price range, free and Plus filters of fd_search are applied after fetching (up to 3 pages per call); use next_page to continue. fd_browse filters free and Plus on the server and the price range after fetching.
  • Fidibo lists are capped: the book list reports at most 150 matches, fd_search total_matches is the real count.
  • Persian queries work best.

Configuration

The server calls api.fidibo.com directly and ignores system proxy variables. To use a proxy set FIDIBO_MCP_PROXY=http://host:port.

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 fixturesuv run pytest -m live -q    # real API, one test per tool

The API map this server is built on lives next to it in ../fidibo/.

Disclaimer

Unofficial; not affiliated with Fidibo or Digikala. Read-only access to the data of public pages. Keep request rates low.

License

MIT

来源：README.md，提交 b2177d2

工具

0
工具元数据尚未被收录。

版本历史

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