パーソナルファイナンススキル
銀行業務、投資、税務、市場情報、ソーシャルセンチメント、財務分析のワークフロー向けに、7つの拡張機能で75のツールを提供する包括的なパーソナルファイナンス管理スキル。
使用するタイミング
以下の要求があった場合にこのスキルを有効化します：
- 口座集約 — 銀行口座の接続、残高表示、取引の同期
- 純資産/キャッシュフロー — 合計額の計算、支出の追跡、貯蓄率分析
- ポートフォリオ監視 — ポジション、アロケーション、パフォーマンス、ドリフト検出
- 取引 — 注文の執行/取消、市場データ、資産検索（Alpaca）
- 税最適化 — 推定納税額、TLH候補、みなし売却チェック、四半期納付
- 税務書類処理 — W-2、1099-B/DIV/INT、K-1、Form 1040、Schedule A-E/SE、Form 8949、Form 6251（AMT）、州申告書の解析
- 市場情報 — 企業ニュース、SECファイリング、アナリスト推奨、経済データ（FRED、BLS）、ニュースセンチメント
- ソーシャルセンチメント — StockTwitsのセンチメント、X/Twitterのキャッシュタグ分析、トレンド銘柄、議会取引
- 経常費用追跡 — サブスクリプション、請求書、収入源
- 異常検知 — 異常取引、残高急落、重複請求
- ファイナンシャルブリーフィング — アクションアイテム付きの週次/月次サマリー
- スケジュール財務ワークフロー — cronベースのスキャン、アラート、レポート
アーキテクチャ概要
7つの拡張機能が3層に構成されています：
インテリジェンス層
tax-engine（23ツール） — 解析（15）、納税額、TLH、みなし売却、
ロット、Schedule D計算、州税、AMT
market-intel（10ツール） — ニュース、ファンダメンタルズ、SECファイリング、経済データ
social-sentiment（6ツール） — StockTwits、X/Twitter、議会取引
データソースアダプター
plaid-connect（8） alpaca-trading（10） ibkr-portfolio（9）
基盤層
finance-core（9ツール） — 正規モデル、ストレージ、正規化、
ポリシーチェック、異常検知、ブリーフ
データフロー: アダプターがプロバイダデータを取得 → finance-coreが正規化・保存 → インテリジェンス層が分析 → ポリシーエンジンがアクションをゲート。
ツールカタログ
finance-core — 9ツール
| ツール | 説明 | リスク |
|---|---|---|
finance_upsert_snapshot | 正規化された財務データスナップショットを保存（冪等） | LOW |
finance_get_state | 現在の財務状態を取得（口座、ポジション等） | READ |
finance_get_transactions | フィルターとページネーションで取引を照会 | READ |
finance_get_net_worth | カテゴリ/口座別の純資産内訳を計算 | READ |
finance_detect_anomalies | 異常取引、残高急落、手数料急騰をスキャン | READ |
finance_cash_flow_summary | 貯蓄率付きカテゴリ別収入対支出 | READ |
finance_subscription_tracker | 経常請求とサブスクリプションパターンを識別 | READ |
finance_generate_brief | アクションアイテム付き構造化財務サマリーを作成 | READ |
finance_policy_check | ポリシールールに基づき提案アクションを検証 | READ |
完全なスキーマ: references/ext-finance-core.md
plaid-connect — 8ツール
| ツール | 説明 | リスク |
|---|---|---|
plaid_create_link_token | 口座接続用Plaid Linkを初期化 | LOW |
plaid_exchange_token | 公開トークンを恒久アクセスと交換 | MED |
plaid_get_accounts | 残高付き接続口座一覧 | READ |
plaid_get_transactions | カーソルベース同期で取引を取得 | READ |
plaid_get_investments | 保有銘柄、証券、投資取引を取得 | READ |
plaid_get_liabilities | クレジット、学生ローン、住宅ローン情報を取得 | READ |
plaid_get_recurring | 経常の入出金ストリームを識別 | READ |
plaid_webhook_handler | 受信Plaid Webhookイベントを処理 | LOW |
完全なスキーマ: references/ext-plaid-connect.md
alpaca-trading — 10ツール
| ツール | 説明 | リスク |
|---|---|---|
alpaca_get_account | 口座残高、購買力、ステータスを取得 | READ |
alpaca_list_positions | すべてのオープンポジションを一覧表示 | READ |
alpaca_get_position | 銘柄別に単一ポジションを取得 | READ |
alpaca_list_orders | ステータス/日付フィルターで注文を一覧表示 | READ |
alpaca_create_order | 安全チェック付きで買い/売り注文を提出 | HIGH |
alpaca_cancel_order | 保留中の注文をキャンセル | MED |
alpaca_portfolio_history | 過去の株式価値と損益の時系列 | READ |
alpaca_get_assets | クラス/取引所別に取引可能資産を検索 | READ |
alpaca_market_data | 銘柄のスナップショット、バー、またはクォートを取得 | READ |
alpaca_clock | 市場が開いているか、次の開場/閉場を確認 | READ |
完全なスキーマ: references/ext-alpaca-trading.md
ibkr-portfolio — 9ツール
| ツール | 説明 | リスク |
|---|---|---|
ibkr_auth_status | ゲートウェイ認証ステータスを確認 | READ |
ibkr_tickle | ゲートウェイセッションを維持（約1分間隔） | LOW |
ibkr_list_accounts | 口座を一覧表示（最初に呼び出す必要あり） | READ |
ibkr_get_positions | 口座のポジションを取得（ページネーション） | READ |
ibkr_portfolio_allocation | 資産クラス、セクター、グループ別アロケーション | READ |
ibkr_portfolio_performance | NAV時系列とリターン | READ |
ibkr_search_contracts | 銘柄/名前/タイプで契約を検索 | READ |
ibkr_market_snapshot | 契約のリアルタイム市場データ | READ |
ibkr_get_orders | 現在のライブ注文を取得 | READ |
完全なスキーマ: references/ext-ibkr-portfolio.md
tax-engine — 23ツール
| ツール | 説明 | リスク |
|---|---|---|
tax_parse_1099b | 1099-Bを解析（収入、原価基準、みなし売却） | READ |
tax_parse_1099div | 1099-DIVを解析（配当、キャピタルゲイン） | READ |
tax_parse_1099int | 1099-INTを解析（利子、債券プレミアム） | READ |
tax_parse_w2 | W-2を解析（給与、源泉徴収、社会保障/メディケア） | READ |
tax_parse_k1 | Schedule K-1を解析（パートナーシップパススルー） | READ |
tax_parse_1040 | Form 1040を解析（主要連邦申告書） | READ |
tax_parse_schedule_a | Schedule Aを解析（項目別控除、SALT上限） | READ |
tax_parse_schedule_b | Schedule Bを解析（利子/配当支払者） | READ |
tax_parse_schedule_c | Schedule Cを解析（自営業収入） | READ |
tax_parse_schedule_d | Schedule Dを解析（キャピタルゲイン相殺） | READ |
tax_parse_schedule_e | Schedule Eを解析（賃貸/ロイヤルティ/パートナーシップ） | READ |
tax_parse_schedule_se | Schedule SEを解析（自営業税） | READ |
tax_parse_form_8949 | Form 8949を解析（売却と処分） | READ |
tax_parse_state_return | 州申告書を解析（CA 540、NY IT-201等） | READ |
tax_parse_form_6251 | Form 6251を解析（AMT） | READ |
tax_estimate_liability | 税率表で連邦/州税を計算 | READ |
tax_find_tlh_candidates | タックスロスハーベスティング機会を識別 | READ |
tax_check_wash_sales | みなし売却ルールの遵守を検証（61日間ウィンドウ） | READ |
tax_lot_selection | 提案売却に対するFIFO/LIFO/特定IDを比較 | READ |
tax_quarterly_estimate | セーフハーバー付き四半期推定納付額 | READ |
tax_compute_schedule_d | 損失繰越付きSchedule D相殺を計算 | READ |
tax_compute_state_tax | CA/NY/NJ/IL/PA/MA/TX/FLの州税を計算 | READ |
tax_compute_amt | 代替ミニマム税を計算（Form 6251） | READ |
完全なスキーマ: references/ext-tax-engine.md
market-intel — 10ツール
| ツール | 説明 | リスク |
|---|---|---|
intel_company_news | 企業の最近のニュース記事を取得（Finnhub） | READ |
intel_market_news | カテゴリ別の一般市場ニュースを取得（Finnhub） | READ |
intel_stock_fundamentals | 報告された財務諸表を取得（Finnhub） | READ |
intel_analyst_recommendations | アナリストの買い/保有/売りコンセンサスを取得（Finnhub） | READ |
intel_sec_filings | ティッカー別に企業のSECファイリング一覧を取得（EDGAR） | READ |
intel_sec_search | SECファイリング全体の全文検索（EDGAR） | READ |
intel_fred_series | 経済時系列を取得（GDP、CPI、金利）（FRED） | READ |
intel_fred_search | キーワードでFRED系列を検索 | READ |
intel_bls_data | 労働/物価統計時系列を取得（BLS） | READ |
intel_news_sentiment | AIスコア付きセンチメントのニュースを取得（Alpha Vantage） | READ |
完全なスキーマ: references/ext-market-intel.md
social-sentiment — 6ツール
| ツール | 説明 | リスク |
|---|---|---|
social_stocktwits_sentiment | 銘柄の強気/弱気センチメントを取得（StockTwits） | READ |
social_stocktwits_trending | 現在トレンドのシンボルを取得（StockTwits） | READ |
social_x_search | キーワードで最近のツイートを検索（X/Twitter） | READ |
social_x_user_timeline | ユーザーの最近のツイートを取得（X/Twitter） | READ |
social_x_cashtag | キーワードセンチメントスコアリングでキャッシュタグを検索（X） | READ |
social_quiver_congress | 議会の株式取引開示を取得（Quiver） | READ |
完全なスキーマ: references/ext-social-sentiment.md
主要ワークフロー
1. オンボーディング — 口座接続
plaid_create_link_token(products: ["transactions", "investments", "liabilities"])
→ ユーザーがPlaid Linkを完了
→ plaid_exchange_token(publicToken)
→ plaid_get_accounts → finance_upsert_snapshot(source: "plaid")
→ plaid_get_transactions → finance_upsert_snapshot
→ plaid_get_investments → finance_upsert_snapshot
→ finance_get_net_worth → ベースラインをユーザーに提示
2. 日次スキャン — 異常検知
plaid_get_transactions(cursor) → finance_upsert_snapshot
alpaca_list_positions → finance_upsert_snapshot(source: "alpaca")
ibkr_auth_status → ibkr_get_positions → finance_upsert_snapshot(source: "ibkr")
→ finance_detect_anomalies(lookbackDays: 7)
→ 中/高 severityの検出結果をアラート
3. タックスロスハーベスティング
finance_get_state(include: ["positions"])
→ tax_find_tlh_candidates(positions, marginalRate)
→ tax_check_wash_sales(proposedSales, recentPurchases)
→ tax_lot_selection(symbol, qty, lots)
→ finance_policy_check(actionType: "tax_move")
→ [承認された場合] alpaca_create_order(side: "sell", ...)
4. 四半期税務レビュー
tax_parse_w2 + tax_parse_1099b + tax_parse_1099div + tax_parse_1099int
→ tax_estimate_liability(filingStatus, income)
→ tax_quarterly_estimate(projectedIncome, priorYearTax, paymentsMade)
→ finance_generate_brief(period: "quarterly")
5. ポートフォリオ監視
alpaca_list_positions + ibkr_get_positions
→ finance_upsert_snapshot (両ソース)
→ ibkr_portfolio_allocation (ドリフト確認)
→ alpaca_portfolio_history (パフォーマンストレンド)
→ finance_detect_anomalies
→ finance_generate_brief(period: "weekly")
6. 企業調査 — 市場情報
intel_company_news(symbol: "AAPL", limit: 10)
→ intel_analyst_recommendations(symbol: "AAPL")
→ intel_stock_fundamentals(symbol: "AAPL", freq: "quarterly")
→ intel_sec_filings(symbol: "AAPL", formType: "10-K")
→ intel_news_sentiment(tickers: "AAPL")
→ social_stocktwits_sentiment(symbol: "AAPL")
→ social_x_cashtag(symbol: "AAPL")
7. 経済概観
intel_fred_series(seriesId: "GDP")
→ intel_fred_series(seriesId: "CPIAUCSL")
→ intel_fred_series(seriesId: "UNRATE")
→ intel_bls_data(seriesIds: ["CES0000000001"])
→ intel_fred_series(seriesId: "DFF")
8. 完全な税務申告書処理
tax_parse_1040(rawData) → tax_parse_schedule_a(rawData)
→ tax_parse_schedule_b(rawData) → tax_parse_schedule_c(rawData)
→ tax_parse_schedule_d(rawData) → tax_parse_schedule_e(rawData)
→ tax_parse_form_8949(rawData) → tax_parse_schedule_se(rawData)
→ tax_compute_schedule_d(gains, losses, carryovers)
→ tax_compute_state_tax(stateCode, taxableIncome, filingStatus)
→ tax_compute_amt(taxableIncome, adjustments, regularTax)
→ tax_parse_state_return(rawData)
9. 議会取引シグナル
social_quiver_congress(daysBack: 30)
→ 大口購入でフィルター
→ intel_company_news(symbol: <top_ticker>)
→ alpaca_market_data(symbols: <top_ticker>)
→ social_stocktwits_sentiment(symbol: <top_ticker>)
設定
環境変数
| 変数 | 拡張機能 | 説明 |
|---|---|---|
PLAID_CLIENT_ID | plaid-connect | Plaid APIクライアントID |
PLAID_SECRET | plaid-connect | Plaid API秘密鍵 |
PLAID_ENV | plaid-connect | sandbox / development / production |
ALPACA_API_KEY | alpaca-trading | Alpaca APIキー |
ALPACA_API_SECRET | alpaca-trading | Alpaca API秘密鍵 |
ALPACA_ENV | alpaca-trading | paper / live |
IBKR_BASE_URL | ibkr-portfolio | クライアントポータルゲートウェイURL |
FINNHUB_API_KEY | market-intel | Finnhub APIキー（finnhub.io） |
FRED_API_KEY | market-intel | FRED APIキー（fred.stlouisfed.org） |
BLS_API_KEY | market-intel | BLS登録キー（v2） |
ALPHA_VANTAGE_API_KEY | market-intel | Alpha Vantage APIキー |
X_API_BEARER_TOKEN | social-sentiment | X/Twitter OAuth 2.0 Bearer Token |
QUIVER_API_KEY | social-sentiment | Quiver Quantitative APIキー |
拡張機能設定
各拡張機能にはopenclaw.plugin.jsonとconfigSchemaがあります。主要設定：
- finance-core:
storageDir、anomalyThresholds、policyRulesPath - plaid-connect:
plaidEnv、webhookUrl、clientName、countryCodes - alpaca-trading:
env（paper/live）、maxOrderQty、maxOrderNotional - ibkr-portfolio:
baseUrl、defaultAccountId - tax-engine:
defaultFilingStatus、defaultState、defaultTaxYear - market-intel:
finnhubApiKeyEnv、fredApiKeyEnv、blsApiKeyEnv、alphaVantageApiKeyEnv、secEdgarUserAgent - social-sentiment:
xApiBearerTokenEnv、quiverApiKeyEnv
Cron例
週次レビュー
0 8 * * 1 # 月曜午前8時
ワークフロー：
finance_get_state → ポートフォリオアロケーション（drift）→ 異常検知 → ブリーフ
日次残高スキャン
0 7 * * * # 毎日午前7時
ワークフロー：
plaid_get_accounts → 純資産更新 → 前日残高との比較 → 大きな変動があればアラート
四半期税務リマインダー
0 9 15 1,4,6,9 * # 1月、4月、6月、9月の15日
ワークフロー：
finance_get_state → 収入推定 → 納税額計算 → リマインダー生成
セキュリティとコンプライアンス
リスクレベル
- LOW: べき等、副作用なし
- READ: 読み取り専用データ取得
- MED: 構成/権限の変更、または実行の可能性
- HIGH: 実際の金融取引（承認ゲート必須）
すべてのHIGHリスクツールは、finance_policy_checkを介したポリシールールの検証を必要とします。デフォルトポリシーでは以下の制限があります：
- 1日あたりの株式売買高制限
- 取引不可銘柄（ブラックリスト）
- ドリフトベースのリバランス制限
- 節税売却前のみなし売却チェック
- イベント前のユーザー確認
データプライバシー
- すべての財務データはローカルに保存され、スキルデータディレクトリに保存されます
- いかなる第三者とも共有されません
- APIキーは環境変数または設定を通じて提供されます
- トークンの交換はスキルの実行コンテキスト内でのみ行われます
参照
免責事項: このスキルは情報提供および自動化目的です。財務上のアドバイスを構成するものではありません。重要な財務上の意思決定を行う前に、資格のある専門家に相談してください。すべての取引は、ご自身の責任で行ってください。