mcpField
T
twelvedata

twelvedata

github.com/starchild-ai-agentその他307.7k 回インストール1 週間前に更新
リポジトリ

twelvedata について

株式、外国為替、コモディティを対象とするTwelve Dataのデータを取得するスクリプトモードのSkillです。暗号資産には対応せず、価格やOHLCV時系列、市場リストを必要とするAgentやスクリプト向けです。

主な機能

  1. 01単一・一括の価格と気配値
  2. 02複数間隔のOHLCV時系列
  3. 03日足終値
  4. 04銘柄検索と対応株式一覧
  5. 05FXペアと取引所の一覧
  6. 06プレマーケット・アフターマーケット対応

活用シーン

  1. 01複数銘柄の気配値を比較
  2. 02株式の直近または過去の足を確認
  3. 03FXペアやコモディティ価格を調べる
  4. 04ティッカーや対応取引所を検索

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/starchild-ai-agent/official-skills --skill twelvedata

インストール後、Claude Code で/twelvedataを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

__init__.py
exports.py
tools/
__init__.py
client.py
quote.py
reference_data.py
time_series.py

詳細

Twelve Data

株式、為替、コモディティの価格データ。従来型市場のみ — 暗号資産向けではありません。

スクリプトの使用方法

このスキルには、すべての関数を含む単一の exports.py が同梱されています。bash ブロックから呼び出してください:

python3 - <<'EOF'
import sys, json
sys.path.insert(0, "/data/workspace/skills/twelvedata")
from exports import twelvedata_price, twelvedata_quote, twelvedata_time_series

# Single quote
print(twelvedata_quote(symbol="AAPL"))

# Time series (last 30 daily candles)
series = twelvedata_time_series(symbol="AAPL", interval="1day", outputsize=30)
print(json.dumps(series.get("values", [])[:3], indent=2))
EOF

exports.py で利用可能な関数: twelvedata_price、twelvedata_quote、 twelvedata_time_series、twelvedata_eod、twelvedata_quote_batch、 twelvedata_price_batch、twelvedata_search、twelvedata_stocks、 twelvedata_forex_pairs、twelvedata_exchanges。正確なシグネチャが必要な場合は exports.py を直接読んでください。

関数リファレンス（シグネチャ）

すべての関数は exports.py にあります。シンボルは TwelveData 形式（例: AAPL、 EUR/USD、XAU/USD）を使用します。米国株式のプレ／ポストマーケットデータには prepost=True を使用してください。

関数説明
twelvedata_price(symbol, prepost=False)1つのシンボルの現在価格。
twelvedata_price_batch(symbols, prepost=False)複数シンボルの価格（symbols = カンマ区切りの文字列）。
twelvedata_quote(symbol, prepost=False)詳細なクォート: 価格、出来高、52週高値／安値、変化率。
twelvedata_quote_batch(symbols, prepost=False)複数シンボルの詳細なクォート。
twelvedata_time_series(symbol, interval='1day', outputsize=30, start_date=None, end_date=None, prepost=False)OHLCV バー。interval = 1min/5min/15min/30min/1h/2h/4h/1day/1week/1month。
twelvedata_eod(symbol, date=None, prepost=False)指定日の終値（デフォルト: 最新）。
twelvedata_search(query)名前またはティッカーでシンボルを検索します。
twelvedata_stocks(exchange=None, country=None)対応する株式を一覧表示します（フィルタ可能）。
twelvedata_forex_pairs()対応するすべての為替ペアを一覧表示します。
twelvedata_exchanges()対応する取引所を一覧表示します。

キーワード → ツールの対応表

ユーザーの質問ツールこれではない
「AAPL 股价」、「current price」（単一）twelvedata_quotetwelvedata_price ではない（詳細度が低い）
「価格の数値だけ」twelvedata_price—
「多只股票对比」（2つ以上のシンボル）twelvedata_quote_batch複数の twelvedata_quote 呼び出しではない
「K线」、「历史数据」、「time series」twelvedata_time_series—
「收盘价」twelvedata_eod—
「股票代码を探す」twelvedata_search—
「NASDAQ 有哪些股票」twelvedata_stocks—
「汇率」、「EUR/USD」twelvedata_quote(symbol="EUR/USD")—
「外汇对列表」twelvedata_forex_pairs—
「金价」、「oil price」twelvedata_quote(symbol="XAU/USD")CoinGecko ではない
「BTC price」、あらゆる暗号資産CoinGecko coin_price❌ 暗号資産に twelvedata を絶対に使わない

TwelveData vs CoinGecko — 境界

資産クラス使用するもの理由
株式（AAPL、TSLA）TwelveDataCoinGecko に株式はない
為替（EUR/USD）TwelveDataCoinGecko に為替はない
コモディティ（金、石油）TwelveDataCoinGecko にコモディティはない
暗号資産（BTC、ETH、SOL）CoinGeckoTwelveData の暗号資産データは限定的／信頼性が低い

間違い — 呼び出す前に読んでください

❌ 間違い 1: 暗号資産に TwelveData を使う
User: "BTC 价格"
❌ WRONG: twelvedata_quote(symbol="BTC/USD")
✅ RIGHT: coin_price(ids="bitcoin")  ← CoinGecko
❌ 間違い 2: 複数の株式に対して個別に quote を呼び出す
User: "AAPL MSFT GOOGL 现在什么价"
❌ WRONG: twelvedata_quote("AAPL"), twelvedata_quote("MSFT"), twelvedata_quote("GOOGL")  ← 3 calls
✅ RIGHT: twelvedata_quote_batch(symbols=["AAPL", "MSFT", "GOOGL"])  ← 1 call, up to 120 symbols
❌ 間違い 3: スラッシュなしの為替
❌ WRONG: twelvedata_quote(symbol="EURUSD")
✅ RIGHT: twelvedata_quote(symbol="EUR/USD")  ← always slash format

また: USDCNH ではなく USD/CNH、GBPJPY ではなく GBP/JPY。

❌ 間違い 4: quote から bid/ask を期待する
❌ WRONG: "EUR/USD bid: 1.0850, ask: 1.0852"  ← quote only returns close
✅ RIGHT: "EUR/USD current price: 1.0851 (close/last price — bid/ask spread not available)"
❌ 間違い 5: 間違った interval 形式
❌ WRONG: twelvedata_time_series(interval="1D")  ← uppercase
✅ RIGHT: twelvedata_time_series(interval="1day")

有効: 1min、5min、15min、30min、1h、2h、4h、8h、1day、1week、1month

❌ 間違い 6: コンパクトで十分なのに完全な出力を使う
User: "AAPL 最近走势"
❌ WRONG: twelvedata_time_series(symbol="AAPL", interval="1day", outputsize="full")  ← 5000 candles
✅ RIGHT: twelvedata_time_series(symbol="AAPL", interval="1day", outputsize="compact")  ← 30 candles

full は、ユーザーが明確に深い履歴を必要とする場合にのみ使用してください。

シンボルリファレンス

コモディティ（検証済み）
資産シンボル
金XAU/USD
銀XAG/USD
プラチナXPT/USD
パラジウムXPD/USD
原油（WTI）WTI/USD
天然ガスNG/USD
人気の為替ペア
ペアシンボル
ユーロ / USDEUR/USD
GBP / USDGBP/USD
USD / JPYUSD/JPY
USD / CNHUSD/CNH

その他のペアを見つけるには twelvedata_search を使用してください。

プレマーケット/アフターマーケットデータ

twelvedata_quote(symbol="AAPL", prepost=true)
twelvedata_time_series(symbol="AAPL", interval="1min", prepost=true)

利用可能な場合は premarket_change、premarket_change_percent、postmarket_change、postmarket_change_percent を返します。

出力サイズ

  • compact — 直近 30 データポイント(デフォルト、より高速)。「最近走势」に使用します。
  • full — 最大 5000 データポイント。詳細な分析 / チャート作成に使用します。

プロキシ安全な使用

  1. エージェントのツール呼び出し: 常に twelvedata_* ツール(このスキル)を優先してください。
  2. プラットフォームコード(skills/、tools/): core.http_client を使用します。
  3. ワークスペーススクリプト(bash): TwelveData を直接呼び出さないでください。スキルツールを使用してください。

複合クエリ

株価比較
1. twelvedata_quote_batch(symbols=["AAPL", "MSFT", "GOOGL", "TSLA"])
2. twelvedata_time_series(symbol="AAPL", interval="1day", outputsize="compact")  ← only for the one user cares most about
マクロダッシュボード(株式 + 為替 + コモディティ)
1. twelvedata_quote_batch(symbols=["SPY", "QQQ"])          → US indices
2. twelvedata_quote_batch(symbols=["EUR/USD", "USD/JPY"])   → Forex
3. twelvedata_quote(symbol="XAU/USD")                       → Gold

コメント

Markdown 対応