はじめに

Claude Trading Skillsのインストール方法、APIキーの設定、最初のスキル実行までをガイドします。

初めて利用する場合は、アクセス条件・費用・安全性・機能範囲をまとめた よくある質問も確認してください。以下に出てくる トレード用語が初めての場合は、平易な説明をまとめた 用語集を参照してください。

目次

必要なもの

実際に必要な費用: Claude WebのSkillsは現在Free、Pro、Max、Team、 Enterpriseで利用できます。Claude Codeには別のアカウント要件があり、 Claude.aiのFreeプランには含まれません。FMP、FINVIZ Elite、Alpacaは任意 または特定スキルだけの連携で、5スキルの入口に有料の市場データAPI契約は 不要です。最新の利用条件はAnthropicの SkillsヘルプClaude Codeセットアップガイド で確認してください。

項目 必須/任意 説明
Claudeアカウント 必須 Skillsを利用できるClaude Webアカウント、または別途利用条件を満たすClaude Codeアカウント
Python 3.9+ 必須 スクリプト実行用。多くのスキルが Python ヘルパーを使用
FMP APIキー 任意 Financial Modeling Prep API。一部スキルで必須(無料ティアあり)
FINVIZ Elite 任意 配当スクリーナーの高速化、Theme Detectorの精度向上に推奨
Alpacaアカウント 任意 Portfolio Managerスキルで保有データ取得に必要

インストール方法

Claude Web Appで使う場合

  1. skill-packages/ ディレクトリから使いたいスキルの .skill ファイル(ZIP形式)をダウンロードします。
  2. 個人アカウントでは Settings > Capabilities を開き、Code execution and file creation を有効にします。Team/Enterpriseでは組織オーナーによるSkillsの有効化が必要な場合があります。
  3. Customize > Skills を開き、ダウンロードした .skill ファイルをアップロードします。
  4. スキルが Customize > Skills に表示されることを確認し、必要に応じて有効化します。

アカウント別の設定とトラブルシューティングは、Anthropicの最新のSkillsヘルプを参照してください。

Claude Code(デスクトップ / CLI)で使う場合

# 1. リポジトリをクローン
git clone https://github.com/tradermonty/claude-trading-skills.git

# 2. 使いたいスキルフォルダを個人用Claude Code skillsディレクトリにコピー
mkdir -p ~/.claude/skills
cp -r claude-trading-skills/skills/finviz-screener ~/.claude/skills/

# 3. 起動後に最上位skillsディレクトリを作った場合だけ再起動

プロジェクト内だけで使うスキルは.claude/skills/からも検出されます。 対応アカウントとインストール方法は Claude Codeセットアップガイド を参照してください。

.skill パッケージはソースフォルダから生成しますが、テストとローカルビルド成果物は除外します。カスタマイズしたい場合はソースフォルダを編集し、配布前に python3 scripts/package_skills.py --skill <skill-name> を実行してください。


APIキーの設定

Financial Modeling Prep (FMP)

多くのスクリーニングスキルで使用するファンダメンタルデータAPIです。

プラン 料金 API コール上限 対象
Free 無料 250回/日 少数銘柄のスクリーニングに十分
Starter $29.99/月 750回/日 CANSLIM 40銘柄フルスクリーニング
Professional $79.99/月 2,000回/日 大規模スクリーニング、複数スキル併用

登録: https://site.financialmodelingprep.com/developer/docs

# 環境変数で設定(推奨)
export FMP_API_KEY=your_key_here

# または、スクリプト実行時に引数で指定
python3 scripts/screen_canslim.py --api-key YOUR_KEY

FINVIZ Elite

配当スクリーナーの高速化(実行時間 70-80% 短縮)や Theme Detector の精度向上に利用します。

プラン 料金 備考
Elite月払い $39.50/月 リアルタイムデータ、高速API
Elite年払い $299.50/年(約$24.96/月) 年間割引あり

登録: https://elite.finviz.com/

export FINVIZ_API_KEY=your_key_here

Alpaca Trading

Portfolio Managerでライブ保有データを取得し、分析とリバランス案を作る場合は必須です。 この読み取り・分析用連携はブローカーへ注文を送信しません。売買には 人間が別途確認・執行する必要があります。

プラン 料金 備考
ペーパートレード 無料 シミュレーション環境、全API利用可能
ライブトレード 無料(手数料なし) 株式・ETFの売買が可能

登録: https://alpaca.markets/

export ALPACA_API_KEY="your_api_key_id"
export ALPACA_SECRET_KEY="your_secret_key"
export ALPACA_PAPER="true"  # ペーパートレードの場合

最初のスキルを試す - FinViz Screener

FinViz ScreenerはAPIキー不要で最も手軽に試せるスキルです。自然言語でスクリーニング条件を伝えるだけで、FinVizのフィルター付きURLを生成してChromeで開きます。

使用例

Claudeに以下のように話しかけてみてください:

EPS成長率25%以上で、SMA200の上にある銘柄を探して

Claudeの動作

  1. ユーザーの自然言語を解析し、FinVizフィルターコードに変換します
    • fa_epsqoq_o25 (EPS QoQ成長率 > 25%)
    • ta_sma200_pa (SMA200の上)
  2. 選択したフィルターを表形式で確認のため提示します
  3. 確認後、URLを構築してChromeで結果ページを開きます

期待される出力

  • Chromeブラウザに FinViz Screener の結果が表示されます
  • 条件に合致する銘柄がテーブル形式で一覧表示されます
  • Overview / Valuation / Financial / Technical 等のビューを切り替えて詳細を確認できます

FinViz Screener の詳しい使い方は FinViz Screener ガイド をご覧ください。


トラブルシューティング

スキルが読み込まれない

原因 対処
SKILL.md の name フィールドがフォルダ名と不一致 name がフォルダ名と完全一致しているか確認
スキルフォルダの配置場所が間違っている Claude Code の Skills ディレクトリに正しくコピーされているか確認
セッション開始後に最上位skillsディレクトリを新規作成した Claude Codeを1度再起動する。既存skillsディレクトリ内の変更は自動検出される

APIキーエラー

ERROR: FMP API key not found. Set FMP_API_KEY environment variable or use --api-key argument.

対処:

  1. 環境変数が正しく設定されているか確認: echo $FMP_API_KEY
  2. シェルの設定ファイル(.zshrc / .bashrc)に export FMP_API_KEY=... を追加して再読み込み
  3. それでもダメな場合は --api-key 引数で直接渡す

スクリプトエラー(依存パッケージ不足)

ModuleNotFoundError: No module named 'requests'

対処:

pip install requests beautifulsoup4 lxml pandas numpy yfinance

必要な依存パッケージはスキルによって異なります。各スキルガイドの「前提条件」セクションを確認してください。

FMP API レートリミット

ERROR: 429 Too Many Requests - Rate limit exceeded

対処:

  1. スクリプトは自動で60秒後にリトライします
  2. 無料ティア(250回/日)の上限を超えた場合は、翌日(UTC午前0時)にリセットされます
  3. --max-candidates パラメータで分析対象を減らすことで使用量を削減できます
  4. 頻繁に使う場合は FMP Starter ($29.99/月) へのアップグレードを検討してください