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.
Files changed (34) hide show
  1. iranketab_mcp-0.1.0/.github/workflows/ci.yml +22 -0
  2. iranketab_mcp-0.1.0/.github/workflows/publish.yml +51 -0
  3. iranketab_mcp-0.1.0/.gitignore +6 -0
  4. iranketab_mcp-0.1.0/LICENSE +21 -0
  5. iranketab_mcp-0.1.0/PKG-INFO +302 -0
  6. iranketab_mcp-0.1.0/README.md +274 -0
  7. iranketab_mcp-0.1.0/pyproject.toml +56 -0
  8. iranketab_mcp-0.1.0/server.json +32 -0
  9. iranketab_mcp-0.1.0/src/iranketab_mcp/__init__.py +5 -0
  10. iranketab_mcp-0.1.0/src/iranketab_mcp/books.py +508 -0
  11. iranketab_mcp-0.1.0/src/iranketab_mcp/discover.py +249 -0
  12. iranketab_mcp-0.1.0/src/iranketab_mcp/http.py +268 -0
  13. iranketab_mcp-0.1.0/src/iranketab_mcp/registry.py +16 -0
  14. iranketab_mcp-0.1.0/src/iranketab_mcp/server.py +91 -0
  15. iranketab_mcp-0.1.0/tests/conftest.py +78 -0
  16. iranketab_mcp-0.1.0/tests/fixtures/article.html +3 -0
  17. iranketab_mcp-0.1.0/tests/fixtures/blog_filter.json +1 -0
  18. iranketab_mcp-0.1.0/tests/fixtures/book.html +2922 -0
  19. iranketab_mcp-0.1.0/tests/fixtures/comments.json +1 -0
  20. iranketab_mcp-0.1.0/tests/fixtures/extras.html +446 -0
  21. iranketab_mcp-0.1.0/tests/fixtures/extras858.html +494 -0
  22. iranketab_mcp-0.1.0/tests/fixtures/home.html +49 -0
  23. iranketab_mcp-0.1.0/tests/fixtures/lists.html +1 -0
  24. iranketab_mcp-0.1.0/tests/fixtures/profile.html +1068 -0
  25. iranketab_mcp-0.1.0/tests/fixtures/publisher.html +714 -0
  26. iranketab_mcp-0.1.0/tests/fixtures/result.html +340 -0
  27. iranketab_mcp-0.1.0/tests/fixtures/result_articles.html +49 -0
  28. iranketab_mcp-0.1.0/tests/fixtures/suggest.json +1 -0
  29. iranketab_mcp-0.1.0/tests/fixtures/tag.html +163 -0
  30. iranketab_mcp-0.1.0/tests/fixtures/tag_filter.json +1 -0
  31. iranketab_mcp-0.1.0/tests/test_discover.py +99 -0
  32. iranketab_mcp-0.1.0/tests/test_iranketab.py +163 -0
  33. iranketab_mcp-0.1.0/tests/test_live_iranketab.py +105 -0
  34. 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,6 @@
1
+ .venv/
2
+ __pycache__/
3
+ *.pyc
4
+ dist/
5
+ .pytest_cache/
6
+ .ruff_cache/
@@ -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
+ [![PyPI](https://img.shields.io/pypi/v/iranketab-mcp?color=2563eb)](https://pypi.org/project/iranketab-mcp/)
42
+ [![Python](https://img.shields.io/pypi/pyversions/iranketab-mcp)](https://pypi.org/project/iranketab-mcp/)
43
+ [![CI](https://github.com/sepehr071/iranketab-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/sepehr071/iranketab-mcp/actions/workflows/ci.yml)
44
+ [![MCP Registry](https://img.shields.io/badge/MCP_Registry-io.github.sepehr071%2Firanketab--mcp-7c3aed)](https://registry.modelcontextprotocol.io/?q=iranketab-mcp)
45
+ [![License: MIT](https://img.shields.io/badge/license-MIT-16a34a)](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)).