torob

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.

SKILL.md

GitHub

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.