torob git:20261018.b8233e0A

Immutable. This exact content never changes and is served at /api/v1/blob/bb310fce3fc2d210.

---
name: torob
description: "Unofficial read-only Torob: compare Iranian shop prices, price history, deal checks and baskets. Use when the user asks about Torob (torob.com) or wants electronics, appliances or other goods in Iran."
---

# Torob

Unofficial read-only Torob: compare Iranian shop prices, price history, deal checks and baskets.

The tools below come from the `torob-mcp` MCP server. If they are not available, install it with `claude mcp add torob -- uvx torob-mcp`, or add `"torob": {"command": "uvx", "args": ["torob-mcp"]}` to the client's MCP servers config. It needs [uv](https://docs.astral.sh/uv/). Restart the session after installing.

## Tools

- `tb_cheapest`: Cheapest trustworthy offer for a product named in words: searches, then looks at every shop's offer.
- `tb_compare`: Side-by-side comparison of 2-5 products: only the specs that differ, the price window, and which is cheapest.
- `tb_best_value`: Ranked product picks that fit a budget (Toman), for "best phone under 30 million".
- `tb_deal_check`: Is this a good price? Score 0-100 from the product's price history and today's competing offers.
- `tb_basket`: Cheapest shop for a whole shopping list: best single shop that sells everything, and the split-cart total.
- `tb_product`: Full record of one product: name, price range across shops (Toman), category path, brand, key specs, cheapest offer.
- `tb_sellers`: Every online shop offer for a product, cheapest first, with trust, warranty, installment and delivery info.
- `tb_stores`: In-person (offline) shops that stock a product: address, opening hours, open now, shelf price and its age.
- `tb_presence`: How widely a product is sold: online shops, in-person stores, installment shops, Torob-warranty shops, price window.
- `tb_variants`: Sibling variants of a product (storage + RAM, colour, region ...) each with its own cheapest price.
- `tb_price_chart`: Price chart of a product (about a year, weekly): minimum and average price in Toman, with a buy-now verdict.
- `tb_price_history`: Notable price moves of a product, newest first: drops, rises, lowest and highest point, last change.
- `tb_similar`: Products Torob shows as similar (alternatives in the same class), with cheapest price and shop count.
- `tb_product_url`: Clean torob.com URL for a product id, '/p/<id>/...' path or any torob.com product link (no request is sent).
- `tb_products_batch`: Short records (name, price window, shop counts, category, brand) for up to 10 products at once.
- `tb_search`: Search Torob for products; each card has the cheapest shop price (Toman), shop count, image and URL.
- `tb_suggest`: Torob's own autocomplete: up to 8 search phrases for the typed text (also fixes Finglish and colloquial wording).
- `tb_filters`: Which filters exist for a query/category: category children, brands, price span, sort options, attributes.
- `tb_category`: A category page: where it sits in the tree, its sub-categories, and its top products.
- `tb_brands`: All brands of a category with their ids (for tb_search brand=).
- `tb_trends`: What people search on Torob right now, each with the category it lands in and one sample product.
- `tb_offers`: Torob's special-offers feed ("پیشنهاد ویژه"): themed rows with discounted or promoted products.
- `tb_cities`: City ids for the `city` filter of tb_search, tb_sellers and tb_stores (392 Tehran, 468 Mashhad, 240 Isfahan).
- `tb_shop`: A shop's trust profile: score and votes, e-Namad seal, time on Torob, city, website, delivery and payment terms.
- `tb_find_shops`: Find shops in Torob's directory by name or domain; returns ids for tb_shop and tb_shop_products.
- `tb_shop_products`: Products one shop sells on Torob, with the price range of the page.

## Rules

- Prices are Toman. Convert before comparing with a Rial figure from anywhere else.
- Read-only: no login, basket, booking, order or payment. Give the user the link to finish on the site.
- Keep request rates low. These are undocumented site APIs that can change or rate-limit.
- On timeouts or HTTP 403 outside Iran, set `TOROB_MCP_PROXY` to an HTTP proxy with an Iranian IP.
- Torob blocks bursts of calls from one IP (HTTP 490), so calls are spaced 2 s apart. Ask for a few products at a time and do not repeat a search the user did not ask for.