funda-data

Funda AI Skill

Funda AI は、同じデータに基づく相互補完的な 2 つのインターフェースを提供します。

インターフェース	最適な用途	認証	出力
MCP agent_chat（https://funda.ai/api/mcp）	調査、分析、統合	OAuth（claude mcp add で自動）	免責事項付きの統合テキスト
REST（https://api.funda.ai の /v1/*）	未加工の構造化データ	FUNDA_API_KEY Bearer	JSON

どちらも有効な Funda AI サブスクリプションが必要です。

---

ステップ 1：利用するインターフェースを決める

ユーザーの要望	インターフェース
DCF／比較企業分析の解説、セクター概観、トランスクリプトの統合、企業概要	MCP
判断を伴う決算の事前予想／振り返り、予想上振れ・下振れの要因分析、ストーリーの整理	MCP
リアルタイムまたは日中の株価、日次終値の価格履歴	REST
オプションチェーンの未加工スナップショット、グリークス、GEX 時系列データ	REST
財務諸表の特定の項目（単一の数値、JSON）	REST
13F 提出書類、インサイダー取引、議会関係者の取引を行単位で取得	REST
構造化されたセンチメント／イベント時系列付きのニュース（JSON）	REST
データセットの一括ダウンロード	REST
AI 企業の採用シグナル（OpenAI、Anthropic、Google、xAI）	REST

曖昧な調査形式の質問では、MCP をデフォルトで使用してください。ユーザーが機械可読な構造化データを求めている場合、または MCP が対応を拒否する場合（リアルタイム価格、未加工の気配値）は、REST を使用してください。

MCP は、買い／売りの判断、目標株価、個別のポートフォリオに関する助言、税務／法律上の助言、取引の執行についても対応を拒否します。これらはどちらのインターフェースでも対象外です。丁寧にお断りし、別の回答を期待して REST に切り替えないでください。

---

ステップ 2：MCP のフロー（調査）

2a. MCP の接続を確認する

!`claude mcp list 2>/dev/null | grep -iE "^funda:" || echo "FUNDA_MCP_NOT_CONNECTED"`

• funda: で始まる行がある → 登録済みです。ツールは mcp__funda__agent_chat として呼び出せます。続行してください。
• FUNDA_MCP_NOT_CONNECTED → ユーザーにインストールを依頼します。

  claude mcp add --transport http funda https://funda.ai/api/mcp
  

  OAuth 承認用のブラウザータブが開きます（トークンの有効期間は 1 時間、更新トークンの有効期間は 30 日で、自動管理されます）。ツールが登録される前に、Claude Code のセッションを再起動する必要がある場合があります。

2b. 質問を組み立てる

agent_chat は新しい調査ターンとして実行され、呼び出しをまたいだ記憶はありません。ティッカー、期間、前提条件を質問文に含めてください。

ユーザーの要望	質問の例
決算の事前予想	「木曜日の MSFT の第 3 四半期決算を予想してください。セグメント別の傾向、コンセンサス予想が強気／慎重な点、予想の上振れ・下振れのパターンを示してください。」
決算の振り返り	「NVDA の第 2 四半期を詳しく説明してください。セグメント別の予想上振れ・下振れ、会社見通しとコンセンサス予想の比較、データセンター需要に関するトランスクリプトの質疑応答を含めてください。」
セクターの詳細分析	「2026 年のハイパースケーラーの設備投資サイクルを要約してください。企業名ごとの支出水準、サプライヤーのエクスポージャー、売上総利益率への影響を示してください。」
サプライチェーン	「TSMC の顧客集中度と N2 の立ち上げリスクを整理してください。売上高に基づく最大のエクスポージャーを 3 つ挙げてください。」
提出書類の要約	「PLTR の最新の 10-K と前年分を比較し、新たに追加されたリスク要因を示してください。」
DCF	「データセンターの成長率を 25％、最終利益率を 10％、WACC を 9％と仮定して、NVDA の DCF を解説してください。感応度分析表も示してください。」
マクロ経済	「米国はダリオの長期債務サイクルのどの段階にあり、それはデュレーション運用にどのような意味を持ちますか。」
保有状況	「最新の 13F 提出書類で CRWD の機関投資家保有状況に変化はありますか。買い越しですか、売り越しですか。」

ユーザーからティッカーだけが提示された場合は、呼び出しの前に、調査の範囲を定める確認質問を 1 つしてください（事前予想、振り返り、企業概要、DCF など）。曖昧な質問では 1 ターンを無駄にし、曖昧な回答が返ってきます。

ユーザーが以前の Funda の回答について追加質問している場合は、関連する段落を新しい質問に引用してください。エージェントは以前の呼び出しを記憶していません。

トピック別の質問例については、references/research-topics.md を参照してください。

2c. ツールを呼び出す

mcp__funda__agent_chat(question: "<full research question>")

通常の実行時間は15～60秒です。サーバーは実行中に進捗通知をストリーミングするため、クライアントがタイムアウトすることはありません。

レスポンスの形式：

• content[0].text — [Funda research output — fundamental analysis, informational only…] が先頭に付いた回答です。このプレフィックスはそのまま残してください。
• _meta["funda.io/conversation_id"] — UUID です。アプリ内の履歴ページは https://funda.ai/agent-chat?c=<id> です（/agent-chat ルートは /agent-chat-v2?c=<id> にリダイレクトされます）。
• _meta["funda.io/timed_out"] — エージェントが実行時間の上限に達した場合は true です。回答は不完全です。範囲を絞って再試行するよう提案してください。

呼び出しが403 subscription_required を返した場合、MCPは登録されていますが、アカウントは未契約です。有効化するには https://funda.ai に案内してください。

各呼び出しでリサーチターンを1回消費します。最初の回答が妥当な場合は、質問の表現を変えて推測で再度呼び出さないでください。

---

ステップ3：RESTフロー（生データ）

3a. FUNDA_API_KEY を解決する

スキルは次の順序で FUNDA_API_KEY を解決します。

1. FUNDA_API_KEY 環境変数
2. カレントディレクトリにある .env 内の FUNDA_API_KEY
3. gitリポジトリのルートにある .env 内の FUNDA_API_KEY（これにより、worktreeはメインのチェックアウトからキーを継承します）

!`if [ -n "$FUNDA_API_KEY" ]; then echo "KEY_FROM_ENV_VAR"; elif [ -f .env ] && grep -qE "^FUNDA_API_KEY=" .env; then echo "KEY_FROM_LOCAL_DOTENV:$(pwd)/.env"; else GIT_COMMON=$(git rev-parse --path-format=absolute --git-common-dir 2>/dev/null); if [ -n "$GIT_COMMON" ]; then ROOT=$(dirname "$GIT_COMMON"); if [ -f "$ROOT/.env" ] && grep -qE "^FUNDA_API_KEY=" "$ROOT/.env"; then echo "KEY_FROM_ROOT_DOTENV:$ROOT/.env"; else echo "KEY_NOT_SET"; fi; else echo "KEY_NOT_SET"; fi; fi`

次に、結果に応じて対応します。

• KEY_FROM_ENV_VAR — curlの呼び出しでは $FUNDA_API_KEY を直接使用します。
• KEY_FROM_LOCAL_DOTENV:<path> / KEY_FROM_ROOT_DOTENV:<path> — 呼び出しの前に一度読み込みます。

  export FUNDA_API_KEY=$(grep -E "^FUNDA_API_KEY=" <path> | head -1 | cut -d= -f2- | sed 's/^["'\'']//;s/["'\'']$//')
  

• KEY_NOT_SET — ユーザーにキーを尋ねます。export FUNDA_API_KEY="..." を実行するか、リポジトリのルートにある .env に FUNDA_API_KEY=... を追加できます（worktreeでは後者を推奨します）。

3b. 適切なエンドポイントを見つける

ユーザーのリクエストをカテゴリに対応付け、パラメーターとレスポンススキーマの全容を確認するため、該当するリファレンスファイルを読みます。

カテゴリ	エンドポイント群	リファレンス
リアルタイム／バッチ／時間外の株価	/v1/quotes?type=...	references/market-data.md
過去のEOD、日中足、テクニカル指標	/v1/stock-price、/v1/charts	references/market-data.md
コモディティ／外国為替／暗号資産の価格	/v1/quotes?type=commodity-quotes	references/market-data.md
損益計算書／貸借対照表／キャッシュフロー／指標／比率	/v1/financial-statements	references/fundamentals.md
企業プロフィール、同業他社、浮動株数、検索、スクリーナー、リスト	/v1/company-profile、/v1/company-details、/v1/search、/v1/companies	references/fundamentals.md
アナリスト予想、目標株価、評価、DCF、格付け	/v1/analyst?type=...	references/fundamentals.md
オプションチェーン、グリークス、GEX、IV、最大損失、フロー、スクリーナー	/v1/options/...	references/options.md
サプライチェーンKG：サプライヤー、顧客、競合他社、パートナー	/v1/supply-chain/...	references/supply-chain.md
Twitter、Reddit、Polymarket、政府取引、保有状況	/v1/twitter-posts、/v1/reddit-posts、/v1/polymarket/...、/v1/government-trading、/v1/ownership	references/alternative-data.md
AIで拡充されたニュース＋集約センチメント＋イベントのタイムライン	/v1/news/ticker、/v1/news/timeline、/v1/news/sentiment	references/news-enriched.md
SEC提出書類、決算／ポッドキャストの文字起こし、リサーチレポート	/v1/sec-filings、/v1/transcripts、/v1/investment-research-reports	references/filings-transcripts.md
決算／配当／IPO／株式分割／経済カレンダー	/v1/calendar?type=...	references/calendar-economics.md
米国債金利、GDP／CPI指標、FRED、リスクプレミアム	/v1/economics、/v1/fred	references/calendar-economics.md
株式ニュース、値上がり／値下がり銘柄、ETF保有銘柄、ESG、COT、一括データ、市場取引時間	/v1/news、/v1/market-performance、/v1/funds、/v1/esg、/v1/cot-report、/v1/bulk、/v1/market-hours	references/other-data.md
AI企業の採用シグナル（OpenAI、Anthropic、Google、xAI、Mercor、SurgeAI）	/v1/recruit-...	references/recruit.md
Bedrock経由のClaude APIプロキシ	/v1/claude/v1/messages	references/claude-proxy.md

3c. エンドポイントを呼び出す

curl -s -H "Authorization: Bearer $FUNDA_API_KEY" \
  "https://api.funda.ai/v1/<endpoint>?<params>" | python3 -m json.tool

すべてのレスポンスは {"code": "0", "message": "", "data": ...} です。code がゼロ以外の場合はエラーです — message を確認してください。

リストエンドポイントはページネーションされます: {"items": [...], "page": 0, "page_size": 20, "next_page": 1, "total_count": N}。ページは 0 始まりです。next_page は最後のページに達すると -1 になります。

幅広いティッカーの概要を得るには(「AAPL について教えて」)、いくつかの REST 呼び出しを組み合わせます: セクター/CEO/時価総額/価格には /v1/company-profile、/v1/financial-statements?type=key-metrics-ttm、/v1/analyst?type=price-target-summary を併用します。

---

Step 4: ユーザーに応答する

• MCP の合成出力の場合: 構造化して提示してください(表、箇条書き、見出し) — 生のデータの塊をそのまま出力しないでください。Funda の免責事項は保持し、分析を推奨、目標株価、取引シグナルとして再パッケージしないでください。
• MCP レスポンスの場合は、ユーザーがエージェントの完全なタイムラインを確認できるよう、https://funda.ai/agent-chat?c={conversation_id} を引用してください。
• REST レスポンスの場合は、数値をきれいに整形してください(価格は小数点以下 2 桁、比率は 2〜4 桁、大きな数値はカンマ区切りまたは $2.8T のような省略形)。比較データには表を使用し、時系列データをそのまま出力するのではなくトレンドを要約してください。
• DCF / バリュエーションの作業では、ユーザーが調整できるよう Funda が使用した前提条件を提示してください。
• 出典を明記してください: 「Funda AI」(MCP か REST かを問わず)。
• 取引の推奨は決して提供しないでください — データを提示し、ユーザーが結論を導けるようにしてください。

---

参照ファイル

MCP パス:

• references/research-topics.md — カテゴリ別の質問例と、agent_chat クエリを組み立てるためのヒント。

REST パス:

• references/market-data.md — 気配値、過去の価格、チャート、テクニカル指標
• references/fundamentals.md — 財務諸表、企業プロフィール/詳細、検索/スクリーナー、アナリスト、企業リスト
• references/options.md — オプションチェーン、グリークス、GEX、フロー、IV、スクリーナー、契約レベルのデータ
• references/supply-chain.md — サプライチェーンの KG、関係、グラフ探索
• references/alternative-data.md — Twitter、Reddit、Polymarket、政府取引、所有権
• references/news-enriched.md — AI で強化されたニュース、イベントタイムライン、集約されたセンチメント
• references/filings-transcripts.md — SEC 提出書類、決算/ポッドキャストのトランスクリプト、リサーチレポート
• references/calendar-economics.md — カレンダー、経済、財務省、FRED
• references/other-data.md — ニュース、市場パフォーマンス、ファンド、ESG、COT、バルク、市場時間
• references/recruit.md — AI 企業の採用シグナル、JD 分類、製品クラスター、ローンチ確率
• references/claude-proxy.md — Bedrock 経由の Claude API プロキシ