Fidibo

io.github.sepehr071v0.1.1Updated Oct 11, 2026

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

VerifiedSTDIODesktop onlyWeb Search & ScrapingMedia & Design

Overview

AI-generated overview

Read-only search of Fidibo's Persian ebook and audiobook catalog, with prices in Toman, free and Plus titles, reviews, and bestsellers.

What it does
This unofficial, read-only server exposes tools prefixed fd_ for querying Fidibo, the Iranian ebook and audiobook store. It searches by title, author or keyword with sorting and price, free and Fidibo Plus filters; browses categories, bestsellers, new releases and free titles; and returns full records with price and discount in Toman, format, pages or duration, narrators, rating distribution and Plus status. It also fetches reader reviews, an author's or publisher's books, and category bestsellers in place of similar books.
When to use it
Use it when an assistant needs to look up Persian-language ebooks or audiobooks, compare prices and discounts, check whether a title is free or included in Fidibo Plus, or gather reviews and bestseller lists. It suits catalog research and recommendations rather than purchasing.
Requirements
Runs locally over stdio as the PyPI package fidibo-mcp, launched with uvx, so uv must be installed. It calls api.fidibo.com directly and needs network access. No account or API key is required. An optional FIDIBO_MCP_PROXY environment variable sets an HTTP proxy, since system proxy settings are ignored.
Before you install
Read-only: nothing is bought or changed, and no credentials are requested. Requests go to api.fidibo.com, so queries and browsing activity are visible to that third party. The server is unofficial and unaffiliated with Fidibo or Digikala, and the README asks users to keep request rates low.

Installation

In SourceWeft

  1. Open Fidibo in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

Source: README.md at commit b2177d2

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v0.1.1LatestOct 11, 2026