darukade-mcp 0.1.0__tar.gz

darukade_mcp-0.1.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,42 @@
+name: Bug report
+description: A tool failed or returned wrong data
+labels: [bug]
+body:
+  - type: input
+    id: tool
+    attributes:
+      label: Tool
+      description: Which tool, e.g. bl_search
+    validations:
+      required: true
+  - type: textarea
+    id: input
+    attributes:
+      label: Arguments and result
+      description: The arguments the agent sent and the error or wrong output. Remove anything personal.
+      render: json
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: What you expected
+      description: e.g. what darukade.com shows for the same query
+  - type: input
+    id: client
+    attributes:
+      label: MCP client and OS
+      placeholder: Claude Desktop 1.x on Windows 11
+  - type: dropdown
+    id: network
+    attributes:
+      label: Network
+      options:
+        - Direct connection
+        - VPN or proxy
+        - DARUKADE_MCP_PROXY set
+  - type: input
+    id: version
+    attributes:
+      label: darukade-mcp version
+      placeholder: "0.1.0"

darukade_mcp-0.1.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Question or idea
+    url: https://github.com/sepehr071/darukade-mcp/discussions
+    about: Ask how to use it or suggest a new tool

darukade_mcp-0.1.0/.github/dependabot.yml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: monthly
+  - package-ecosystem: uv
+    directory: /
+    schedule:
+      interval: monthly

darukade_mcp-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,22 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v7
+      - uses: astral-sh/setup-uv@v10.2.0
+        with:
+          python-version: ${{ matrix.python }}
+      - run: uv sync --locked
+      - run: uv run ruff check .
+      - run: uv run ruff format --check .
+      - run: uv run pytest -q

darukade_mcp-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,51 @@
+name: Publish
+
+# Tag a release (git tag v0.1.0 && git push --tags) after bumping the version in
+# pyproject.toml and server.json.
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  pypi:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write  # PyPI trusted publishing
+      contents: write  # GitHub Release
+    steps:
+      - uses: actions/checkout@v7
+      - uses: astral-sh/setup-uv@v10.2.0
+      - name: Check versions match the tag
+        run: |
+          TAG=${GITHUB_REF_NAME#v}
+          grep -q "^version = \"$TAG\"" pyproject.toml
+          test "$(jq -r .version server.json)" = "$TAG"
+          test "$(jq -r '.packages[0].version' server.json)" = "$TAG"
+      - run: uv sync --locked && uv run pytest -q
+      - run: uv build
+      - uses: pypa/gh-action-pypi-publish@release/v1
+      - run: gh release create "$GITHUB_REF_NAME" dist/* --generate-notes --title "$GITHUB_REF_NAME"
+        env:
+          GH_TOKEN: ${{ github.token }}
+
+  mcp-registry:
+    needs: pypi
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write  # MCP Registry login via GitHub OIDC
+      contents: read
+    steps:
+      - uses: actions/checkout@v7
+      - name: Wait for PyPI to serve the new version
+        run: |
+          for i in $(seq 1 30); do
+            curl -sf "https://pypi.org/pypi/darukade-mcp/${GITHUB_REF_NAME#v}/json" >/dev/null && exit 0
+            sleep 10
+          done
+          exit 1
+      - name: Install mcp-publisher
+        run: |
+          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
+      - run: ./mcp-publisher login github-oidc
+      - run: ./mcp-publisher publish

darukade_mcp-0.1.0/.gitignore

@@ -0,0 +1,6 @@
+.venv/
+__pycache__/
+*.pyc
+dist/
+.pytest_cache/
+.ruff_cache/

darukade_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sepehr Radmard
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

darukade_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,87 @@
+Metadata-Version: 2.5
+Name: darukade-mcp
+Version: 0.1.0
+Summary: Unofficial read-only MCP server for Darukade (darukade.com), an Iranian online pharmacy: search products, prices, ingredients, usage, reviews.
+Project-URL: Homepage, https://github.com/sepehr071/darukade-mcp
+Project-URL: Issues, https://github.com/sepehr071/darukade-mcp/issues
+Project-URL: Website, https://mcpfarsi.ir/
+Author-email: Sepehr Radmard <sepehrr80@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: claude,cosmetics,darukade,darukade-com,iran,mcp,model-context-protocol,online-pharmacy,persian,pharmacy,prices,skin-care,supplements,vitamins
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Requires-Dist: curl-cffi>=0.16.3
+Requires-Dist: httpx-curl-cffi>=0.1.5
+Requires-Dist: httpx>=0.27
+Requires-Dist: mcp<3,>=2.2
+Description-Content-Type: text/markdown
+
+<!-- mcp-name: io.github.sepehr071/darukade-mcp -->
+
+# darukade-mcp: Darukade (داروکده) online pharmacy MCP server for AI agents
+
+**darukade-mcp is an unofficial, read-only MCP server for Darukade (darukade.com), an Iranian online pharmacy.**<br>
+Its 12 tools search the product catalog with filters (category, brand, form, price, stock, discount), find the cheapest products,
+read a product's price per variant, ingredients, dosage and warnings, compare products, list user questions with the pharmacists'
+answers, suggest alternatives, show the home page offers, and search and read the Darukade health magazine.<br>
+No API key or account is needed. It works in Claude, Cursor, Copilot and any other MCP client.
+
+[![PyPI](https://img.shields.io/pypi/v/darukade-mcp?color=2563eb)](https://pypi.org/project/darukade-mcp/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-16a34a)](https://github.com/sepehr071/darukade-mcp/blob/main/LICENSE)
+
+## For AI agents
+
+- **What:** unofficial MCP server for darukade.com: supplements, vitamins, cosmetics and skin care, baby, medical equipment.
+- **Install:** `uvx darukade-mcp` or `claude mcp add darukade -- uvx darukade-mcp`. Transport: stdio. Needs [uv](https://docs.astral.sh/uv/getting-started/installation/).
+- **Auth:** none. Optional `DARUKADE_MCP_PROXY` (HTTP proxy URL, or a comma-separated list); system proxy settings are ignored.
+- **Access:** read-only. It cannot log in, order or upload prescriptions, so no confirmation is needed before any tool.
+- **Tools:** 12, prefixed `dr_`. Typical: `dr_categories` / `dr_brands` / `dr_forms` -> `dr_search` / `dr_cheapest` -> `dr_product` / `dr_compare` -> `dr_reviews` / `dr_related`; or `dr_articles` -> `dr_article`.
+- **Output:** compact JSON; prices in Toman after discount; Persian text as the shop has it. Not medical advice.
+
+## Quick start
+
+```bash
+claude mcp add darukade -- uvx darukade-mcp
+```
+
+Claude Desktop / Cursor: add `{"mcpServers": {"darukade": {"command": "uvx", "args": ["darukade-mcp"]}}}` to the MCP config.
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| `dr_search` | Search the catalog by words, category, brand, form, price range, in stock, discounted, gift, with sort and paging |
+| `dr_cheapest` | List the lowest-priced products of a category, brand or search, cheapest first |
+| `dr_product` | One product: price per variant, stock, brand, ingredients with amounts, dosage, warnings, properties, pharmacy FAQ, magazine articles |
+| `dr_compare` | 2-5 products side by side: price, stock, ingredient amounts, dosage, cheapest, common ingredients |
+| `dr_reviews` | User comments and questions with the pharmacy's answers, plus the rating summary |
+| `dr_related` | Alternatives, similar, same-brand and complementary products with prices |
+| `dr_categories` | Category ids (about 60 top-level, 475 sub-categories) for the `category` filter |
+| `dr_brands` | Find a brand by name and get its id for the `brand` filter, or read a brand's profile (about text, categories) |
+| `dr_forms` | Product form ids (capsule, syrup, cream, spray ...) for the `form` filter |
+| `dr_home` | The home page's golden offers, newest, best-selling and most-loved products |
+| `dr_articles` | Search the health magazine (about 2,900 articles; category 14 is drug information) |
+| `dr_article` | Read one magazine article as text with its author, sources and recommended products |
+
+Example: "cheapest sunscreen for all skin types" -> `dr_categories("ضد آفتاب انواع پوست")` -> `dr_cheapest(category=[1379])`.
+The site cannot sort text searches, so a text query with a cheapest/discount sort orders up to 288 matches itself.
+
+## Development
+
+```bash
+uv sync
+uv run ruff check . && uv run ruff format --check .
+uv run python -m pytest -q
+uv run python -m pytest -m live -q   # calls the real site
+```
+
+Unofficial; not affiliated with Darukade. MIT licensed. Author: Sepehr Radmard (سپهر رادمرد), github.com/sepehr071.

darukade_mcp-0.1.0/README.md

@@ -0,0 +1,60 @@
+<!-- mcp-name: io.github.sepehr071/darukade-mcp -->
+
+# darukade-mcp: Darukade (داروکده) online pharmacy MCP server for AI agents
+
+**darukade-mcp is an unofficial, read-only MCP server for Darukade (darukade.com), an Iranian online pharmacy.**<br>
+Its 12 tools search the product catalog with filters (category, brand, form, price, stock, discount), find the cheapest products,
+read a product's price per variant, ingredients, dosage and warnings, compare products, list user questions with the pharmacists'
+answers, suggest alternatives, show the home page offers, and search and read the Darukade health magazine.<br>
+No API key or account is needed. It works in Claude, Cursor, Copilot and any other MCP client.
+
+[![PyPI](https://img.shields.io/pypi/v/darukade-mcp?color=2563eb)](https://pypi.org/project/darukade-mcp/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-16a34a)](https://github.com/sepehr071/darukade-mcp/blob/main/LICENSE)
+
+## For AI agents
+
+- **What:** unofficial MCP server for darukade.com: supplements, vitamins, cosmetics and skin care, baby, medical equipment.
+- **Install:** `uvx darukade-mcp` or `claude mcp add darukade -- uvx darukade-mcp`. Transport: stdio. Needs [uv](https://docs.astral.sh/uv/getting-started/installation/).
+- **Auth:** none. Optional `DARUKADE_MCP_PROXY` (HTTP proxy URL, or a comma-separated list); system proxy settings are ignored.
+- **Access:** read-only. It cannot log in, order or upload prescriptions, so no confirmation is needed before any tool.
+- **Tools:** 12, prefixed `dr_`. Typical: `dr_categories` / `dr_brands` / `dr_forms` -> `dr_search` / `dr_cheapest` -> `dr_product` / `dr_compare` -> `dr_reviews` / `dr_related`; or `dr_articles` -> `dr_article`.
+- **Output:** compact JSON; prices in Toman after discount; Persian text as the shop has it. Not medical advice.
+
+## Quick start
+
+```bash
+claude mcp add darukade -- uvx darukade-mcp
+```
+
+Claude Desktop / Cursor: add `{"mcpServers": {"darukade": {"command": "uvx", "args": ["darukade-mcp"]}}}` to the MCP config.
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| `dr_search` | Search the catalog by words, category, brand, form, price range, in stock, discounted, gift, with sort and paging |
+| `dr_cheapest` | List the lowest-priced products of a category, brand or search, cheapest first |
+| `dr_product` | One product: price per variant, stock, brand, ingredients with amounts, dosage, warnings, properties, pharmacy FAQ, magazine articles |
+| `dr_compare` | 2-5 products side by side: price, stock, ingredient amounts, dosage, cheapest, common ingredients |
+| `dr_reviews` | User comments and questions with the pharmacy's answers, plus the rating summary |
+| `dr_related` | Alternatives, similar, same-brand and complementary products with prices |
+| `dr_categories` | Category ids (about 60 top-level, 475 sub-categories) for the `category` filter |
+| `dr_brands` | Find a brand by name and get its id for the `brand` filter, or read a brand's profile (about text, categories) |
+| `dr_forms` | Product form ids (capsule, syrup, cream, spray ...) for the `form` filter |
+| `dr_home` | The home page's golden offers, newest, best-selling and most-loved products |
+| `dr_articles` | Search the health magazine (about 2,900 articles; category 14 is drug information) |
+| `dr_article` | Read one magazine article as text with its author, sources and recommended products |
+
+Example: "cheapest sunscreen for all skin types" -> `dr_categories("ضد آفتاب انواع پوست")` -> `dr_cheapest(category=[1379])`.
+The site cannot sort text searches, so a text query with a cheapest/discount sort orders up to 288 matches itself.
+
+## Development
+
+```bash
+uv sync
+uv run ruff check . && uv run ruff format --check .
+uv run python -m pytest -q
+uv run python -m pytest -m live -q   # calls the real site
+```
+
+Unofficial; not affiliated with Darukade. MIT licensed. Author: Sepehr Radmard (سپهر رادمرد), github.com/sepehr071.

darukade_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,55 @@
+[project]
+name = "darukade-mcp"
+version = "0.1.0"
+description = "Unofficial read-only MCP server for Darukade (darukade.com), an Iranian online pharmacy: search products, prices, ingredients, usage, reviews."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Sepehr Radmard", email = "sepehrr80@gmail.com" }]
+requires-python = ">=3.10"
+keywords = ["mcp", "model-context-protocol", "darukade", "darukade-com", "iran", "pharmacy", "online-pharmacy", "supplements", "vitamins", "cosmetics", "skin-care", "prices", "claude", "persian"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    ]
+dependencies = [
+    "mcp>=2.2,<3",
+    "httpx>=0.27",
+    "httpx-curl-cffi>=0.1.5",
+    "curl-cffi>=0.16.3",
+]
+
+[project.urls]
+Homepage = "https://github.com/sepehr071/darukade-mcp"
+Issues = "https://github.com/sepehr071/darukade-mcp/issues"
+Website = "https://mcpfarsi.ir/"
+
+[project.scripts]
+darukade-mcp = "darukade_mcp.server:main"
+
+[dependency-groups]
+dev = ["pytest>=8", "ruff>=0.6"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-m 'not live'"
+markers = ["live: calls the real Darukade site (run with -m live)"]
+
+[tool.ruff]
+line-length = 120
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "B", "UP"]
+ignore = ["E501"]  # long Field(description=...) strings read better on one line

darukade_mcp-0.1.0/server.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.sepehr071/darukade-mcp",
+  "title": "Darukade Pharmacy",
+  "description": "Read-only Darukade (darukade.com) pharmacy: products, prices, ingredients, usage, reviews.",
+  "repository": {
+    "url": "https://github.com/sepehr071/darukade-mcp",
+    "source": "github"
+  },
+  "websiteUrl": "https://github.com/sepehr071/darukade-mcp",
+  "version": "0.1.0",
+  "packages": [
+    {
+      "registryType": "pypi",
+      "registryBaseUrl": "https://pypi.org",
+      "identifier": "darukade-mcp",
+      "version": "0.1.0",
+      "runtimeHint": "uvx",
+      "transport": {
+        "type": "stdio"
+      },
+      "environmentVariables": [
+        {
+          "name": "DARUKADE_MCP_PROXY",
+          "description": "Optional HTTP proxy URL for the Darukade requests; system proxy settings are ignored. Also accepts a comma-separated list: one is used until it gets blocked or fails to connect, then the next.",
+          "isRequired": false,
+          "isSecret": false
+        }
+      ]
+    }
+  ]
+}

darukade_mcp-0.1.0/src/darukade_mcp/__init__.py

@@ -0,0 +1,5 @@
+"""Unofficial MCP server for Darukade (darukade.com), an Iranian online pharmacy: product search, prices, ingredients."""
+
+from importlib.metadata import version
+
+__version__ = version("darukade-mcp")

darukade_mcp-0.1.0/src/darukade_mcp/http.py

@@ -0,0 +1,253 @@
+"""Shared async HTTP client for darukade.com (Next.js pages with __NEXT_DATA__, plus two small JSON endpoints).
+
+Every tool goes through `fetch_page` / `fetch_json`, which cap concurrency, cache answers briefly and turn HTTP
+failures into `ToolError` messages the model can act on.
+"""
+
+from __future__ import annotations
+
+import asyncio
+import copy
+import json as json_lib
+import os
+import random
+import re
+import time
+from typing import Any
+
+import httpx
+from curl_cffi.const import CurlOpt
+from httpx_curl_cffi import AsyncCurlTransport
+from mcp.server.mcpserver.exceptions import ToolError
+
+SITE = "https://darukade.com"
+# Only this host is ever called; it doubles as the allowlist.
+HOSTS = {"darukade.com"}
+
+HEADERS = {
+    # User-Agent, sec-ch-ua and TLS come from the impersonated Chrome profile (see _get_client).
+    "Accept-Language": "fa-IR,fa;q=0.9,en;q=0.8",
+}
+PAGE_HEADERS = {
+    "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8",
+    "sec-fetch-dest": "document",
+    "sec-fetch-mode": "navigate",
+    "sec-fetch-site": "same-origin",
+    "Referer": f"{SITE}/",
+}
+JSON_HEADERS = {
+    # The site's own fetch() calls (checked in Chrome 2026-10-31): same-origin, Accept */*.
+    "Accept": "*/*",
+    "sec-fetch-dest": "empty",
+    "sec-fetch-mode": "cors",
+    "sec-fetch-site": "same-origin",
+    "priority": "u=1, i",
+    "Referer": f"{SITE}/",
+}
+
+MAX_CONCURRENCY = 3
+JITTER = (0.1, 0.4)  # seconds before each uncached call
+MAX_RETRIES = 2
+MAX_RETRY_WAIT = 10  # cap for Retry-After and backoff, seconds
+CACHE_TTL = 120  # seconds; prices and stock change slowly
+CACHE_MAX = 64
+RETRY_DELAY = 0.5  # seconds, doubled per retry
+MAX_BODY = 5_000_000  # bytes; larger responses are refused
+
+_transport: httpx.AsyncBaseTransport | None = None
+_client: httpx.AsyncClient | None = None
+_limit: asyncio.Semaphore | None = None
+_proxy_index = 0
+_retired: set[asyncio.Task] = set()
+_cache: dict[tuple, tuple[float, Any]] = {}
+_NEXT_DATA = re.compile(r'<script id="__NEXT_DATA__"[^>]*>(.*?)</script>', re.S)
+
+
+class _XhrTransport(AsyncCurlTransport):
+    """The Chrome profile sends navigation-only headers; a None value makes curl drop them on XHR calls."""
+
+    def _create_request_params(self, req: httpx.Request) -> dict[str, Any]:
+        # The parent drops "accept: */*" as an httpx default; curl would then send Chrome's page Accept instead.
+        accept = req.headers.get("accept")
+        p = super()._create_request_params(req)
+        extra = [(b"cache-control", None)]  # Chrome sends max-age=0 only on a reload
+        if req.headers.get("sec-fetch-mode") != "navigate":
+            extra += [(b"upgrade-insecure-requests", None), (b"sec-fetch-user", None)]
+        p["headers"] = [*p["headers"], *extra, *([(b"accept", b"*/*")] if accept == "*/*" else [])]
+        return p
+
+
+class ApiError(ToolError):
+    """A failed upstream call. `status` is the HTTP status, or None for network errors."""
+
+    def __init__(self, message: str, status: int | None = None):
+        super().__init__(message)
+        self.status = status
+
+
+def set_transport(transport: httpx.AsyncBaseTransport | None) -> None:
+    """Swap the transport (tests use httpx.MockTransport). Drops the current client."""
+    global _transport, _client, _limit, _proxy_index
+    _transport, _client, _limit, _proxy_index = transport, None, None, 0
+    _cache.clear()
+
+
+def _proxies() -> list[str]:
+    """DARUKADE_MCP_PROXY: one proxy URL, or a comma-separated list used one at a time."""
+    return [p.strip() for p in os.environ.get("DARUKADE_MCP_PROXY", "").split(",") if p.strip()]
+
+
+def _next_proxy(client: httpx.AsyncClient) -> None:
+    """Sticky pool: move to the next proxy after a block or connect error; the next call rebuilds the client.
+
+    Only the client that failed may rotate. The old client is closed late because other requests may still use it.
+    """
+    global _client, _limit, _proxy_index
+    if len(_proxies()) < 2 or client is not _client:
+        return
+    _client, _limit, _proxy_index = None, None, _proxy_index + 1
+    t = asyncio.create_task(_close_later(client))
+    _retired.add(t)
+    t.add_done_callback(_retired.discard)
+
+
+async def _close_later(client: httpx.AsyncClient) -> None:
+    await asyncio.sleep(30)  # longer than the 20 s request timeout
+    await client.aclose()
+
+
+def _get_client() -> tuple[httpx.AsyncClient, asyncio.Semaphore]:
+    global _client, _limit
+    if _client is None:
+        # System proxy settings are ignored; the proxy only comes from DARUKADE_MCP_PROXY. curl_cffi presents
+        # Chrome's TLS/HTTP2 fingerprint and default headers. The proxy goes to the transport.
+        proxies = _proxies()
+        _client = httpx.AsyncClient(
+            transport=_transport
+            or _XhrTransport(
+                impersonate="chrome",
+                default_headers=True,
+                curl_options={
+                    CurlOpt.NOPROXY: "*"
+                },  # httpx-curl-cffi drops its own NOPROXY unless this dict is non-empty
+                proxy=proxies[_proxy_index % len(proxies)] if proxies else None,
+                max_connections=2 * MAX_CONCURRENCY,
+            ),
+            headers=HEADERS,
+            timeout=httpx.Timeout(20, connect=5),
+            limits=httpx.Limits(max_connections=2 * MAX_CONCURRENCY),
+            follow_redirects=False,
+            trust_env=False,
+        )
+        _limit = asyncio.Semaphore(MAX_CONCURRENCY)
+    assert _limit is not None
+    return _client, _limit
+
+
+async def fetch_page(path: str, params: dict[str, Any] | None = None) -> dict:
+    """GET a site page and return its Next.js `pageProps` (the server-rendered data)."""
+    html = await _fetch(path, params, PAGE_HEADERS)
+    m = _NEXT_DATA.search(html)
+    if not m:
+        raise ApiError("darukade.com returned a page without data (layout changed or blocked).")
+    try:
+        props = json_lib.loads(m.group(1))["props"]["pageProps"]
+    except (ValueError, KeyError) as e:
+        raise ApiError("darukade.com page data could not be read.") from e
+    return props
+
+
+async def fetch_json(path: str, params: dict[str, Any] | None = None) -> Any:
+    """GET one of the site's /api/ JSON endpoints."""
+    text = await _fetch(path, params, JSON_HEADERS)
+    try:
+        return json_lib.loads(text)
+    except ValueError as e:
+        raise ApiError("darukade.com returned a non-JSON response.") from e
+
+
+async def _fetch(path: str, params: dict[str, Any] | None, headers: dict[str, str]) -> str:
+    """Cached GET with retries; returns the response body text. Retried on timeout, network error, 5xx or 429."""
+    query = dict(params or {})
+    url = SITE + path
+    host = httpx.URL(url).host
+    if host not in HOSTS:
+        raise ApiError(f"Refusing to call unexpected host {host}.")
+    key = (url, tuple(sorted(query.items())), headers["Accept"])
+    if (hit := _cache.get(key)) and time.monotonic() - hit[0] < CACHE_TTL:
+        return copy.copy(hit[1])
+    for attempt in range(MAX_RETRIES + 1):
+        last = attempt == MAX_RETRIES
+        wait = RETRY_DELAY * 2**attempt * random.uniform(1, 1.5)
+        try:
+            r, content = await _request(url, query, headers, host)
+        except ApiError as e:
+            if last or e.status is not None:
+                raise
+            await asyncio.sleep(min(wait, MAX_RETRY_WAIT))
+            continue
+        if (r.status_code == 429 or r.status_code >= 500) and not last:
+            await asyncio.sleep(min(_retry_after(r) or wait, MAX_RETRY_WAIT))
+            continue
+        break
+    if r.status_code >= 400:
+        raise ApiError(_status_message(r, host), r.status_code)
+    text = content.decode("utf-8", "replace")
+    if len(_cache) >= CACHE_MAX:
+        _cache.pop(next(iter(_cache)))
+    _cache[key] = (time.monotonic(), text)
+    return text
+
+
+async def _send(client, limit, url, query, headers, host) -> tuple[httpx.Response, bytes]:
+    try:
+        async with limit:
+            await asyncio.sleep(random.uniform(*JITTER))
+            async with client.stream("GET", url, params=query, headers=headers) as r:
+                return r, await _read_capped(r, host)
+    except httpx.TimeoutException as e:
+        raise ApiError(f"{host} did not answer in time. Try again in a moment.") from e
+    except httpx.RequestError as e:
+        if isinstance(e, httpx.ConnectError | httpx.ProxyError):
+            _next_proxy(client)
+        raise ApiError(
+            f"Could not reach {host} ({type(e).__name__}). Check the internet connection "
+            "(or the DARUKADE_MCP_PROXY setting if you use one)."
+        ) from e
+
+
+async def _request(url, query, headers, host) -> tuple[httpx.Response, bytes]:
+    client, limit = _get_client()
+    r, content = await _send(client, limit, url, query, headers, host)
+    if r.status_code in (403, 429):
+        _next_proxy(client)  # blocked: try the next proxy on the following call
+    return r, content
+
+
+async def _read_capped(r: httpx.Response, host: str) -> bytes:
+    """Read the body, refusing anything over MAX_BODY so one huge answer cannot flood memory or context."""
+    buf = bytearray()
+    async for chunk in r.aiter_bytes():
+        buf += chunk
+        if len(buf) > MAX_BODY:
+            raise ApiError(f"{host} sent a response over {MAX_BODY // 1_000_000} MB; refused.", r.status_code)
+    return bytes(buf)
+
+
+def _retry_after(r: httpx.Response) -> float | None:
+    """Seconds from a numeric Retry-After on a 429/503, else None (HTTP-date form is ignored)."""
+    v = r.headers.get("retry-after", "")
+    return float(v) if r.status_code in (429, 503) and v.replace(".", "", 1).isdigit() else None
+
+
+def _status_message(r: httpx.Response, host: str) -> str:
+    code = r.status_code
+    if code == 403:
+        return f"{host} blocked the request (HTTP 403). Try another network or set DARUKADE_MCP_PROXY."
+    if code == 404:
+        return f"{host} found nothing at that address (HTTP 404). Check the id or filters, or the page number."
+    if code == 429:
+        return f"{host} is rate limiting requests (HTTP 429). Wait a minute before retrying."
+    if code >= 500:
+        return f"{host} had a server error (HTTP {code}). Try again later."
+    return f"{host} rejected the request (HTTP {code})."