ドキュメントのメニューexpand_more
MCP ツール
run_screener_preset
このページの要点
- check_circle対応する REST エンドポイントは /stable/screener-presets です。応答の形も同じです。
- check_circle1 回の実行で 10 トークンを消費します。エンドポイントを直接呼んだときと同じです。
- check_circle必須の引数: preset
このツールが返すもの
高配当、割安、高 ROE、高成長、連続増配、モメンタムの 6 種類の定番条件で、時価総額 50 億円以上の普通株を絞り込みます。比率は 0〜1 の小数です。条件の例: high-dividend は配当利回り 4〜12%・PER 正・時価総額 50 億円以上で、配当利回りの高い順、value は PER 15 倍以下・PBR 1 倍以下・ROE 5% 以上で、PBR の低い順に返します。
AI クライアントに渡る説明
Run a ready-made screen over Japanese common stocks (market cap >= JPY 5 billion) and get the ranked list. Ratios are decimals (0.04 = 4%). Presets: high-dividend (High dividend / 高配当): dividendYield >= 0.04 AND dividendYield <= 0.12 AND per > 0 AND marketCap >= 5000000000; sorted by dividendYield desc | value (Value / 割安): per > 0 AND per <= 15 AND pbr > 0 AND pbr <= 1 AND roe >= 0.05 AND marketCap >= 5000000000; sorted by pbr asc | high-roe (High ROE / 高ROE): roe >= 0.15 AND roe <= 1 AND marketCap >= 5000000000; sorted by roe desc | growth (Growth / 高成長): revenueCagr3y >= 0.1 AND epsCagr3y >= 0.1 AND roe >= 0.08 AND roe <= 1 AND marketCap >= 5000000000; sorted by revenueCagr3y desc | dividend-growth (No dividend cuts / 連続非減配): progressiveDividendYears >= 5 AND dividendYield >= 0.02 AND dividendYield <= 1 AND marketCap >= 5000000000; sorted by progressiveDividendYears desc | momentum (Momentum / モメンタム): changePct1m >= 0.1 AND changePctYtd >= 0.2 AND marketCap >= 5000000000; sorted by changePctYtd desc. 高配当・割安・高ROE・高成長・連続非減配・モメンタムの定型スクリーニング。Costs 10 tokens.
AI はこの説明を読んでツールを選びます。英語と日本語を併記しています。
このツールで答えられること
- chat条件を考えずに高配当株の候補をすぐ一覧にする
- chat割安株と高 ROE 株を見比べる
- chat減配せずに配当を続けている銘柄を探す
引数
引数の名前は、REST のクエリ引数と同じです。必須でない引数は省略できます。
| 引数 | 型 | 必須 | 説明 |
|---|---|---|---|
| preset | stringhigh-dividend | value | high-roe | growth | dividend-growth | momentum | 必須 | 定番条件の名前。high-dividend = 高配当、value = 割安、high-roe = 高 ROE、growth = 高成長、dividend-growth = 連続増配、momentum = モメンタム |
| sector | string | — | 東証 33 業種コードで絞り込む（例: 3700 = 輸送用機器） |
| limit | integer | — | 返す件数の上限（既定 50、最大 100）既定値: 50範囲: 1〜100 |
対応する REST エンドポイント
このツールは /stable/screener-presets を呼びます。1 回 10 トークンで、認証と月間トークンは REST と共通です。
例
AI への質問の例
ZENITH Code のデータを使って、次のことを手伝ってください: 条件を考えずに高配当株の候補をすぐ一覧にする
AI クライアントが送る呼び出し（tools/call）の例です。必須の引数だけを入れています。
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "run_screener_preset",
"arguments": {
"preset": "high-dividend"
}
}
}同じデータを REST で取る場合の例です。
curl "https://api.zenithcode.net/stable/screener-presets?preset=high-dividend" \ -H "x-api-key: YOUR_API_KEY"
注意点
- info応答の形と項目の意味は、対応するエンドポイントの API ドキュメントと同じです。
- info読み取り専用のツールです。データの書き込みや設定の変更はしません。
取引所データの扱い
応答に株価そのもの、株価と同じ単位の値、TDnet の書類そのもの（PDF・本文・リンク）が含まれる場合、その部分は取引所データです。どのプランでも、AI の回答などを通じて第三者に示すことはできません（利用規約 第 8 条第 4 項）。
よくある質問（投資家・開発者向け）
run_screener_preset を使うには何が必要ですか？expand_more
MCP に対応した AI クライアントと、ZENITH Code の API キーです。すべてのプランで使えます。設定は「MCP の使い方」をご覧ください。
run_screener_preset は 1 回で何トークン消費しますか？expand_more
10 トークンです。/stable/screener-presets を直接呼んだときと同じです。
run_screener_preset の結果を自社サービスに表示できますか？expand_more
第三者への表示は Business プラン以上でできます。取引所データ（株価そのもの・株価と同じ単位の値・TDnet の書類そのもの）は、どのプランでも表示できません。詳しくは「表示してよいデータ・いけないデータ」をご覧ください。
よくある質問（AI・研究者向け）
run_screener_preset は何を返しますか？expand_more
高配当、割安、高 ROE、高成長、連続増配、モメンタムの 6 種類の定番条件で、時価総額 50 億円以上の普通株を絞り込みます。比率は 0〜1 の小数です。条件の例: high-dividend は配当利回り 4〜12%・PER 正・時価総額 50 億円以上で、配当利回りの高い順、value は PER 15 倍以下・PBR 1 倍以下・ROE 5% 以上で、PBR の低い順に返します。
run_screener_preset の応答の出典はどこで確かめられますか？expand_more
出典の項目（provenance や sourceUrl）がある応答では、その値で原本を確かめられます。項目の有無は /stable/screener-presets の API ドキュメントの応答の項目をご覧ください。
run_screener_preset と一緒に使うツールは何ですか？expand_more
よく組み合わせるのは screen_stocks, get_rankings, get_dividend_streaks です。社名から始める場合は、先に search_company で証券コードを確かめます。
関連記事
免責
このページは情報提供を目的としたもので、投資助言ではありません。特定の銘柄の売買を勧めるものでもありません。データの利用条件は、利用規約と「データの出典と利用条件」の記載が優先します。