degreeroi

degreeroi

学位は、働く生涯を通じて実際にいくらの価値があるのでしょうか。degreeroi は、パンフレットの宣伝文句ではなくデータで答えます。大学の専攻分野ごとの生涯投資収益率と、プラスの基準を満たす米国の大学における30年間の正味現在価値を示します。LE TEEN College ROI API 用のシンプルな読み取り専用クライアントで、静的 JSON を使い、キーも登録も不要です。単一の実行ファイルから、小さな CLI と stdio MCP サーバーの両方として利用できます。

専攻分野の数値は、19のカテゴリーと115のCIPサブ分野を対象としています。生涯ROIの中央値と平均値、損益分岐に至らない卒業生の割合、損益分岐年齢、AIへの曝露度の区分が含まれ、詳細ビューでは分布全体も確認できます。大学の数値は、プラスのNPV基準を満たす4年制大学500校（米国の4年制大学約1,656校のうち）を対象としています。居住者と非居住者にとっての学位の30年間の価値、通学費用、卒業生の収入、学位の費用を回収できる時期を示します。すべての金額は、生涯または30年間の合計を米ドルで示しています。

この基準による重要な結果を明記しておきます。500校に含まれていない大学のデータはありません。その大学を照会すると「見つかりません」が返されます。データセットに含まれていないこと自体が情報であり、degreeroi はデータセットから除外されている大学の記録を決して捏造しません。

設定

• COLLEGE_ROI_API_URL（任意）— API のベース URL。 デフォルトは https://le-teen.com/api です。

設定はこれだけです。APIキーは不要です。上流 API は無料で、キーも必要ありません。レスポンスは API 独自の CDN キャッシュと同じく、プロセス内で24時間キャッシュされます。データが書き戻されることはありません。

ツール

• list_majors — 専攻分野のカテゴリーとサブ分野について、簡潔なROI行を返します。任意のフィルター： kind（category または subfield）、parent（サブ分野が属するカテゴリー）、sort （median_roi、mean_roi、break_even_age または name）、および limit。設定したフィルターだけが送信されます。
• get_major — 1つの専攻分野の完全なレコードを返します。 ROI分布（p25、中央値、平均値、p75）、修了率調整後のROIと中退者のROI、卒業生数とプログラム数、AIへの曝露度の詳細が含まれます。
• search_colleges — 500校の対象大学を name、state または control で検索し、limit で件数を指定します。各行には、居住者と非居住者の30年間のNPV、通学費用、収入の中央値、損益分岐年齢が含まれます。
• get_college — IPEDS unitid と FREOPP の対象情報を含む、1校の完全なレコードを返します。対象外の大学を指定すると、college not found: <college> が返されます。
• best_value_colleges — 居住者向けの学費に基づく、費用対効果の高い4年制大学を返します。state を指定すると州ごとに上位15校を返し（limit で絞り込み可能）、指定しない場合は全米のおすすめ大学を要約して返します。
• out_of_state_penalty — 非居住者が居住者と比べて失う30年間のNPVの額に基づき、公立4年制大学を順位付けします。任意で state と limit を指定して絞り込めます。
• get_api_info — エンドポイント、ライセンス、データセットの DOI、帰属表示など、基盤となる API のメタデータを返します。固定されたメタデータからローカルで回答するため、上流 API への呼び出しは行いません。

動作に関する補足：

• リスト系ツールは API の簡潔な射影をそのまま返し、詳細系ツールは上流の完全なレコードをそのまま返します。
• 上流から2xx以外の応答が返ると、degreeroi error: HTTP <status> で失敗します（ただし、詳細系ツールの404は上記のとおり正確に「見つかりません」を返します）。API に到達できない場合は degreeroi unreachable が返されます。

エンドポイントの出典

元のプロジェクトのREADMEでは、7つのツールとその意味、APIベース （https://le-teen.com/api、静的JSON）、list_majors の フィルター（種類／親、並べ替え、上限）と search_colleges のフィルター（名称／州／管理区分）、および データセットの情報（19のカテゴリー、115の下位分野、500の エンベロープ大学、DOI 10.5281/zenodo.21351602、 CC BY 4.0、LE TEEN（le-teen.com））が示されています。エンドポイントの パスやパラメーター表は列挙されていないため、この再構築での以下の内容は 再構成したものとして明記しています。ネットワークを使用する各ツールは、 APIベース配下でそれぞれ1回GETを実行します。

• GET <base>/majors。設定されたフィルターのみを クエリパラメーターとして指定します（list_majors で使用）。
• GET <base>/majors/{major}（get_major で使用）。
• GET <base>/colleges。設定されたフィルターのみを クエリパラメーターとして指定します（search_colleges で使用）。
• GET <base>/colleges/{college}（ get_college で使用）。
• GET <base>/best-value-colleges。設定されている場合は state ／ limit を指定します（best_value_colleges で使用）。
• GET <base>/out-of-state-penalty。設定されている場合は state ／ limit を指定します（out_of_state_penalty で使用）。
• get_api_info は、上記のとおり実装されたエンドポイントを含む、 固定のメタデータから提供されます。

major と college のパスセグメントはURLエンコードされます。

APIのデータソース：FREOPPのプログラムレベル推定値、IPEDSの教育機関データ、 BEAの価格デフレーター。データライセンスはCC BY 4.0です。LE TEEN、 le-teen.comを引用してください。

CLI

各ツールは、JSON引数文字列を1つ受け取るサブコマンドです。

npx @reneturcios/degreeroi list_majors '{"kind":"subfield","sort":"median_roi","limit":10}'
npx @reneturcios/degreeroi get_major '{"major":"computer-science"}'
npx @reneturcios/degreeroi search_colleges '{"state":"CA","control":"public"}'
npx @reneturcios/degreeroi get_college '{"college":"example-state-university"}'
npx @reneturcios/degreeroi best_value_colleges '{"state":"CA"}'
npx @reneturcios/degreeroi out_of_state_penalty '{"limit":20}'
npx @reneturcios/degreeroi get_api_info '{}'
npx @reneturcios/degreeroi --version

出力はツールの結果テキストです（成功時は上流のレスポンス本文）。 終了コード：成功時は0、実行時エラー時は1、使用方法のエラー時は2です。

MCP サーバー

npx -y @reneturcios/degreeroi mcp

MCPクライアントの設定：

{
  "mcpServers": {
    "degreeroi": {
      "command": "npx",
      "args": ["-y", "@reneturcios/degreeroi", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/degreeroi
docker run --rm ghcr.io/cloudcorprecords/degreeroi get_api_info '{}'

開発

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch only, no network)
npm run dev     # run the CLI from source

ライセンス

MIT — Copyright (c) 2026 Rene Turcios

上流APIから提供されるデータはCC BY 4.0です （LE TEEN、le-teen.com、データセットDOI 10.5281/zenodo.21351602）。