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