sepehr071/iran-mcp/torob

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. 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.