Taaghche

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

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

VerifiedSTDIODesktop onlyWeb Search & ScrapingMedia & Design

Overview

AI-generated overview

Lets an assistant search the Taaghche store for Persian ebooks and audiobooks, compare prices and formats, and read reviews.

What it does
An unofficial, read-only server exposing 12 tools over the public Taaghche JSON endpoints. It searches by title, author or topic with format, sort and price filters, and returns book details such as price, discount, pages or listening time, publisher, translator, narrator, rating breakdown and ISBN. It also reads reader reviews, similar books, author and publisher profiles, category trees, bestsellers, new releases and free books.
When to use it
Use it when an assistant needs to look up Persian-language books or audiobooks: checking whether a title exists in audio, comparing editions and prices in Toman, browsing bestsellers or free titles, or summarizing reader reviews. Persian queries match best.
Requirements
Runs locally as a stdio process, started with uvx (needs uv installed) or configured in an MCP client. No API key or account. Network access to taaghche.com endpoints is required; an optional TAAGHCHE_MCP_PROXY variable sets an HTTP proxy, and system proxy settings are ignored.
Before you install
Read-only, with no account or credentials requested. The optional TAAGHCHE_MCP_PROXY value may embed a username and password in the URL, so treat it as a secret. Requests go directly to third-party Taaghche endpoints, and prices are informational, not a purchase flow.

Installation

In SourceWeft

  1. Open Taaghche 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

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

Source: README.md at commit c4d0d74

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v0.1.0LatestOct 11, 2026