صورت مالی کدال با هوش مصنوعی: سود، EPS و گزارش ماهانه شرکت‌ها

شرکتی که سهمش را دارید گزارش شش‌ماهه داده و می‌خواهید بدانید سودش واقعاً بالا رفته یا فقط درآمدش. در کدال باید نماد را در فرم جستجو بزنید، اطلاعیهٔ درست را از میان ده‌ها اطلاعیهٔ دیگر پیدا کنید و جدولی را بخوانید که هر برگه‌اش صفحهٔ جدایی دارد و عددهای منفی‌اش داخل پرانتز است. با سرور MCP «کدال» صورت مالی کدال را با هوش مصنوعی می‌خوانید: دستیار اطلاعیه را با نماد و نوعش پیدا می‌کند، جدول سود و زیان یا ترازنامه را ردیف به ردیف می‌خواند و جواب را به فارسی می‌نویسد.

این سرور فقط می‌خواند، کلید API و حساب کاربری لازم ندارد و ۵ قابلیت دارد: پیدا کردن شرکت، جستجوی اطلاعیه‌ها، خواندن یک اطلاعیه، فهرست نوع‌های اطلاعیه و تاریخ‌های پایان سال مالی.

خواندن صورت مالی کدال: آخرین گزارش یک شرکت را چطور بگیریم

لازم نیست شناسهٔ نوع اطلاعیه یا شمارهٔ پیگیری را بدانید. کافی است بنویسید چه می‌خواهید، مثلاً «سود خالص فولاد در شش ماه اول امسال نسبت به پارسال چقدر تغییر کرد؟». دستیار معمولاً سه قدم برمی‌دارد:

1. با cd_company شرکت را با نماد یا نام پیدا می‌کند. حدود ۵٬۴۰۰ ناشر در کدال هست، از جمله شرکت‌ها و صندوق‌هایی که در بورس نیستند.
2. با cd_search_letters اطلاعیه را می‌جوید: نوع اطلاعیهٔ «صورت‌های مالی میان‌دوره‌ای و سالانه» و طول دورهٔ ۶ ماه برای گزارش شش‌ماهه، یا ۱۲ ماه برای گزارش سالانه. جدیدترین اطلاعیه‌ها اول می‌آیند.
3. با cd_letter همان اطلاعیه را با شمارهٔ پیگیری‌اش باز می‌کند و جدول سود و زیان را می‌خواند.

جواب معمولاً این شکل را دارد (قالب نمونه، بدون عدد واقعی):

• نام شرکت، دورهٔ گزارش و تاریخ انتشار اطلاعیه: …
• درآمد عملیاتی و سود خالص، به میلیون ریال: …
• سود پایهٔ هر سهم، به ریال: …
• درصد تغییر نسبت به همین دورهٔ سال قبل: …
• درصد تغییر نسبت به آخرین سال مالی کامل: …

جدول سود و زیان در کدال دو ستون «درصد تغییر» دارد و این دو را نباید با هم قاطی کرد. اولی دوره را با همان دوره در سال قبل مقایسه می‌کند، مثلاً شش ماه امسال با شش ماه پارسال. دومی آن را با کل سال مالی گذشته می‌سنجد. اگر دستیار عددی گفت و معلوم نبود از کدام ستون است، بپرسید.

ترازنامه و برگه‌های دیگر همان اطلاعیه

صورت مالی در کدال چند برگه است: سود و زیان، سود و زیان جامع، ترازنامه، تغییرات حقوق مالکانه، جریان وجوه نقد و صفحه‌های گزارش تفسیری. جواب cd_letter فهرست برگه‌ها را هم دارد، پس بعد از سود و زیان کافی است بنویسید «حالا ترازنامهٔ همین گزارش را بخوان». دستیار برگهٔ دیگری از همان اطلاعیه را باز می‌کند و دوباره جستجو نمی‌کند. پیوند PDF و فایل اکسل اطلاعیه هم در جواب هست، اگر خواستید جدول را خودتان باز کنید.

سود هر سهم را از کدال بپرسید

سود هر سهم (EPS) در همان برگهٔ سود و زیان است و به ریال برمی‌گردد، نه میلیون ریال. اگر سال مالی شرکت را نمی‌دانید، دستیار با cd_financial_years تاریخ‌های پایان سال مالی را به شمسی می‌گیرد و می‌فهمد گزارش سالانهٔ کدام سال را باید بجوید. برای شرکتی که سال مالی‌اش آخر اسفند تمام نمی‌شود، این قدم جلوی مقایسهٔ اشتباه را می‌گیرد.

گزارش فعالیت ماهانه (فروش و تولید) را بپرسید

گزارش فعالیت ماهانه هر ماه منتشر می‌شود و برای دنبال کردن فروش یک شرکت در طول سال کاربرد دارد. سرور این گزارش‌ها را هم جدول به جدول می‌خواند: خرید مواد اولیه، تولید و فروش به تفکیک محصول، مصرف انرژی و منابع و مصارف ارزی.

چه می‌خواهید	دستیار سراغ چه اطلاعیه‌ای می‌رود	چه برمی‌گردد
سود شش‌ماهه یا سالانه	صورت‌های مالی، دورهٔ ۶ یا ۱۲ ماه	سود و زیان، ترازنامه و برگه‌های دیگر
فروش و تولید ماه‌به‌ماه	گزارش فعالیت ماهانه	فروش و تولید هر محصول، مواد اولیه، انرژی
سود نقدی مصوب	تصمیمات مجمع عمومی عادی سالانه	متن تصمیم‌ها
زمان پرداخت سود	جدول زمان‌بندی پرداخت سود	زمان‌بندی پرداخت
خبر مهم یک شرکت	اطلاعات و رویدادهای بااهمیت	متن اطلاعیه

چند نمونه سؤال:

• «فروش سه ماه آخر ایران خودرو را از گزارش‌های ماهانه‌اش دربیاور و بگو کدام ماه بیشتر بود.»
• «در گزارش ماهانهٔ آخر فولاد، فروش صادراتی چه سهمی از کل فروش داشته؟»
• «امروز کدام شرکت‌ها گزارش فعالیت ماهانه منتشر کرده‌اند؟»

سؤال آخر نماد ندارد؛ وقتی جستجو فیلتر نماد نداشته باشد، تازه‌ترین اطلاعیه‌های کل بازار می‌آید. یادتان باشد هر گزارش ماهانه یک اطلاعیهٔ جداست و خواندن هرکدام یک درخواست به کدال است. مقایسهٔ سه ماه بهتر از دوازده ماه جواب می‌دهد (دلیلش را پایین‌تر می‌بینید).

تصمیمات مجمع و جدول تقسیم سود

بعد از مجمع عمومی عادی سالانه، شرکت تصمیم‌های آن را در کدال منتشر می‌کند و معمولاً سود نقدی مصوب هر سهم هم در همین اطلاعیه است. جدول زمان‌بندی پرداخت سود اطلاعیهٔ جدایی است. پس اگر می‌پرسید «سود فولاد کی واریز می‌شود؟»، دستیار باید سراغ اطلاعیهٔ دوم برود.

اطلاعیه‌های کدال در ۱۱ گروه دسته‌بندی شده‌اند. چند گروهی که بیشتر به کار سهام‌دار می‌آید:

• صورت‌های مالی، گزارش هیئت‌مدیره و جدول پرداخت سود
• اطلاعات بااهمیت و پیش‌بینی سود هر سهم
• گزارش فعالیت ماهانه و صورت وضعیت پورتفوی
• دعوت و تصمیم‌های مجامع
• افزایش سرمایه

اگر نمی‌دانید یک اطلاعیه در کدام گروه است، بپرسید «در کدال چه نوع اطلاعیه‌هایی دربارهٔ افزایش سرمایه هست؟». دستیار با cd_letter_types فهرست گروه‌ها و نوع‌ها را می‌گیرد و بعد جستجو می‌کند.

کدال و TSETMC: اطلاعیه در برابر قیمت

کدال چیزی را نشان می‌دهد که شرکت دربارهٔ خودش منتشر می‌کند: صورت مالی، گزارش ماهانه، مجمع و خبر مهم. قیمت سهم، دفتر سفارش، پول حقیقی و شاخص در سایت TSETMC است و این سرور هیچ‌کدام را ندارد. برای تصویر کامل یک سهم، هر دو را کنار هم داشته باشید.

یک مثال: P/E از تقسیم قیمت بر سود هر سهم به دست می‌آید. سود هر سهم را این سرور از صورت مالی کدال می‌آورد و قیمت را سرور «بورس تهران و فرابورس». با هر دو سرور در یک گفتگو، دستیار هر دو عدد را می‌گیرد و حساب را جلوی چشمتان انجام می‌دهد. برای خواندن پول حقیقی و صف خرید، راهنمای تحلیل سهام بورس با هوش مصنوعی را ببینید.

چرا کدال جواب نمی‌دهد: اینترنت خارج و محدودیت درخواست

کدال معمولاً به درخواست‌هایی که از بیرون ایران می‌رسند جواب نمی‌دهد و درخواست تا تمام شدن مهلتش منتظر می‌ماند. برای همین روتر MCP بازارچه این سرور را از یک سرور داخل ایران اجرا می‌کند. اگر روی کامپیوتر خودتان نصبش کنید و فیلترشکن روشن باشد، احتمالاً همین مشکل را می‌بینید.

محدودیت دوم مال خود کدال است. بعد از چند درخواست پشت سر هم، خطای ۴۲۹ و کپچا نشان می‌دهد و ممکن است آن نشانی را تا یک ساعت ببندد. سرور برای اینکه کار به آنجا نکشد:

• درخواست‌ها را یکی‌یکی و با فاصلهٔ دست‌کم ۲ ثانیه می‌فرستد.
• فهرست شرکت‌ها و نوع اطلاعیه‌ها را ۱۲ ساعت، هر اطلاعیه را یک ساعت و نتیجهٔ جستجو را ۲ دقیقه نگه می‌دارد.
• خطای ۴۲۹ را دوباره امتحان نمی‌کند و بعد از هر مسدودی یک دقیقه سراغ کدال نمی‌رود.
• کپچا را حل نمی‌کند.

در روتر، درخواست همهٔ کاربران از یک نشانی ایرانی به کدال می‌رسد. پس اگر دستیار گفت کدال فعلاً جواب نمی‌دهد، کمی بعد دوباره بپرسید؛ اگر کدال نشانی را بسته باشد، ممکن است تا یک ساعت طول بکشد. سؤال دقیق («صورت مالی شش‌ماههٔ ۱۴۰۵ فولاد») هم کار را با یکی دو درخواست تمام می‌کند و سؤال کلی («همهٔ گزارش‌های امسال این ده شرکت») ده‌ها درخواست لازم دارد.

اتصال کدال به ChatGPT و Claude

ساده‌ترین راه روتر MCP است:

1. اتصال دستیار را باز کنید و برنامه‌ای را که با آن گفتگو می‌کنید انتخاب کنید.
2. مراحل را دنبال کنید. نصب، کلید API و پراکسی لازم نیست.
3. بپرسید: «آخرین صورت مالی فولاد در کدال چه بود؟»

اگر می‌خواهید بدون ساختن حساب امتحان کنید، این سرور در امتحان رایگان هم هست. اگر با MCP آشنا نیستید، راه‌اندازی MCP در ۱۰ دقیقه قدم‌به‌قدم توضیح می‌دهد.

برای اجرا روی کامپیوتر خودتان، در تنظیمات برنامه یک سرور stdio با دستور uvx codal-mcp بسازید (به ابزار uv نیاز دارد). در Claude Code همین کار با claude mcp add codal -- uvx codal-mcp انجام می‌شود. اگر اینترنتتان ایرانی نیست، متغیر اختیاری CODAL_MCP_PROXY را با نشانی یک پراکسی HTTP با خروجی ایران پر کنید؛ چند نشانی را می‌شود با ویرگول انگلیسی جدا کرد تا اگر یکی جواب نداد، بعدی کار کند. پراکسی تنظیم‌شده در سیستم را این سرور نادیده می‌گیرد. فهرست کامل قابلیت‌ها در صفحهٔ این ابزار است.

پیش از تکیه بر عددها این نکته‌ها را بدانید

• مبلغ‌ها همان‌طور که شرکت منتشر کرده برمی‌گردند، معمولاً به میلیون ریال. برای تومان، عدد را بر ده تقسیم کنید.
• عددهای منفی که کدال داخل پرانتز نشان می‌دهد، با علامت منفی برمی‌گردند.
• تاریخ‌ها شمسی و به وقت تهران است.
• پیوست‌های اطلاعیه فقط فهرست می‌شوند و دستیار محتوایشان را نمی‌خواند.
• متن طولانی یک اطلاعیه کوتاه می‌شود؛ برای متن کامل، پیوند PDF را باز کنید.
• سرور غیررسمی است و از همان جستجو و صفحه‌هایی استفاده می‌کند که سایت کدال استفاده می‌کند. اگر سایت تغییر کند، ممکن است بخشی از داده‌ها موقتاً نیاید.
• اگر سرور را روی کامپیوتر خودتان نصب کنید، دستیار معمولاً آخر جواب یک خط معرفی سازنده هم می‌آورد.
• این داده‌ها برای اطلاع است، نه توصیهٔ خرید یا فروش سهم.

برای وضع کل بازار در کنار گزارش‌های شرکت، شاخص کل بورس با هوش مصنوعی را بخوانید. دفعهٔ بعد که شرکتی گزارش داد، به‌جای گشتن در فرم کدال، اتصال دستیار را باز کنید و همان سؤالتان را بپرسید.