Taaghche

io.github.sepehr071v0.1.0更新於 Oct 11, 2026

Unofficial read-only Taaghche: search Persian ebooks and audiobooks, compare prices, read reviews.

已驗證STDIO僅桌面網頁搜尋與抓取媒體與設計

概覽

AI 產生的概覽

讓助理在 Taaghche 商店搜尋波斯語電子書與有聲書、比較價格與格式，並查看讀者評論。

功能
這是一個非官方、唯讀的伺服器，透過 Taaghche 公開的 JSON 端點提供 12 個工具。可依書名、作者或主題搜尋，並支援格式、排序與價格篩選，回傳價格、折扣、頁數或收聽時長、出版社、譯者、朗讀者、評分分布與 ISBN 等資訊。也能讀取讀者評論、相似書籍、作者與出版社資料、分類樹、暢銷榜、新書與免費書籍。
適用情境
當助理需要查詢波斯語圖書或有聲書時使用：確認某本書是否有有聲版、比較版本與以托曼計價的價格、瀏覽暢銷或免費書目，或整理讀者評論。波斯語查詢效果最好。
執行需求
以 stdio 在本機執行，使用 uvx 啟動（需安裝 uv）或在 MCP 用戶端中設定。不需要 API 金鑰或帳號。需要連線至 taaghche.com 的網路端點；可選變數 TAAGHCHE_MCP_PROXY 可設定 HTTP 代理，系統代理設定會被忽略。
安裝前請注意
唯讀，不要求帳號或憑證。可選的 TAAGHCHE_MCP_PROXY 值可能在 URL 中帶有使用者名稱與密碼，應視為機密。請求直接送往第三方 Taaghche 端點，價格僅供參考，不涉及購買流程。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Taaghche，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

taaghche-mcp

Let your AI agent search Taaghche, the Iranian ebook and audiobook store: compare prices and formats, read reviews, browse bestsellers, new and free books.

Unofficial and read-only. Covers about 220,000 Persian and translated ebooks and audiobooks on taaghche.com, prices in Toman. No API key, no account.

Quick start

You need uv.

bash
claude mcp add taaghche -- uvx taaghche-mcp

Any other MCP client (Claude Desktop, Cursor, VS Code): run uvx taaghche-mcp as a stdio server, e.g.

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

Then ask, for example:

  • "Is there an audiobook of شازده کوچولو, and which edition is the cheapest?"
  • "Free audiobooks about history, most downloaded first."
  • "What do readers say about book 6426? Show the most liked reviews."
  • پرفروش‌ترین کتاب‌های روان‌شناسی زیر ۱۰۰ هزار تومان کدامند؟

How it works

taaghche-mcp runs locally and calls the same public JSON endpoints the taaghche.com website uses (get.taaghche.com for books, reviews, lists and search, explore.taaghche.com for suggestions; the category menu is read from the home page). No hosted server in between. API map and quirks: ../taaghche/.

Tools

All 12 tools are annotated readOnlyHint: true and return compact structured JSON.

Find and read a book

ToolWhat it does
tg_searchSearch by title, author or topic; format ebook / audiobook; sort (relevance, bestselling, cheapest, newest, ...); discounted, free, subscription, price range
tg_suggestTypeahead: matching titles with their publisher
tg_bookPrice and discount, format, pages or listening time, publisher, translator, narrator, rating breakdown, review count, categories, ISBN, availability
tg_reviewsReader reviews (most liked first) with stars and likes; replies to one review
tg_similarSimilar books, other books of the same author and publisher

Browse

ToolWhat it does
tg_categoriesThe category tree for ebooks and audiobooks with ids and slugs
tg_browseA category or the whole catalog: format, sort, price ceiling, discounted, free; 16 per page
tg_bestsellersThe hottest books («داغ‌ترین»), overall or per category and format
tg_new_releasesNewest books, overall or per category and format
tg_free_booksFree books and audiobooks, most downloaded first
tg_authorAn author's profile (nationality, life dates, biography) and books
tg_publisherA publisher's description and books

Good to know

  • Prices are in Toman. The API returns Toman (book 6426 is 58500 in the API and ۵۸,۵۰۰ تومان on the page). final_price is what you pay, price is before discount, discount_pct a whole percent, free is true for 0.
  • The site cannot filter by price, so the price range is applied here. tg_search applies min_price, max_price and free_only to the results it scans (up to 5 pages of 12); the browse tools, tg_author and tg_publisher do the same with max_price (up to 5 pages of 16). scanned tells how many books were looked at; with sort="cheapest" the ceiling is exact and the scan stops early. Only free and discounted lists are filtered by the site.
  • Paging: tg_search returns 12 books per page, the browse tools and tg_author / tg_publisher 16. Pass next_cursor back as cursor with the same other arguments.
  • «Bestsellers» is the site's «hot» ranking. Taaghche publishes no sales numbers; for the true best-selling order of a keyword use tg_search(sort="bestselling").
  • Binahayat (بی‌نهایت) subscription: in_subscription marks books included in it; the price is for buying the book permanently.
  • Dates ending _fa are Persian (Jalali).
  • Persian queries match best.

Configuration

VariableDefaultMeaning
TAAGHCHE_MCP_PROXYunsetHTTP proxy for every request, e.g. http://user:pass@host:port (system proxy variables are ignored)

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, on recorded fixturesuv run pytest -m live -q    # real API

License

MIT

來源：README.md，提交 c4d0d74

工具

0
工具後設資料尚未被收錄。

版本歷史

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