iranketab-mcp 0.1.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- iranketab_mcp-0.1.0/.github/workflows/ci.yml +22 -0
- iranketab_mcp-0.1.0/.github/workflows/publish.yml +51 -0
- iranketab_mcp-0.1.0/.gitignore +6 -0
- iranketab_mcp-0.1.0/LICENSE +21 -0
- iranketab_mcp-0.1.0/PKG-INFO +302 -0
- iranketab_mcp-0.1.0/README.md +274 -0
- iranketab_mcp-0.1.0/pyproject.toml +56 -0
- iranketab_mcp-0.1.0/server.json +32 -0
- iranketab_mcp-0.1.0/src/iranketab_mcp/__init__.py +5 -0
- iranketab_mcp-0.1.0/src/iranketab_mcp/books.py +508 -0
- iranketab_mcp-0.1.0/src/iranketab_mcp/discover.py +249 -0
- iranketab_mcp-0.1.0/src/iranketab_mcp/http.py +268 -0
- iranketab_mcp-0.1.0/src/iranketab_mcp/registry.py +16 -0
- iranketab_mcp-0.1.0/src/iranketab_mcp/server.py +91 -0
- iranketab_mcp-0.1.0/tests/conftest.py +78 -0
- iranketab_mcp-0.1.0/tests/fixtures/article.html +3 -0
- iranketab_mcp-0.1.0/tests/fixtures/blog_filter.json +1 -0
- iranketab_mcp-0.1.0/tests/fixtures/book.html +2922 -0
- iranketab_mcp-0.1.0/tests/fixtures/comments.json +1 -0
- iranketab_mcp-0.1.0/tests/fixtures/extras.html +446 -0
- iranketab_mcp-0.1.0/tests/fixtures/extras858.html +494 -0
- iranketab_mcp-0.1.0/tests/fixtures/home.html +49 -0
- iranketab_mcp-0.1.0/tests/fixtures/lists.html +1 -0
- iranketab_mcp-0.1.0/tests/fixtures/profile.html +1068 -0
- iranketab_mcp-0.1.0/tests/fixtures/publisher.html +714 -0
- iranketab_mcp-0.1.0/tests/fixtures/result.html +340 -0
- iranketab_mcp-0.1.0/tests/fixtures/result_articles.html +49 -0
- iranketab_mcp-0.1.0/tests/fixtures/suggest.json +1 -0
- iranketab_mcp-0.1.0/tests/fixtures/tag.html +163 -0
- iranketab_mcp-0.1.0/tests/fixtures/tag_filter.json +1 -0
- iranketab_mcp-0.1.0/tests/test_discover.py +99 -0
- iranketab_mcp-0.1.0/tests/test_iranketab.py +163 -0
- iranketab_mcp-0.1.0/tests/test_live_iranketab.py +105 -0
- iranketab_mcp-0.1.0/uv.lock +1413 -0
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
name: CI
|
|
2
|
+
|
|
3
|
+
on:
|
|
4
|
+
push:
|
|
5
|
+
branches: [main]
|
|
6
|
+
pull_request:
|
|
7
|
+
|
|
8
|
+
jobs:
|
|
9
|
+
test:
|
|
10
|
+
runs-on: ubuntu-latest
|
|
11
|
+
strategy:
|
|
12
|
+
matrix:
|
|
13
|
+
python: ["3.10", "3.11", "3.12", "3.13"]
|
|
14
|
+
steps:
|
|
15
|
+
- uses: actions/checkout@v7
|
|
16
|
+
- uses: astral-sh/setup-uv@v10.2.0
|
|
17
|
+
with:
|
|
18
|
+
python-version: ${{ matrix.python }}
|
|
19
|
+
- run: uv sync --locked
|
|
20
|
+
- run: uv run ruff check .
|
|
21
|
+
- run: uv run ruff format --check .
|
|
22
|
+
- run: uv run pytest -q
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
name: Publish
|
|
2
|
+
|
|
3
|
+
# Tag a release (git tag v0.1.0 && git push --tags) after bumping the version in
|
|
4
|
+
# pyproject.toml and server.json.
|
|
5
|
+
on:
|
|
6
|
+
push:
|
|
7
|
+
tags: ["v*"]
|
|
8
|
+
|
|
9
|
+
jobs:
|
|
10
|
+
pypi:
|
|
11
|
+
runs-on: ubuntu-latest
|
|
12
|
+
environment: pypi
|
|
13
|
+
permissions:
|
|
14
|
+
id-token: write # PyPI trusted publishing
|
|
15
|
+
contents: write # GitHub Release
|
|
16
|
+
steps:
|
|
17
|
+
- uses: actions/checkout@v7
|
|
18
|
+
- uses: astral-sh/setup-uv@v10.2.0
|
|
19
|
+
- name: Check versions match the tag
|
|
20
|
+
run: |
|
|
21
|
+
TAG=${GITHUB_REF_NAME#v}
|
|
22
|
+
grep -q "^version = \"$TAG\"" pyproject.toml
|
|
23
|
+
test "$(jq -r .version server.json)" = "$TAG"
|
|
24
|
+
test "$(jq -r '.packages[0].version' server.json)" = "$TAG"
|
|
25
|
+
- run: uv sync --locked && uv run pytest -q
|
|
26
|
+
- run: uv build
|
|
27
|
+
- uses: pypa/gh-action-pypi-publish@release/v1
|
|
28
|
+
- run: gh release create "$GITHUB_REF_NAME" dist/* --generate-notes --title "$GITHUB_REF_NAME"
|
|
29
|
+
env:
|
|
30
|
+
GH_TOKEN: ${{ github.token }}
|
|
31
|
+
|
|
32
|
+
mcp-registry:
|
|
33
|
+
needs: pypi
|
|
34
|
+
runs-on: ubuntu-latest
|
|
35
|
+
permissions:
|
|
36
|
+
id-token: write # MCP Registry login via GitHub OIDC
|
|
37
|
+
contents: read
|
|
38
|
+
steps:
|
|
39
|
+
- uses: actions/checkout@v7
|
|
40
|
+
- name: Wait for PyPI to serve the new version
|
|
41
|
+
run: |
|
|
42
|
+
for i in $(seq 1 30); do
|
|
43
|
+
curl -sf "https://pypi.org/pypi/iranketab-mcp/${GITHUB_REF_NAME#v}/json" >/dev/null && exit 0
|
|
44
|
+
sleep 10
|
|
45
|
+
done
|
|
46
|
+
exit 1
|
|
47
|
+
- name: Install mcp-publisher
|
|
48
|
+
run: |
|
|
49
|
+
curl -L "https://github.com/modelcontextprotocol/registry/releases/download/v1.8.1/mcp-publisher_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher
|
|
50
|
+
- run: ./mcp-publisher login github-oidc
|
|
51
|
+
- run: ./mcp-publisher publish
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Sepehr Radmard
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
|
@@ -0,0 +1,302 @@
|
|
|
1
|
+
Metadata-Version: 2.5
|
|
2
|
+
Name: iranketab-mcp
|
|
3
|
+
Version: 0.1.0
|
|
4
|
+
Summary: Unofficial read-only MCP server for Iranketab (iranketab.ir), the Persian book store: books, translations compared, ratings, reviews, prices.
|
|
5
|
+
Project-URL: Homepage, https://github.com/sepehr071/iranketab-mcp
|
|
6
|
+
Project-URL: Issues, https://github.com/sepehr071/iranketab-mcp/issues
|
|
7
|
+
Project-URL: Website, https://mcpfarsi.ir/
|
|
8
|
+
Author-email: Sepehr Radmard <sepehrr80@gmail.com>
|
|
9
|
+
License-Expression: MIT
|
|
10
|
+
License-File: LICENSE
|
|
11
|
+
Keywords: book-reviews,books,bookstore,claude,iran,iran-ketab,iranketab,mcp,model-context-protocol,persian,persian-books,ratings,translations
|
|
12
|
+
Classifier: Development Status :: 4 - Beta
|
|
13
|
+
Classifier: Intended Audience :: Developers
|
|
14
|
+
Classifier: Operating System :: OS Independent
|
|
15
|
+
Classifier: Programming Language :: Python :: 3
|
|
16
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
17
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
18
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
19
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
20
|
+
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
|
|
21
|
+
Requires-Python: >=3.10
|
|
22
|
+
Requires-Dist: beautifulsoup4>=4.12
|
|
23
|
+
Requires-Dist: curl-cffi>=0.16.3
|
|
24
|
+
Requires-Dist: httpx-curl-cffi>=0.1.5
|
|
25
|
+
Requires-Dist: httpx>=0.27
|
|
26
|
+
Requires-Dist: mcp<3,>=2.2
|
|
27
|
+
Description-Content-Type: text/markdown
|
|
28
|
+
|
|
29
|
+
<!-- mcp-name: io.github.sepehr071/iranketab-mcp -->
|
|
30
|
+
|
|
31
|
+
<div align="center">
|
|
32
|
+
|
|
33
|
+
# iranketab-mcp: Iranketab (ایران کتاب) Persian book store MCP server for AI agents
|
|
34
|
+
|
|
35
|
+
**iranketab-mcp is an unofficial, read-only MCP server that gives AI agents the Iranketab book store (فروشگاه اینترنتی ایران کتاب).**<br>
|
|
36
|
+
Its 13 tools search books, authors, translators and publishers, compare every translation of a book by rating, votes and price,<br>
|
|
37
|
+
read reader comments, list a publisher's or translator's books, browse bestseller, prize and discount lists, show a book's<br>
|
|
38
|
+
prizes, series and critics' quotes, suggest what to read next and read the blog.<br>
|
|
39
|
+
No API key or Iranketab account is needed. It works in Claude, Cursor, Copilot and any other MCP client.
|
|
40
|
+
|
|
41
|
+
[](https://pypi.org/project/iranketab-mcp/)
|
|
42
|
+
[](https://pypi.org/project/iranketab-mcp/)
|
|
43
|
+
[](https://github.com/sepehr071/iranketab-mcp/actions/workflows/ci.yml)
|
|
44
|
+
[](https://registry.modelcontextprotocol.io/?q=iranketab-mcp)
|
|
45
|
+
[](https://github.com/sepehr071/iranketab-mcp/blob/main/LICENSE)
|
|
46
|
+
|
|
47
|
+
[For AI agents](#for-ai-agents) · [Quick start](#quick-start) · [What it can do](#what-it-can-do) · [Tools](#tools) · [FAQ](#faq) · [فارسی](#فارسی)
|
|
48
|
+
|
|
49
|
+
</div>
|
|
50
|
+
|
|
51
|
+
---
|
|
52
|
+
|
|
53
|
+
## For AI agents
|
|
54
|
+
|
|
55
|
+
- **What:** unofficial MCP server (model context protocol) for iranketab.ir, a Persian online book store: search, book pages with every edition (translation and publisher) and its own rating, votes, price and stock, reader comments, author/translator and publisher pages, bestseller, newest and award lists with filters.
|
|
56
|
+
- **Install:** `uvx iranketab-mcp` or `claude mcp add iranketab -- uvx iranketab-mcp`. Transport: stdio. Needs [uv](https://docs.astral.sh/uv/getting-started/installation/) (Python 3.10+).
|
|
57
|
+
- **Auth:** none, no API key or account. Optional `IRANKETAB_MCP_PROXY` (HTTP proxy URL, or a comma-separated list); system proxy settings are ignored.
|
|
58
|
+
- **Access:** read-only. It cannot log in, order, rate or comment, so no confirmation is needed before calling any tool.
|
|
59
|
+
- **Tools:** 13, all prefixed `ik_`. Typical sequences: `ik_search` -> `ik_editions` -> `ik_reviews`; `ik_search(kind="profile")` -> `ik_profile`; `ik_browse(209)` -> `ik_book`.
|
|
60
|
+
- **Use when:** the user asks which translation or edition of a Persian-available book is best or cheapest, what readers say about a book or a translator, what a publisher or translator has published, or what is on the bestseller and new-release lists.
|
|
61
|
+
- **Do not use when:** the user wants e-books or audiobooks (this is a printed-book store; see fidibo-mcp, taaghche-mcp), or to buy something.
|
|
62
|
+
- **Output:** compact JSON. Prices are Toman. Ratings are 1 to 5 per edition (read the vote count too). Titles, introductions and comments are Persian.
|
|
63
|
+
- **Machine-readable:** [`server.json`](https://github.com/sepehr071/iranketab-mcp/blob/main/server.json) and the
|
|
64
|
+
[iran-mcp catalog](https://github.com/sepehr071/iran-mcp).
|
|
65
|
+
|
|
66
|
+
## Why
|
|
67
|
+
|
|
68
|
+
Iranketab is known for its ratings, comments and its habit of putting every Persian translation of a foreign book on
|
|
69
|
+
one page. Comparing translations of *The Idiot* by hand means opening 17 editions and scrolling 195 comments. With
|
|
70
|
+
`iranketab-mcp` an agent does it in two calls:
|
|
71
|
+
|
|
72
|
+
> **You:** Which Persian translation of *The Idiot* should I buy?
|
|
73
|
+
>
|
|
74
|
+
> **Agent:** *calls* `ik_search("ابله")`, then `ik_editions(858, in_stock_only=true)`
|
|
75
|
+
>
|
|
76
|
+
> Soroush Habibi's (نشر چشمه) is rated 4.17 by 82 readers and costs 2,090,000 Toman; Mehri Ahi's (خوارزمی) has 4.06 from
|
|
77
|
+
> 40 votes at 3,705,000. The Negah edition (رضا ستوده) is rated 2.87 by 15 readers.
|
|
78
|
+
|
|
79
|
+
## What it can do
|
|
80
|
+
|
|
81
|
+
- **Search** books, authors and translators, publishers and categories by name
|
|
82
|
+
- **Compare editions**: every translation and publisher edition of a book with its own rating, votes, price, discount, stock, pages, year, ISBN, size and cover type; sort by rating, price or pages
|
|
83
|
+
- **Read comments**: reader comments with date, likes, the edition they refer to and replies, 20 per page
|
|
84
|
+
- **Author and translator pages**: biography and all credited books, with sort and in-list search
|
|
85
|
+
- **Publisher catalogue**: a publisher's books, best sellers first
|
|
86
|
+
- **Browse lists**: bestsellers, newest, recommended, award and genre lists with sort, in-list search and sub-category filters
|
|
87
|
+
- **Read-only by design**: no login, no ordering
|
|
88
|
+
|
|
89
|
+
Example prompts:
|
|
90
|
+
|
|
91
|
+
- "Compare the Persian translations of *Crime and Punishment* by rating and price."
|
|
92
|
+
- "What do readers say about Soroush Habibi's translation of *The Idiot*?"
|
|
93
|
+
- "What else has Mehri Ahi translated?"
|
|
94
|
+
- "Top bestsellers in Russian literature on Iranketab."
|
|
95
|
+
- <span dir="rtl">بهترین ترجمهٔ «جنایت و مکافات» کدام است؟</span>
|
|
96
|
+
- <span dir="rtl">پرفروشترین کتابهای نشر خوارزمی را بگو.</span>
|
|
97
|
+
|
|
98
|
+
## Quick start
|
|
99
|
+
|
|
100
|
+
You need [uv](https://docs.astral.sh/uv/getting-started/installation/). No API key or account.
|
|
101
|
+
|
|
102
|
+
<details open>
|
|
103
|
+
<summary><b>Claude Code</b></summary>
|
|
104
|
+
|
|
105
|
+
```bash
|
|
106
|
+
claude mcp add iranketab -- uvx iranketab-mcp
|
|
107
|
+
```
|
|
108
|
+
</details>
|
|
109
|
+
|
|
110
|
+
<details>
|
|
111
|
+
<summary><b>Claude Desktop</b></summary>
|
|
112
|
+
|
|
113
|
+
Settings → Developer → Edit Config, then add:
|
|
114
|
+
|
|
115
|
+
```json
|
|
116
|
+
{
|
|
117
|
+
"mcpServers": {
|
|
118
|
+
"iranketab": { "command": "uvx", "args": ["iranketab-mcp"] }
|
|
119
|
+
}
|
|
120
|
+
}
|
|
121
|
+
```
|
|
122
|
+
</details>
|
|
123
|
+
|
|
124
|
+
<details>
|
|
125
|
+
<summary><b>Cursor</b></summary>
|
|
126
|
+
|
|
127
|
+
Add the Claude Desktop block above to `~/.cursor/mcp.json` (or `.cursor/mcp.json` in a project).
|
|
128
|
+
</details>
|
|
129
|
+
|
|
130
|
+
<details>
|
|
131
|
+
<summary><b>VS Code (Copilot agent mode)</b></summary>
|
|
132
|
+
|
|
133
|
+
Add to `.vscode/mcp.json`:
|
|
134
|
+
|
|
135
|
+
```json
|
|
136
|
+
{
|
|
137
|
+
"servers": {
|
|
138
|
+
"iranketab": { "type": "stdio", "command": "uvx", "args": ["iranketab-mcp"] }
|
|
139
|
+
}
|
|
140
|
+
}
|
|
141
|
+
```
|
|
142
|
+
</details>
|
|
143
|
+
|
|
144
|
+
<details>
|
|
145
|
+
<summary><b>Codex CLI</b></summary>
|
|
146
|
+
|
|
147
|
+
```bash
|
|
148
|
+
codex mcp add iranketab -- uvx iranketab-mcp
|
|
149
|
+
```
|
|
150
|
+
</details>
|
|
151
|
+
|
|
152
|
+
<details>
|
|
153
|
+
<summary><b>Anything else</b></summary>
|
|
154
|
+
|
|
155
|
+
It is a standard stdio MCP server: run `uvx iranketab-mcp`, or `pip install iranketab-mcp` and run `iranketab-mcp`.
|
|
156
|
+
</details>
|
|
157
|
+
|
|
158
|
+
## Tools
|
|
159
|
+
|
|
160
|
+
Book ids (`858`), profile ids (`1059`), publisher ids (`35`) and category ids (`209`) come from `ik_search`, from the
|
|
161
|
+
lists and from earlier results. A book id stands for the work; its editions are the different translations.
|
|
162
|
+
|
|
163
|
+
| Tool | What it does |
|
|
164
|
+
|---|---|
|
|
165
|
+
| `ik_search` | Search Iranketab by name and return matching books, authors/translators, publishers or categories with their ids |
|
|
166
|
+
| `ik_book` | Read one book (a work): title, authors, categories, introduction, review count and a short list of every edition |
|
|
167
|
+
| `ik_editions` | Compare every translation and publisher edition of one book side by side: rating, votes, price, pages, year, ISBN |
|
|
168
|
+
| `ik_reviews` | Read reader comments about a book, 20 per page, newest first, with the publisher/edition when the reader named one |
|
|
169
|
+
| `ik_profile` | Read an author's or translator's profile (name, biography) and the books they wrote or translated |
|
|
170
|
+
| `ik_publisher_books` | List the books of one publisher (انتشارات) on Iranketab, best sellers first by default |
|
|
171
|
+
| `ik_browse` | List books of a category, bestseller list or award list, with sort, in-list search and sub-category filters |
|
|
172
|
+
| `ik_categories` | List Iranketab's menu categories, or the sub-category filter groups of one category |
|
|
173
|
+
| `ik_book_extras` | Read what else a book page offers: awards, series, praise quotes, excerpts, author bio, related books and articles |
|
|
174
|
+
| `ik_recommend` | Suggest books to read next from books the reader liked, using Iranketab's own recommender |
|
|
175
|
+
| `ik_lists` | List Iranketab's literary prizes, best-of lists, book series, countries, genres or literary movements with ids |
|
|
176
|
+
| `ik_articles` | Find articles on Iranketab's blog (book reviews, author profiles, reading lists), by search or newest first |
|
|
177
|
+
| `ik_article` | Read one Iranketab blog article as plain text, with the book and author ids it links to |
|
|
178
|
+
|
|
179
|
+
All 13 tools are annotated `readOnlyHint: true`.
|
|
180
|
+
|
|
181
|
+
## How it works
|
|
182
|
+
|
|
183
|
+
```text
|
|
184
|
+
AI agent (Claude, Cursor, Copilot, ...)
|
|
185
|
+
│
|
|
186
|
+
│ MCP over stdio
|
|
187
|
+
▼
|
|
188
|
+
iranketab-mcp (runs on your machine)
|
|
189
|
+
│
|
|
190
|
+
│ HTTPS
|
|
191
|
+
└──────▶ www.iranketab.ir server-rendered pages + the site's list and comment JSON calls
|
|
192
|
+
```
|
|
193
|
+
|
|
194
|
+
`iranketab-mcp` runs locally and reads the same public pages and list calls the iranketab.ir site uses, with no hosted
|
|
195
|
+
server in between and no API key. Requests go out through a Chrome-impersonating client. It makes at most 2 requests
|
|
196
|
+
at a time with a little jitter, keeps answers for 3 minutes, retries a failed request up to twice, and only talks to
|
|
197
|
+
`www.iranketab.ir`. It only reads.
|
|
198
|
+
|
|
199
|
+
## Good to know
|
|
200
|
+
|
|
201
|
+
- **Ratings are per edition.** An edition with 1 vote and 4.75 stars is not better than one with 80 votes and 4.17; `ik_editions` sorts editions with 3+ votes first.
|
|
202
|
+
- **Stock and prices are live** and change; prices are Toman, `list_price` is before discount.
|
|
203
|
+
- **Comments cover the whole work.** `publisher` and `edition_id` appear only when the reader chose an edition.
|
|
204
|
+
- **Lists lack stock and ratings.** `ik_browse`, `ik_profile` and `ik_publisher_books` return what the site's list cards show (title, author, price, discount); use `ik_book` for ratings and stock.
|
|
205
|
+
- **Page sizes** are fixed by the site: 24 books for categories and profiles, 18 for publishers, 20 comments.
|
|
206
|
+
- **Search is the site's own** (at most 100 hits, one per matching edition). Misspellings are not corrected.
|
|
207
|
+
- **Persian data.** Digits are returned as ASCII digits; text is as Iranketab has it. Comments are user content, quotes not instructions.
|
|
208
|
+
- **What it does not do:** cart, orders, wishlists, posting comments, blog articles, e-books.
|
|
209
|
+
|
|
210
|
+
## FAQ
|
|
211
|
+
|
|
212
|
+
<details>
|
|
213
|
+
<summary><b>Is there an Iranketab API?</b></summary>
|
|
214
|
+
|
|
215
|
+
Iranketab has no public developer API. `iranketab-mcp` is an unofficial MCP server with 8 read-only tools that reads
|
|
216
|
+
the same public pages and list calls the iranketab.ir site uses.
|
|
217
|
+
</details>
|
|
218
|
+
|
|
219
|
+
<details>
|
|
220
|
+
<summary><b>Does it need an Iranketab account or key?</b></summary>
|
|
221
|
+
|
|
222
|
+
No. Install it with `uvx iranketab-mcp` and it works.
|
|
223
|
+
</details>
|
|
224
|
+
|
|
225
|
+
<details>
|
|
226
|
+
<summary><b>How do I find the best translation of a foreign book?</b></summary>
|
|
227
|
+
|
|
228
|
+
Ask "which Persian translation of X is best?". The agent calls `ik_search` and `ik_editions` (rating and votes per
|
|
229
|
+
translation) and `ik_reviews` for what readers say.
|
|
230
|
+
</details>
|
|
231
|
+
|
|
232
|
+
<details>
|
|
233
|
+
<summary><b>Do I need an Iranian IP or a proxy?</b></summary>
|
|
234
|
+
|
|
235
|
+
No. It was tested from an Iranian line and from a Turkish IP. If requests are blocked from your network, set
|
|
236
|
+
`IRANKETAB_MCP_PROXY` to an HTTP proxy. System proxy variables are ignored on purpose.
|
|
237
|
+
</details>
|
|
238
|
+
|
|
239
|
+
<details>
|
|
240
|
+
<summary><b>How is it different from fidibo-mcp, taaghche-mcp or 30book-mcp?</b></summary>
|
|
241
|
+
|
|
242
|
+
Those read e-book and audiobook platforms. Iranketab sells printed books, and this server's strength is per-translation
|
|
243
|
+
ratings, comments and publisher editions.
|
|
244
|
+
</details>
|
|
245
|
+
|
|
246
|
+
<details>
|
|
247
|
+
<summary><b>How do I debug what the agent sees?</b></summary>
|
|
248
|
+
|
|
249
|
+
```bash
|
|
250
|
+
npx @modelcontextprotocol/inspector uvx iranketab-mcp
|
|
251
|
+
```
|
|
252
|
+
</details>
|
|
253
|
+
|
|
254
|
+
## Configuration
|
|
255
|
+
|
|
256
|
+
| Variable | Default | Meaning |
|
|
257
|
+
|---|---|---|
|
|
258
|
+
| `IRANKETAB_MCP_PROXY` | unset | Optional HTTP proxy URL for the Iranketab requests; system proxy settings are ignored. A comma-separated list is used one at a time: the next proxy takes over when one is blocked or cannot connect |
|
|
259
|
+
|
|
260
|
+
<a id="فارسی"></a>
|
|
261
|
+
|
|
262
|
+
## فارسی: سرور MCP فروشگاه ایران کتاب
|
|
263
|
+
|
|
264
|
+
<div dir="rtl">
|
|
265
|
+
|
|
266
|
+
**سرور iranketab-mcp** یک سرور MCP غیررسمی و فقطخواندنی برای [ایران کتاب](https://www.iranketab.ir) است. دستیار هوش مصنوعی شما (Claude، Cursor، Copilot و بقیه) همان اطلاعاتی را میبیند که سایت به هر بازدیدکننده نشان میدهد.
|
|
267
|
+
|
|
268
|
+
**چه کارهایی میکند**
|
|
269
|
+
|
|
270
|
+
- **جستوجوی** کتاب، نویسنده و مترجم، ناشر و دستهبندی.
|
|
271
|
+
- **مقایسهٔ ترجمهها و چاپها**: برای هر ترجمه امتیاز، تعداد رأی، قیمت، تخفیف، موجودی، تعداد صفحه، سال و شابک.
|
|
272
|
+
- **نظرهای کاربران** با تاریخ، تعداد لایک و پاسخها.
|
|
273
|
+
- **صفحهٔ نویسنده و مترجم** با زندگینامه و فهرست کتابها، و **کتابهای هر ناشر**.
|
|
274
|
+
- **پرفروشها و تازهها** و فهرستهای جایزه، با مرتبسازی و فیلتر دستهبندی.
|
|
275
|
+
|
|
276
|
+
**نکتهها**
|
|
277
|
+
|
|
278
|
+
- فقطخواندنی است: وارد حساب نمیشود، سفارش نمیدهد و نظر ثبت نمیکند.
|
|
279
|
+
- امتیازها برای هر چاپ جداست؛ به تعداد رأی هم نگاه کنید.
|
|
280
|
+
- کلید API لازم نیست. اگر شبکهٔ شما درخواستها را مسدود کرد، `IRANKETAB_MCP_PROXY` را روی یک پراکسی HTTP بگذارید.
|
|
281
|
+
|
|
282
|
+
**نصب** (اول [uv](https://docs.astral.sh/uv/getting-started/installation/) را نصب کنید). در Claude Code:
|
|
283
|
+
|
|
284
|
+
</div>
|
|
285
|
+
|
|
286
|
+
```bash
|
|
287
|
+
claude mcp add iranketab -- uvx iranketab-mcp
|
|
288
|
+
```
|
|
289
|
+
|
|
290
|
+
<div dir="rtl">
|
|
291
|
+
|
|
292
|
+
مثال: «بهترین ترجمهٔ ابله کدام است؟» یا «پرفروشترین کتابهای ادبیات روسیه».
|
|
293
|
+
|
|
294
|
+
</div>
|
|
295
|
+
|
|
296
|
+
## Disclaimer
|
|
297
|
+
|
|
298
|
+
Unofficial; not affiliated with Iranketab. It reads public pages only. Iranketab's names and content belong to their owners.
|
|
299
|
+
|
|
300
|
+
## License
|
|
301
|
+
|
|
302
|
+
MIT, see [LICENSE](LICENSE). Made by [Sepehr Radmard](https://github.com/sepehr071) ([LinkedIn](https://www.linkedin.com/in/sepehr-radmard)).
|