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