Skip to main content
Glama

ラジ株ナビ (Radikabunavi) - Japanese stock data from EDINET/TDnet

大量保有

get_large_holdings
Read-only

大量保有報告書(5%ルール)のデータを取得します。 会社名(issuerName)は会社名の索引の現在の社名です。報告書に書かれていた名前が現在の社名と異なるときだけ、その報告書のイベントに issuerNameAsFiled として元の表記を付けます(旧社名のままの報告書がある)。companyNameIndexAsOf は索引の作成時刻です。 発行者(どの会社の株か)は、報告書の XBRL に書かれた証券コードと EDINET の書類一覧の発行会社を突き合わせて決めています。発行者を決められなかった報告書は一覧に含めません(unresolvedCount に件数を出します)。 日付指定で当日のイベント一覧、または銘柄コード指定でその銘柄の大量保有履歴を取得できます。

データソース: EDINET 大量保有報告書(docType 350/370)。 カバレッジ: 2021-06 以降の全提出を日次バッチで取得・名寄せ済み(投資家ベース)。 取得項目: 保有者名(名寄せ後)・銘柄コード・保有比率・変動比率・取得資金・保有目的・提出日。

該当が無いとき(5%超の保有者がいない銘柄・休日・未取り込みの日)はエラー(isError)にせず、{ hasData: false, status, reason, events: [] } で返します。 status: no_filings=提出がもともと無い(休日・報告なし)/ not_yet_disclosed=翌日の朝の取り込み前 / possible_intake_delay=営業日なのに無い(取り込みの遅れの可能性)/ out_of_coverage=取り込み範囲より前 / delisted・not_applicable=上場廃止・ETF/REIT。存在しない銘柄コード・形式の不正な日付だけが isError です。

code 指定時、有報の大株主の状況に国・地方公共団体(財務大臣・都道府県・市)が5%超でいて、その保有者の報告書が取り込み範囲に無いときは、 publicHolderNote(理由の説明)・publicHolders(名前・保有比率%・株数)・publicHoldersAsOf(有報の決算期)を付けます。 国・地方公共団体も提出の対象ですが(金融商品取引法27条の26の特例報告を使える)、保有株数が変わらなければ変更報告書は出ない(同法27条の25第1項)ため、 2021-06 より前から株数が変わっていない保有は一覧に出てきません。

各イベントは以下を含みます:

  • holdingRatio: 今回の保有比率(%)

  • previousRatio: 変更前の保有比率(%)。新規保有(初回の5%超)では null

  • docId / sourceUrl: EDINET 提出書類の原典リンク

  • filingDate: 提出日 / triggerDate: 報告義務発生日(code 指定時のみ)

code 指定時の既定: 提出日の新しい順に直近 20 件(totalCount は全件数、returnedCount は返した件数)、保有目的(purpose)は先頭 80 文字+「…」(purposeTruncated: true)に短縮します。 全件・全文が必要なときは limit(件数。最大 500)と includeFullPurpose: true を指定してください。date 指定・未指定(直近7日)の一覧は、既定で最大 500 件まで(totalCount は全件数、returnedCount は返した件数)を返し、limit は適用しません。

関連ツール: 投資家ベースのポートフォリオは /investors ページ、 銘柄ベースの保有変動は本ツール(code 指定)、財務データは get_edinet_financial_data。

応答の metricLabels は英語キー→日本語指標名の対訳です。利用者向けには日本語名(例: holdingRatio→「保有比率」)のほうが伝わりやすくなります。 データ品質・値の異常・不具合に触れる場合も同様で、フィールド名を示すときは「発行済株式数(sharesOutstanding)」のように日本語を主・英語キーを括弧内にすると読みやすくなります。

※ 本データは情報提供を目的とし、投資助言・推奨ではありません。

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "get_large_holdings"
  }
}

Input Schema

NameRequiredDescriptionDefault
codeNo証券コード(例: 7203)。指定すると銘柄別の大量保有履歴を返します。
dateNo日付(YYYY-MM-DD)。指定するとその日の大量保有イベント一覧を返します。省略時は直近7日分を検索。
limitNo省略可。code 指定時に返すイベント数(提出日の新しい順)。既定 20、最大 500。totalCount は常に全件数。
includeFullPurposeNo省略可(既定 false)。true で保有目的(purpose)を全文で返します。既定は先頭 80 文字+「…」(purposeTruncated: true)。

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.4/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Discloses behavior well beyond the readOnly/openWorld annotations: no-data cases return `{hasData:false, status, reason, events:[]}` instead of an error, with a full enumeration of status values (no_filings, not_yet_disclosed, possible_intake_delay, out_of_coverage, delisted/not_applicable) and the narrow set of conditions that actually raise isError. It also documents default limits, purpose truncation, and the pre-2021-06 public-holder blind spot via publicHolderNote/publicHolders, so the agent knows exactly what is missing from results and why.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Content is dense but organized: purpose → empty-state semantics → special cases → per-event fields → defaults → related tools. The trailing paragraphs on metricLabels translation and Japanese-vs-English field naming, plus the informational disclaimer, are response-formatting guidance rather than invocation guidance, and the limit defaults are stated twice, so it is longer than strictly necessary.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no output schema, the description carries the full burden and does so: it enumerates every event field (holdingRatio, previousRatio, docId/sourceUrl, filingDate, triggerDate), the pagination counters (totalCount/returnedCount), the empty-result contract, and known coverage gaps. Nothing an agent needs to call this correctly or interpret its response appears to be missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3, and the description largely restates what the schema already says (default 20, max 500, 80-char purpose truncation). It does add one genuinely new detail — that `limit` is not applied to date-based or unspecified-date queries, which default to 500 — so it edges above pure repetition but not by much.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource — retrieving EDINET large-holdings (5% rule) report data — and immediately distinguishes its two modes: a same-day event list when `date` is given vs. a per-issuer holding history when `code` is given. Data source (docType 350/370), coverage window (2021-06 onward, daily batch) and the returned fields are all named, so an agent can tell what this tool is versus get_investor_portfolio or get_edinet_financial_data without opening a schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives explicit routing for the two input modes (date → daily event list, code → holding history) and points elsewhere for investor-based portfolios and financial data. It stops short of naming the concrete sibling tool for the investor case (it says '/investors ページ' rather than get_investor_portfolio), so alternatives are indicated but not fully enumerated.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources