Codal (کدال) Disclosures

codal-mcp：AI エージェント向け Codal（کدال）開示情報・財務諸表 MCP サーバー

codal-mcp を使うと、AI エージェントはイラン上場企業の公式開示システムである Codal を検索して読み取れます。
Codal（codal.ir、سامانه جامع اطلاع‌رسانی ناشران）は、テヘラン証券取引所、Iran Fara Bourse
およびその他のイランの取引所に上場する企業やファンドが、財務諸表、月次活動報告、会議の決議、重要ニュースを公開する場所です。
codal-mcp は、これらの書類をテキストや表に変換し、Claude、Cursor、Copilot で利用できる、5 つのツールを備えた非公式の読み取り専用 MCP サーバーです。

AI エージェント向け · クイックスタート · できること · ツール · FAQ · فارسی

AI エージェント向け

• 概要： codal.ir（イランの取引所（テヘラン証券取引所、Iran Fara Bourse、商品取引所およびエネルギー取引所）に上場する企業やファンド、および登録済みの非上場企業の開示システム）向けの非公式 MCP サーバー（モデルコンテキストプロトコル）です。
• インストール： uvx codal-mcp または claude mcp add codal -- uvx codal-mcp。トランスポート：stdio。uv（Python 3.10 以降）が必要です。
• 認証： 不要です。API キーやアカウントは必要ありません。オプションで CODAL_MCP_PROXY（HTTP プロキシ URL、またはカンマ区切りのリスト）を指定できます。システムのプロキシ設定は無視されます。
• アクセス： 読み取り専用です。ログインや申請はできないため、ツールを呼び出す前の確認は不要です。
• ツール： すべて cd_ で始まる 5 つのツールがあります。一般的な順序は cd_company -> cd_search_letters -> cd_letter です。 cd_letter_types は絞り込みに使う書類種別 ID を、cd_financial_years は企業の会計年度末を返します。
• 利用する場面： ユーザーが、上場企業の開示内容（最新の中間または年次財務諸表、EPS、月次の売上と生産、株主総会の決議、配当スケジュール、増資、または Codal の書類 1 件の本文）を尋ねている場合に使用します。
• 利用しない場面： ユーザーが株価、板情報、市場指数を求めている場合（tsetmc-mcpを使用）、または取引を希望している場合は使用しないでください。
• 出力： ASCII 数字を使った簡潔な JSON です。日付はテヘラン時間のジャラーリー暦（YYYY/MM/DD）です。報告金額は公開時の単位で、通常は百万リアルです（unit_note を参照）。
• レート制限： codal.ir は、短時間にリクエストが集中すると最大 1 時間、IP アドレスをブロックします。対象を絞って少数の呼び出しを行い、結果を再利用してください。ツールが codal.ir のレート制限を通知した場合は、停止して待ってください。
• ネットワーク： codal.ir はイラン国内からの接続にしか応答しないことがよくあります。リクエストがタイムアウトする場合は、CODAL_MCP_PROXY にイランの HTTP プロキシを設定してください。
• 機械可読データ： server.json および iran-mcp カタログ。

理由

イランの上場企業が公開する情報はすべて Codal に掲載されていますが、検索フォーム、ペルシア数字、JavaScript で表示されるレポートページがあり、各ページには明細表が1つずつあります。「Foolad の今年上半期の業績はどうでしたか？」に答えるには、1,475件の中から適切な書簡を見つけ、画面上の表を読み取る必要があります。codal-mcp はサイト独自のフィルターで検索し、エージェントが読み取れる行形式で明細を返します。

あなた： Foolad（فولاد）は1405年上半期について何を報告しましたか？

エージェント： 呼び出し cd_search_letters(symbol="فولاد", letter_type=6, period_months=6) -> cd_letter(tracing_no=1612323)

Mobarakeh Steel の1405/06/31までの未監査6か月財務諸表（1405/07/30公開）によると、営業収益は2,509,422,184百万リアルで、前年同期比56％増加し、純利益は591,629,286百万リアルで、133％増加しました。基本1株当たり利益は308リアルでした。

_{追跡番号1612323の実際の数値です。2026-10-31にcodal-mcpで読み取り、codal.irの書簡ページと照合しました。}

できること

• Codal のあらゆる発行者の開示情報を検索できます。新しい順で、銘柄、書簡グループ、書簡種別、タイトル内の語句、ジャラリー暦の日付範囲、報告期間（1～12か月）、追跡番号で検索できます
• フィルターを指定しない場合は、市場全体の最新の書簡を一覧表示します
• 財務諸表を読み取り、シートごとに表形式で表示します。損益計算書、包括利益計算書、貸借対照表、資本変動計算書、キャッシュフロー計算書、解説レポートの各ページに加え、単位の注記と上場資本金も取得できます
• 月次活動レポートを読み取ります。原材料の購入、製品ごとの生産と販売、エネルギー使用量、外貨の調達源と使途を確認できます
• 説明、明確化、通知などのテキスト書簡を読み取ります。ページに隠されたフォームテンプレートは含まれません
• 各書簡のページ、PDF、Excelファイル、添付ファイルへのリンクを取得できます（説明と日付も含みます）
• 銘柄または名前から企業やファンドを検索できます。ISICコード、市場、種類、業種、報告種別を確認できます
• 検索で使用するID付きの書簡グループと書簡種別を一覧表示し、企業の会計年度末を確認できます
• 読み取り専用の設計です。ログインも CAPTCHA の解決も必要ありません

プロンプトの例：

• 「Foolad の最新の中間財務諸表には何が記載されていますか？」
• 「その書簡の貸借対照表を表示してください。」
• 「1405年の Iran Khodro の月次活動レポートを一覧表示してください。」
• 「今週、月次活動レポートを公開した企業はどこですか？」
• 「Foolad の会計年度末はいつですか？また、直近の年次財務諸表はいつ公開されましたか？」
• آخرین صورت‌های مالی میان‌دوره‌ای فولاد در کدال چه بود؟
• گزارش فعالیت ماهانه مهر ۱۴۰۵ ایران خودرو را بیاور.
• تصمیمات آخرین مجمع عمومی سالیانه فولاد را از کدال بخوان.

クイックスタート

uv が必要です。APIキーやアカウントは不要です。

claude mcp add codal -- uvx codal-mcp

{
  "mcpServers": {
    "codal": { "command": "uvx", "args": ["codal-mcp"] }
  }
}

{
  "servers": {
    "codal": { "type": "stdio", "command": "uvx", "args": ["codal-mcp"] }
  }
}

codex mcp add codal -- uvx codal-mcp

[mcp_servers.codal]
command = "uvx"
args = ["codal-mcp"]

{
  "mcpServers": {
    "codal": { "command": "uvx", "args": ["codal-mcp"] }
  }
}

取引シンボルはペルシャ語で指定します（فولاد、خودرو）。日付はジャラリー暦の YYYY/MM/DD 形式です。ペルシャ数字も使用できます。

5 つのツールすべてに readOnlyHint: true の注釈が付いています。

動作の仕組み

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  codal-mcp  (runs on your machine)
      │
      │  HTTPS, one request at a time, at least 2 s apart
      ├──────▶  search.codal.ir   search API, company list, letter types, fiscal years
      └──────▶  www.codal.ir      letter pages, sheets, attachment lists

codal-mcp はローカルで動作し、codal.ir のウェブサイトと同じ検索 API およびレターページを呼び出します。間にホスト型サーバーはなく、API キーも不要です。構造化レポートでは、レターページ内に表がデータとして含まれています。サーバーはそのデータを読み取り、サイト上の列順に各行を 1 行ずつ返します。それ以外のレターは、表示されているテキストとして返されます。リクエストは Chrome を偽装するクライアント経由で、search.codal.ir と www.codal.ir にのみ送信されます。読み取り専用です。

知っておくとよいこと

• レート制限。 codal.ir は、短時間に多数のリクエストがあると HTTP 429 を返して CAPTCHA を表示し、その後、最大 1 時間 IP をブロックします。サーバーはリクエストを一度に 1 件ずつ、少なくとも 2 秒間隔で送信します。企業一覧とレター種別は 12 時間、レターは 1 時間、検索結果は 2 分間キャッシュし、429 が返されても再試行しません。429 の後は 10 分間 codal.ir への呼び出しを停止し、エージェントに待つよう伝えます。CAPTCHA を解くことはありません。
• イランからの接続。 codal.ir はイラン国外からの接続に応答しないことがよくあります（テストでは、外国の VPN 出口からのリクエストがタイムアウトしました）。イラン国内を出口とする HTTP プロキシを CODAL_MCP_PROXY に設定してください。システムのプロキシ環境変数は意図的に無視されます。
• 単位。 財務諸表とレポートの金額は公表値のままで、通常は百万リアルです。unit_note にページ上の記載が引用されます。EPS の単位はリアルです。リアルをトマンに換算するには 10 で割ります。
• 表はテキストです。 表の各行は 1 行で、セルは | で区切られます。数値に桁区切りはなく、サイトで (N) と表示される負の数は -N になります。損益計算書には「درصد تغيير」列が 2 つあります。1 つは前年の同期間との比較、もう 1 つは直近の通期との比較です。
• 一度に 1 シート。 財務諸表はシートに分かれています。cd_letter は sheets の一覧を返し、別のシートを読み取るには sheet を指定します（たとえば、貸借対照表は 0 です）。
• 添付ファイルは一覧表示のみで、読み取りません。 説明レターの内容は、添付画像や PDF に含まれていることがよくあります。cd_letter はリンクを返します。
• 長いレター は 16,000 文字で切り詰められます（truncated）。レター全文は PDF リンクから確認できます。
• 検索のヒント。 period_months=12 で年次レポート、6 で半期レポート、3 で四半期レポートを検索できます。title はレターのタイトルに含まれる単語に一致します。cd_letter_types にはレター種別 ID が一覧表示されます（6 は財務諸表、58 は月次活動レポート、20 は年次株主総会の決議）。
• ペルシャ語のテキスト。 レター本文は企業が記載したとおりに返され、アラビア文字の ي／ك も含まれます。数字は ASCII に変換されます。
• 対応していない機能： 株価の取得（tsetmc-mcp を参照）、XBRL の解析、添付ファイルの読み取り、ログイン、CAPTCHA の解除には対応していません。

FAQ

npx @modelcontextprotocol/inspector uvx codal-mcp

設定

ペルシア語：AI アシスタント向け Codal MCP サーバー

claude mcp add codal -- uvx codal-mcp

開発

git clone https://github.com/sepehr071/codal-mcp && cd codal-mcp
uv sync
uv run ruff check . && uv run ruff format --check .
uv run python -m pytest -q          # offline unit tests on recorded codal.ir pages
uv run python -m pytest -m live -q  # one pass over every tool against codal.ir (about 8 requests)
uv build

すべてのツールは src/codal_mcp/codal.py にあり、HTTP 通信、リクエスト間隔の調整、キャッシュはすべて src/codal_mcp/http.py にあります。codal.ir は厳しくレート制限するため、ライブテストスイートは小規模に保ってください。Issue や PR を歓迎します。

リリースするには、pyproject.toml と server.json のバージョンを更新してから、v* タグをプッシュしてください。GitHub Actions が PyPI に公開します。

関連サーバー

• テヘラン証券取引所の価格、注文板、実取引と法人取引、指数については tsetmc-mcp
• イランの税務データ（商品 ID と VAT、活動コード、不動産評価額、税法）については iran-tax-mcp
• iran-mcp：イランのサービス向け MCP サーバーのカタログ

免責事項

非公式のプロジェクトであり、Codal またはイラン証券取引機構（SEO）とは提携しておらず、推奨も受けていません。 読み取り専用で、codal.ir ウェブサイトの検索 API とページを使用します。これらは予告なく変更される場合があります。 データは情報提供のみを目的としています。ここに記載する内容は、いかなる場合も金融助言ではありません。

作者

Sepehr Radmard（سپهر رادمرد）が開発・保守しています。LinkedInでつながるか、GitHub の @sepehr071をフォローして、イランのウェブサイト向け MCP サーバーをご覧ください。すべてiran-mcpに掲載されています。このプロジェクトが時間の節約に役立ったら、リポジトリにスターを付けていただけると、ほかの人にも見つけてもらいやすくなります。

ライセンス

MIT