# بورس کالای ایران (IME MCP)

معاملات، قیمت و اطلاعیهٔ عرضهٔ بورس کالای ایران: فولاد، پتروشیمی، سیمان، فرآورده‌های نفتی، گواهی طلا و سکه، اختیار معامله و آمار بازار

- نوع: سرور MCP
- دسته: بازار مالی و ارز
- منبع: ساختهٔ بازارچه
- سازنده: sepehr071 (https://github.com/sepehr071)
- مجوز: MIT
- زبان: Python
- آخرین بررسی: 2026-11-04
- صفحه: https://mcpfarsi.ir/servers/ime/
- مخزن: https://github.com/sepehr071/ime-mcp
- وب‌سایت سرویس: https://www.ime.co.ir

## هشدارها

- فقط از IP ایران: فقط از داخل ایران (با IP ایران) کار می‌کند.
- اتصال با API غیررسمی: از راه رسمی وصل نمی‌شود و ممکن است ناگهان از کار بیفتد.

## نصب

- اجرا (stdio): `uvx ime-mcp`
- متغیر محیطی `IME_MCP_PROXY` (اختیاری): اختیاری: نشانی یک پراکسی HTTP (سرور واسط) که به سایت بورس کالا دسترسی دارد؛ چند نشانی را می‌شود با ویرگول جدا کرد

## ابزارها

- `ime_categories`: فهرست گروه‌های کالایی بورس (گروه اصلی، گروه و زیرگروه، مثل میلگرد و ورق گرم) با شناسهٔ هرکدام
- `ime_producers`: پیدا کردن تولیدکننده یا عرضه‌کننده با نام، برای گرفتن شناسه‌اش در قابلیت‌های معاملات و عرضه
- `ime_trades`: معاملات بازار فیزیکی، بازار فرعی، تالار صادراتی کیش یا قراردادهای پریمیوم در یک بازه (تا ۴۵ روز) با قیمت پایانی میانگین موزون، کمترین و بیشترین، عرضه، تقاضا، حجم، ارزش، تولیدکننده و کارگزار
- `ime_supply`: اطلاعیهٔ عرضه: چه کالایی در جلسه‌های پیش‌رو عرضه می‌شود، با حجم، قیمت پایه، محل و زمان تحویل و کارگزار (پیش‌فرض: امروز تا ۷ روز بعد)
- `ime_price_history`: روند روزانهٔ قیمت هر نماد کالایی (کمترین، بیشترین، میانگین موزون و حجم) تا ۴۵ روز؛ پیش‌فرض ۱۴ روز اخیر
- `ime_market_summary`: ارزش و حجم معاملات کل بورس کالا به تفکیک بازار و تالار، همراه با نرخ دلار تسویهٔ بورس
- `ime_daily_totals`: ارزش و حجم معاملات روزبه‌روز یک بازار در یک بازهٔ زمانی
- `ime_news`: آخرین خبرها و اطلاعیه‌های بورس کالا با عنوان، خلاصه، تاریخ و پیوند
- `ime_trade_stats`: رتبه‌بندی تولیدکننده‌ها، کالاها، کارگزارها یا تالارها بر اساس ارزش معامله، با سهم هرکدام از بازار
- `ime_weekly_reports`: فهرست گزارش‌های هفتگی بورس کالا با پیوند PDF هرکدام (متن PDF را نمی‌خواند)
- `ime_options`: تابلوی اختیار معامله روی طلا، سکه، صندوق‌های طلا و آتی زعفران، یا سابقهٔ یک قرارداد
- `ime_securities`: معاملات روزانهٔ سلف استاندارد، گواهی سپردهٔ کالایی (مثل زعفران) و صندوق‌های کالایی
- `ime_certificates`: گواهی سپردهٔ پیوستهٔ شمش طلا، سکه، نقره، مس، فولاد و غیره: آخرین روز همه، یا سابقهٔ روزانهٔ یکی تا ۹۰ روز
- `ime_board`: تابلوی صندوق‌ها، گواهی‌ها و سلف با بهترین قیمت خرید و فروش؛ در ساعت معامله زنده و بعد از آن آخرین جلسه

## نمونه سؤال‌ها

- قیمت ورق گرم در بورس کالا طی یک ماه اخیر چه روندی داشته؟ کمترین و بیشترینش را هم بگو.
- فردا در بورس کالا چه میلگردهایی عرضه می‌شود و قیمت پایه‌شان چقدر است؟
- امروز بزرگ‌ترین معاملات بازار فیزیکی بورس کالا مال کدام کالاها و تولیدکننده‌ها بود؟
- نرخ دلار تسویهٔ بورس کالا و ارزش کل معاملات این هفته چقدر بوده؟
- گواهی سپردهٔ سکهٔ طلا در آخرین روز معاملاتی به چه قیمتی معامله شد؟

## توضیحات

بورس کالای ایران جایی است که فولاد، محصولات پتروشیمی، سیمان، قیر و فرآورده‌های نفتی، فلزات و کالاهای کشاورزی عرضه و معامله می‌شوند. سایت ime.co.ir این اطلاعات را در جدول‌های جدا و با فیلترهای زیاد نشان می‌دهد. این سرور همان داده‌های عمومی را برای دستیار هوش مصنوعی شما می‌خواند: معاملات هر روز با قیمت و حجم، اطلاعیه‌های عرضهٔ جلسه‌های آینده، روند قیمت یک کالا، رتبه‌بندی تولیدکننده‌ها و کارگزارها، ارزش کل بازار و نرخ دلار تسویه، و در کنارش گواهی سپردهٔ طلا و سکه و نقره، سلف، صندوق‌های کالایی و تابلوی اختیار معامله.

مسیر معمول این است: دستیار اول با `ime_categories` یا `ime_producers` شناسهٔ گروه کالا یا تولیدکننده را پیدا می‌کند، بعد با `ime_trades`، `ime_supply` یا `ime_price_history` معاملات، عرضه‌ها یا روند قیمت را می‌آورد. برای پرسش‌های ساده مثل «قیمت ورق گرم» جستجو با نام کالا هم کافی است.

#### نکته‌ها

- فقط اطلاعات را می‌خواند: ورود به حساب، ثبت سفارش و معامله ندارد. کلید API یا حساب کاربری لازم ندارد.
- غیررسمی است (سازنده‌اش بورس کالای ایران نیست) و ۱۴ قابلیت دارد.
- سایت بورس کالا فقط از اینترنت ایران جواب می‌دهد. خارج از ایران، `IME_MCP_PROXY` را روی یک پراکسی با دسترسی به سایت بگذارید. تنظیمات پراکسی سیستم نادیده گرفته می‌شود.
- تاریخ‌ها شمسی است (مثل 1405/08/09) و تاریخ میلادی هم پذیرفته می‌شود. روزهای معاملاتی شنبه تا چهارشنبه و بعضی پنجشنبه‌هاست؛ روزهای دیگر نتیجه‌ای ندارند.
- واحدها یکسان نیستند: قیمت کالاهای تنی به ریال برای هر کیلوگرم است، خلاصهٔ بازار به میلیون ریال و عرضه‌های تالار صادراتی به دلار. ردیف‌های بازار فرعی قیمت و ارزش ندارند، فقط قیمت پایه، عرضه، تقاضا و حجم.
- هر بازه حداکثر ۴۵ روز است (برای سابقهٔ یک گواهی ۹۰ روز). جواب‌ها تا دو دقیقه کش می‌شوند و فهرست معاملات گاهی کند می‌آید؛ این داده لحظه‌به‌لحظه نیست.
- تابلوهای مسکن و خودرو، زیرسایت‌های بورسی و آرشیو گزارش‌های آماری پوشش داده نمی‌شوند. گزارش‌های هفتگی فقط با پیوند PDF می‌آیند و متنشان خوانده نمی‌شود.
- برای سهام بورس تهران و فرابورس از «بورس تهران و فرابورس» و برای قیمت خرد طلای آب‌شده از «مقایسهٔ قیمت طلای آب‌شده» استفاده کنید.
- اطلاعات برای آگاهی است، نه توصیهٔ خرید و فروش.