Torob logo

Torob

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

Overview

Publishersepehr071
Repositoryawesome-iran-mcp
Skill nametorob
Stars
146
Forks
17
Bundled files
Instructions only
LicenseMIT
Links
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • Self-contained

    Everything the model needs lives in the instructions — no extra files to sync.

  • Open source

    Published by sepehr071 on GitHub. Read the source before you install it.

Installation

Install the Torob AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
    https://github.com/sepehr071/awesome-iran-mcp/tree/main/plugins/torob/skills/torob
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/sepehr071/awesome-iran-mcp.git /tmp/awesome-iran-mcp
mkdir -p .claude/skills
cp -r /tmp/awesome-iran-mcp/plugins/torob/skills/torob .claude/skills/torob
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Torob in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Torob on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Torob is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

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

Frequently asked questions

What does the Torob AI skill do?

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.

Why use Torob on TypingMind?

Because you install it once and use it with any model. Torob is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Torob in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/sepehr071/awesome-iran-mcp/tree/main/plugins/torob/skills/torob. TypingMind reads its SKILL.md and installs it as a skill you can enable per chat.

Which AI models can use Torob?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Torob?

As many as you like. As long as a model supports skills, you can use Torob with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Torob AI skill free?

Yes. It is published on GitHub by sepehr071 under the MIT license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇