@ticker-code/cli

TickerCode の日本株データをターミナルで取得する CLI。Node.js 20 以上。

一回だけ使う場合:

npx -y @ticker-code/cli stock 130A --format json

継続して使う場合:

npm install -g @ticker-code/cli
tc --version
tc stock 7203 --format json
tc financial 7203 --format json
tc disclosures --days 7 --format json

コマンド: stock, financial, disclosures, screen, rank, report, auth, mcp。 各コマンドの --help で引数を確認できます。screen と rank は銘柄データを手元にキャッシュします。 report の保存・更新・削除には対応する権限の API キーが必要です。

銘柄コードは 7203 / 72030 / 130A / 130A0 に対応します。小文字は大文字へ正規化します。 tc stock 7203 は主要指標の短い概要、--all は全項目の表、--format json は全データを返します。 数値・指標名・オプションの入力ミスはエラーとして終了します。screen --limit 0 は全件、rank --limit は正の整数です。

tc disclosures --days 7 --limit 3 --format json
tc screen --per-lt 15 --limit 10 --format json
tc rank --by i_forward_roe --limit 10 --format json

API キー

https://ticker-code.com のマイページで API キーを作成し、必要な読み取り・書き込み権限を選択してください。 MCPの銘柄取得には stock:read、開示には disclosure:read、監視の読み取りには watch:read、ニュースには news:read が必要です。監視の変更には別途 watch:write を選択してください。 環境変数 TICKERCODE_API_KEY、または tc auth login で保存したキーを利用します。 保存場所は ~/.tickercode/credentials.json（ファイル権限 0600）。ログインは MCP でキーを検証し、アカウントの個人情報は取得しません。

tc auth whoami はキーの有効性を確認します。tc auth logout は保存したキーを削除します。 サーバー上のキーの失効はマイページで行ってください。

MCP

tc mcp
# MCP 専用パッケージでも同じサーバーを利用できます
npx -y @ticker-code/mcp

MCP クライアントの設定例（キーは自分のものに置き換えてください）:

{
  "mcpServers": {
    "tickercode": {
      "command": "npx",
      "args": ["-y", "@ticker-code/mcp"],
      "env": { "TICKERCODE_API_KEY": "YOUR_API_KEY" }
    }
  }
}

stdio から https://api.ticker-code.com/mcp へ接続し、ツール定義はサーバーから取得します。 ChatGPT / claude.ai はこの URL を直接登録し、OAuth で接続できます。 TICKERCODE_API_BASE、TICKERCODE_MCP_URL で接続先を変更できます。 Issue Tracker、内部 MCP、内部の research / memory / setup コマンドはこの公開物に含みません。

エラーとデータの利用条件

Node.jsの版を node --version で確認してください（20以上）。入力エラーは tc <コマンド> --help、認証エラーはキーの権限・期限・失効状態を確認してください。 tc auth logout は手元の保存だけを消します。失効はマイページで行ってください。

ソフトウェアのMITライセンスと、取得したデータの利用条件は別です。利用規約に従ってください。無許可のデータ再配布・外部サービスへの組み込み、大量取得の制限回避は禁止されています。