Fidibo

fidibo-mcp：AI エージェント向け Fidibo MCP サーバー

AI エージェントに、Fidibo（فیدیبو）でペルシャ語の電子書籍やオーディオブックを探してもらいましょう。
フィディボ向けの非公式・読み取り専用 MCP サーバーです。フィディボは Digikala グループが運営するイランの電子書籍・オーディオブックストアです。タイトルや著者名での検索、トマン建ての価格比較、無料の書籍や Fidibo Plus 対象書籍の検索、レビューの閲覧、ベストセラー、新刊、著者、出版社の閲覧ができます。
Claude、Cursor、Copilot など、あらゆる MCP クライアントで動作します。アカウントも API キーも不要です。

AI エージェント向け · 理由 · できること · クイックスタート · ツール · 仕組み · 知っておきたいこと · FAQ · 設定 · فارسی · 開発

AI エージェント向け

• 概要： 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 を使うエージェントなら、fd_search、続いて fd_book、さらに fd_reviews と、数回の呼び出しで確認できます。

できること

• タイトル、著者、キーワードで書籍やオーディオブックを検索し、価格または日付で並べ替え、価格帯、無料、Fidibo Plus で絞り込めます
• 書籍の完全な記録：価格と割引（トマン）、形式、ページ数または再生時間、ナレーター、星の分布付き評価、Plus フラグ、説明、印刷版の価格
• 読者レビュー、類似書籍、著者・翻訳者・ナレーターの書籍、出版社の書籍
• ベストセラー（週間、月間、累計）、新刊、無料書籍、任意のカテゴリー
• 読み取り専用として設計されています。ログイン、購入、ライブラリやレビューへの書き込みはありません

プロンプトの例：

• 「Fidiboで『星の王子さま』の最も安いオーディオブックを探して、Fidibo Plusで無料かどうか教えてください。」
• 「歴史カテゴリーで今月最も売れている電子書籍と価格を教えてください。」
• 「Fidiboの無料オーディオブックを表示して、最初の本のレビューを読んでください。」
• Fidiboで歴史に関する無料のオーディオブックはどれですか？
• Fidiboで今週最も売れている書籍を価格付きで一覧表示してください。
• この著者の作品は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、支払う金額であるトマン建てのfinal_price、割引がある場合のみ割引前の価格を示すprice、discount_pct、free、設定されている場合のみin_plus、rating、image、urlです。デフォルトのページサイズは書籍10冊です。

書籍を探す

書籍1冊、人々

仕組み

  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 回再試行されます。

知っておくとよいこと

• 価格の単位はトマンです。 API はトマンを返します（サイトのリアル表示はその 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 フィルター（およびその他のリストの価格範囲）は、1 回の呼び出しで最大 3 ページを確認します。範囲を狭くすると、さらにページが必要になる場合があるため、next_page を page として渡してください。fd_browse の無料および Plus フィルターはサーバー側で適用されます。
• リストの合計数には上限があります： 本のリストが報告する一致件数は最大 150 件です。fd_search の total_matches は実際の件数です。
• テキストはデフォルトで切り詰められます： レビューは 400 文字、本の説明は 1500 文字、出版社の説明は 600 文字です。全文を取得するには、fd_reviews、fd_book、fd_publisher に full_text=true を渡してください。
• 類似書籍のエンドポイントはありません： 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 にあります。それぞれ、エージェントがどのような場合に使用すべきかを説明する docstring が付いた、型指定済みの非同期関数です。Issue や PR を歓迎します。

リリースするには、pyproject.toml と server.json のバージョンを更新し、v* タグをプッシュします。GitHub Actions がテストを実行し、PyPI と MCP Registry に公開して、GitHub Release を作成します。

関連サーバー

• イランの Taaghche における電子書籍・オーディオブックの価格を確認できる Taaghche MCP サーバー
• イラン国内の書籍と海外の書籍を扱う 30book MCP サーバー
• イラン最大のオンラインストアを扱う Digikala MCP サーバー
• Shopino MCP サーバー
• iran-mcp：イランのサービス向け MCP サーバーをすべて集めたカタログ

免責事項

非公式であり、Fidibo または Digikala との提携や、両社による推奨を受けていません。fidibo.com のウェブアプリが使用するエンドポイントを通じて、公開ページのデータに読み取り専用でアクセスします。これらのエンドポイントは予告なく変更される場合があります。リクエスト頻度は適切な範囲に保ってください。

作者

Sepehr Radmard（سپهر رادمرد）が開発・保守しています。LinkedInでつながるか、GitHub の @sepehr071をフォローして、イランのウェブサイト向けの MCP サーバーをご覧ください。すべてiran-mcpに掲載されています。これが時間の節約になったら、リポジトリにスターを付けていただけると、ほかの人にも見つけてもらいやすくなります。

ライセンス

MIT

クリックの手間が省けたら、スターを付けていただけると、ほかの人にも見つけてもらいやすくなります。