ドキュメントのメニューexpand_more
MCP ツール
screen_stocks
このページの要点
- check_circle対応する REST エンドポイントは /stable/screener です。応答の形も同じです。
- check_circle1 回の実行で 10 トークンを消費します。エンドポイントを直接呼んだときと同じです。
- check_circle必須の引数: なし
このツールが返すもの
時価総額・PER・PBR・ROE・配当利回りなどの条件を組み合わせて、日本株を絞り込みます。条件はすべて任意で、指定した条件をすべて満たす銘柄が、並べ替えの指標の順に返ります。比率（ROE・ROA・配当利回り）は 0〜1 の小数（0.1 = 10%）で指定します。
AI クライアントに渡る説明
Screen Japanese listed companies by valuation, profitability and dividend criteria. Combine any of the *MoreThan / *LowerThan filters. 条件を組み合わせた銘柄スクリーニング。Costs 10 tokens.
AI はこの説明を読んでツールを選びます。英語と日本語を併記しています。
このツールで答えられること
- chat配当利回りが高く PBR が低い銘柄の候補を探す
- chatROE が高い銘柄を業種ごとに探す
- chat時価総額の範囲を決めて中小型株を一覧にする
引数
引数の名前は、REST のクエリ引数と同じです。必須でない引数は省略できます。
| 引数 | 型 | 必須 | 説明 |
|---|---|---|---|
| marketCapMoreThan | number | — | 時価総額の下限（円） |
| marketCapLowerThan | number | — | 時価総額の上限（円） |
| perMoreThan | number | — | PER の下限（倍） |
| perLowerThan | number | — | PER の上限（倍） |
| pbrMoreThan | number | — | PBR の下限（倍） |
| pbrLowerThan | number | — | PBR の上限（倍） |
| roeMoreThan | number | — | ROE の下限（0〜1 の小数。0.1 = 10%） |
| roaMoreThan | number | — | ROA の下限（0〜1 の小数。0.05 = 5%） |
| dividendYieldMoreThan | number | — | 配当利回りの下限（0〜1 の小数。0.03 = 3%） |
| dividendYieldLowerThan | number | — | 配当利回りの上限（0〜1 の小数。0.08 = 8%） |
| evToEbitdaLowerThan | number | — | EV/EBITDA の上限（倍） |
| sector | string | — | 東証 33 業種コード（例: 3700 = 輸送用機器）。一覧は /stable/available-sectors |
| isEtf | boolean | — | true = ETF・REIT だけ、false = ETF・REIT を除く |
| sortBy | stringmarketCap | per | pbr | psr | roe | roa | dividendYield | evToEbitda | changePct1d | changePct1w | changePct1m | changePctYtd | dividendCagr3y | dividendCagr5y | revenueCagr3y | revenueCagr5y | epsCagr3y | epsCagr5y | progressiveDividendYears | — | 並べ替えの指標。既定は marketCap（時価総額）。指定できる値（marketCap, per, pbr, psr, roe, roa, dividendYield, evToEbitda, changePct1d, changePct1w, changePct1m, changePctYtd, dividendCagr3y, dividendCagr5y, revenueCagr3y, revenueCagr5y, epsCagr3y, epsCagr5y, progressiveDividendYears）既定値: marketCap |
| order | stringasc | desc | — | 並び順。desc = 大きい順（既定）、asc = 小さい順既定値: desc |
| limit | integer | — | 返す件数の上限（既定 50、最大 100）既定値: 50範囲: 1〜100 |
対応する REST エンドポイント
このツールは /stable/screener を呼びます。1 回 10 トークンで、認証と月間トークンは REST と共通です。
GET /stable/screener10 トークン例
AI への質問の例
ZENITH Code のデータを使って、次のことを手伝ってください: 配当利回りが高く PBR が低い銘柄の候補を探す
AI クライアントが送る呼び出し（tools/call）の例です。必須の引数だけを入れています。
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "screen_stocks",
"arguments": {}
}
}同じデータを REST で取る場合の例です。
curl "https://api.zenithcode.net/stable/screener" \ -H "x-api-key: YOUR_API_KEY"
注意点
- info応答の形と項目の意味は、対応するエンドポイントの API ドキュメントと同じです。
- info読み取り専用のツールです。データの書き込みや設定の変更はしません。
取引所データの扱い
応答に株価そのもの、株価と同じ単位の値、TDnet の書類そのもの（PDF・本文・リンク）が含まれる場合、その部分は取引所データです。どのプランでも、AI の回答などを通じて第三者に示すことはできません（利用規約 第 8 条第 4 項）。
よくある質問（投資家・開発者向け）
screen_stocks を使うには何が必要ですか？expand_more
MCP に対応した AI クライアントと、ZENITH Code の API キーです。すべてのプランで使えます。設定は「MCP の使い方」をご覧ください。
screen_stocks は 1 回で何トークン消費しますか？expand_more
10 トークンです。/stable/screener を直接呼んだときと同じです。
screen_stocks の結果を自社サービスに表示できますか？expand_more
第三者への表示は Business プラン以上でできます。取引所データ（株価そのもの・株価と同じ単位の値・TDnet の書類そのもの）は、どのプランでも表示できません。詳しくは「表示してよいデータ・いけないデータ」をご覧ください。
よくある質問（AI・研究者向け）
screen_stocks は何を返しますか？expand_more
時価総額・PER・PBR・ROE・配当利回りなどの条件を組み合わせて、日本株を絞り込みます。条件はすべて任意で、指定した条件をすべて満たす銘柄が、並べ替えの指標の順に返ります。比率（ROE・ROA・配当利回り）は 0〜1 の小数（0.1 = 10%）で指定します。
screen_stocks の応答の出典はどこで確かめられますか？expand_more
出典の項目（provenance や sourceUrl）がある応答では、その値で原本を確かめられます。項目の有無は /stable/screener の API ドキュメントの応答の項目をご覧ください。
screen_stocks と一緒に使うツールは何ですか？expand_more
よく組み合わせるのは run_screener_preset, get_rankings, get_industry_benchmarks です。社名から始める場合は、先に search_company で証券コードを確かめます。
関連記事
免責
このページは情報提供を目的としたもので、投資助言ではありません。特定の銘柄の売買を勧めるものでもありません。データの利用条件は、利用規約と「データの出典と利用条件」の記載が優先します。