FactIQ

FactIQ — AI エージェント向けリアルタイム金融・経済データベース

エージェントを金融・経済アナリストに変えましょう。Claude（ウェブ、デスクトップ、Cowork）、ChatGPT（ウェブ、デスクトップ）、Claude Code、Codex 向けのこのプラグインを使うと、エージェントは FactIQ の公式統計データウェアハウス（SEC 提出書類、米国、中国、インド、韓国、IMF、World Bank など）に直接アクセスできます。さらに、リアルタイムの市場データ、決算説明会の文字起こし、経営幹部のメディア出演、中央銀行の講演、議事録、声明、衛星由来のデータ（火災検知、大気質活動シグナル、降雨、夜間光、海運・港湾活動、貯水池水位）も利用できます。エージェントは系列を見つけ、読み取り専用の SQL を実行し、派生指標を算出して、出典付きの回答、チャート JSON、またはレポート JSON を返します。

コードベースやホスト型データベースは不要です。必要なのは無料の FactIQ アカウントだけです。

貢献に興味がありますか？最も効果の大きい追加機能は、エージェントに一連の質問への対応方法を教えるドメインプレイブックです。詳しくは 貢献方法をご覧ください。

インストール

FactIQ は 4 種類のクライアントに対応しています。アプリの設定方法とプラン要件については、変更がこのリポジトリよりも速い場合があるため、公式ウェブサイトのガイドを正としてください。

Claude（ウェブ、デスクトップ、Cowork）

FactIQ は Claude の公式ディレクトリに掲載されています。Claude にサインインした状態で claude.ai/directory/factiqを開き、Connectをクリックして FactIQ にサインインし、新しいチャットを開始します。また、Customize → Pluginsで FactIQ を検索して見つけることもできます。最適なエクスペリエンスを得るには Cowork をお使いください。このプラグインの利用には、有料の Claude プランが必要です。

このリポジトリからインストールするには、Customize → Pluginsを開き、defog-ai/factiq-pluginを個人用マーケットプレイスとして追加し、FactIQ をインストールして、ブラウザーでサインインします。プラグインを一元的に承認する組織は、このリポジトリをプライベートマーケットプレイスとしてミラーリングできます。最新の手順と組織ポリシーに関する注意事項は、 Claude ガイドをご覧ください。

ChatGPT（ウェブ、デスクトップ）

FactIQ は ChatGPT の公式プラグインディレクトリに掲載されています。ChatGPT にサインインした状態で FactIQ の掲載ページ を開き、Install pluginをクリックして FactIQ にサインインし、新しいチャットを開始します。@FactIQと入力すると明示的に選択できます。ウェブとデスクトップアプリの両方で、ChatGPT Plus、Pro、Business、Enterprise、Edu プランをご利用の場合に使えます。Business、Enterprise、Edu では、ワークスペース管理者が事前に FactIQ の利用を許可する必要がある場合があります。このインストールには ChatGPT アプリ内の Codex も含まれます。Codex CLI には、以下の別のセットアップ方法を使用してください。

このリポジトリからインストールするには、ChatGPT デスクトップアプリでPluginsを開き、defog-ai/factiq-pluginをマーケットプレイスとして追加して、Personal タブから FactIQ をインストールします。この方法は、Pro、Business、Enterprise、または Edu プランをご利用の場合に限り、デスクトップアプリでのみ使えます。現在のプラン一覧とトラブルシューティングの手順は、 ChatGPT ガイドをご覧ください。

Claude Code

/plugin marketplace add defog-ai/factiq-plugin
/plugin install factiq@factiq
/reload-plugins

インストール後に /reload-plugins を実行して、現在のセッションで Claude Code に新しいスキルと MCP サーバーを認識させてください（実行しない場合は、Claude Code を次回起動したときに初めて表示されます）。

FactIQ スキル（経済・金融データに関する質問に対して Claude が自動的に呼び出します）と、同梱の FactIQ MCP サーバーが追加されます。Claude Code はプラグインからインストールされたスキルに名前空間を付与するため、手動で呼び出す場合のコマンドは次のとおりです。

最後に、MCP サーバーを認証します。

1. /mcp を実行します。
2. サーバーの一覧から factiq を選択します。
3. Authenticate（または Connect）を選択して、ブラウザーでのサインイン画面を開きます。
4. FactIQ にログインし（メール、Google、またはパスキー）、Claude Code に戻ります。これで FactIQ ツールが認証されます。

Codex

codex plugin marketplace add defog-ai/factiq-plugin
codex plugin add factiq@factiq

続いて、MCP サーバーを認証します。

codex mcp login factiq

ブラウザーでのサインインを完了します（FactIQ へのログイン方法は同じで、メール、Google、またはパスキーを使います）。インストール後に新しい Codex スレッドを開始してください。経済・金融データに関する質問にはスキルが自動的に呼び出されます。

codex plugin marketplace upgrade factiq
codex plugin add factiq@factiq

[mcp_servers.factiq]
url = "https://api.factiq.com/mcp"

claude mcp add --transport http factiq https://api.factiq.com/mcp

ブラウザーを使わない場合：スクリプト、CI、ヘッドレスエージェント

FactIQ のすべてのツールは、ブラウザーでのサインインの代わりに個人用 API キーを使っても動作します。factiq.com/settings/security でキーを作成してください。factiq.com/docs/api のガイドでは、キーを使って REST エンドポイントと MCP サーバーを呼び出す方法、およびブラウザーを使わずに Claude Code や Codex にサーバーを登録する方法を説明しています。キーをソース管理に含めないでください。設定ページでキーを再生成すると、古いキーはただちに無効になります。

プラグインが送信するデータと実行する処理

• 1 つのリモート MCP サーバー。 プラグインは https://api.factiq.com/mcp を追加します（.mcp.json を参照）。OAuth でサインインします。各ツール呼び出しでは、その引数（検索語、SQL 文、系列 ID、ティッカー、地域）がサーバーに送信され、FactIQ のデータが返されます。FactIQ は、プライバシーポリシーに記載のとおり、信頼性の確保とサポートのため、コネクターツールへの入力と出力を記録します。
• メッセージを送信する 1 つのツール。 send_feedback は、FactIQ の結果に誤りがあるように見える場合、エージェントが作成した短い報告を FactIQ チームに送信します。データは変更しません。その他のツールはすべてデータの読み取りのみを行います。
• ネットワークアクセスのないローカルスクリプト。 スキルは scripts/ 内の Python スクリプト（hs_codes.py、trade_sql.py、series_math.py）を実行できます。これらのスクリプトが読み取るのは、引数、渡されたファイル、および同梱されている scripts/data/ 内のファイルのみで、結果を出力します。ネットワーク呼び出しは行いません。
• ローカル出力のみ。 チャートとレポートは、使用しているワークスペース内のファイルとして書き込まれます。プラグインがそれらを外部に公開することはありません。
• プラグインにはフックがなく、インストール時に何も実行しません。

試してみる

インストールして認証したら、質問してみましょう：

/factiq:factiq How has India's trade deficit with China evolved since 2020?

エージェントは関連する系列を見つけ、SQL を実行し、質問内容に応じて、出典付きの回答、チャート JSON、または完全なレポートを返します。スラッシュコマンドを使う必要はありません。サポート対象のクライアントであれば、経済や金融データに関する質問をすると、スキルが自動的に呼び出されます。

「Micron の経営陣は最新の決算説明会で何を話しましたか？」といった業績に関する質問では、まずスキルが最新のトランスクリプトの対応状況を確認し、正確な会計四半期を特定してから、同じ説明会について、経営陣の発言と質疑応答での主な論点を絞り込んで取得します。発言内容は正式なガイダンスや SEC に提出された実績とは区別されます。ツールが生のトランスクリプトを返すことはありません。

「Jensen Huang は決算説明会以外で輸出規制についてどのように語ってきましたか？」といったメディアに関する質問では、スキルが企業レベルの構造化データの対応状況を確認し、関連度順で決定論的な語彙検索を実行します。時系列の場合に限り、明示的に新しい順で並べます。結果はタイムスタンプ付きの YouTube リンクを含む、一般公開に適した言い換えであり、引用ではありません。正確な言い回しや口調が重要な場合は、ワークフローでリンク先のソースを確認します。専用のプレイブックでは、メディアと決算説明会の比較対象が企業、人物、トピック、日付の各点で一致するように保たれます。

同じツールで、中央銀行や金融当局（Federal Reserve、European Central Bank、Bank of England、Bank of Japan、Reserve Bank of India など）が公開した文書も扱えます。「Bank of Japan はインフレ見通しについて何を述べていますか？」といった質問では、institution または country で絞り込み、各文書に記載されている会合日または講演日を報告します。

仕組み

コーディングエージェントがアナリストです。データを見つけ、計算を行い、ローカルの出力を作成します。データアクセスには、.mcp.json にバンドルされた FactIQ MCP サーバーを、1 つの OAuth 接続経由で使用します。

┌─────────────────────────────┐
│  Claude / ChatGPT /         │
│  Claude Code / Codex        │
│  + factiq skill (SKILL.md)  │      the agent orchestrates everything
└──────────────┬──────────────┘
               │  MCP over HTTP (one OAuth connection)
┌──────────────▼──────────────┐
│  FactIQ MCP server          │
│                             │
│  discover   search_datasets, describe_dataset, search_series,
│             get_data_catalog
│  fetch      run_sql (read-only), get_series, get_market_data,
│             search_company_filings, search_earnings_transcripts,
│             search_media_appearances, search_news
└──────────────┬──────────────┘
               │
┌──────────────▼──────────────┐
│  FactIQ data warehouse      │      official and derived data sources
└─────────────────────────────┘

1 つのスキルで、BLS の失業率、中国の税関貿易フロー、RBI の金融データ、World Bank の指標を、同じ SQL の慣用表現で照会できるのは、バックエンドのすべてのデータソースが、各スキーマで共通の 3 つのコアテーブルに正規化されているためです。

取り込みパイプラインが、BLS のフラットファイル、BEA API、税関記録、RBI の発表など、各ソース独自の形式をこの構造に変換するため、エージェントはデータモデルを一度学習すれば、あらゆるソースで活用できます。約 20 のすべてのスキーマで、データの探索、ピボット、絞り込みに同じパターンを適用できます。レシピは references/data/sql-guide.md にあります。

データウェアハウスの内容

静的な概要は references/data/schemas.md にあります。最新かつ正式な情報は get_data_catalog ツールから取得できます。

リポジトリの構成

動作を担うファイルです。コントリビューターが変更するファイルでもあります。

• skills/factiq/SKILL.md — スキルの定義であり、ワークフローに関する唯一の信頼できる情報源です。対応するプラグインクライアントが skills/ ディレクトリから自動検出します
• references/data/ — データレイヤー。SQL の慣用表現（sql-guide.md）とデータセットのスキーマ概要（schemas.md）があります
• references/output/ — ローカルの出力形式。ChartSpec（chart-spec.md）とレポート JSON（report-spec.md）があります
• references/report-patterns/ — 分野別の実践ガイド（金融政策、二国間貿易、二国間経済政策、財政政策の歳入、事業設立、決算情報、メディア出演情報）。report-patterns/README.md は SKILL.md が参照する唯一のエントリーポイントです。すべてのレポートで使用する弁証法的手法（主張 → 反論 → 統合）を説明し、各分野を対応する実践ガイドに案内するため、新しい実践ガイドを追加しても SKILL.md を変更する必要はありません

プラグインの構成要素です。通常、これらを変更する必要はありません。

• .mcp.json — 同梱の FactIQ MCP サーバー（Streamable HTTP、OAuth）を宣言します。Claude Code と Codex のプラグインローダーが読み込みます
• .claude-plugin/ — Claude と Claude Code のプラグインおよびマーケットプレイスのマニフェスト
• .codex-plugin/ — ChatGPT と Codex のプラグインマニフェスト
• .codex-plugin/plugin.json は、ChatGPT アプリとの関連付けに、登録済みの FactIQ アプリ ID をプラグイン名として使用します
• .agents/plugins/marketplace.json — codex plugin marketplace add defog-ai/factiq-plugin 用の Codex マーケットプレイスエントリー

コントリビューション

コントリビューションを歓迎します。このプラグインはコミュニティとともに成長していくことを目指しています。 Issue またはプルリクエストを作成してください。

独自スキル（ドメイン別プレイブック）— 最も効果の高い貢献

追加できるものの中で最も価値があるのは、ドメイン別プレイブックです。これは、エージェントが特定の種類の質問に適切に回答する方法を教えるリファレンスファイルです。プレイブックとは、あるドメインにおける議論の筋道をあらかじめ記述したものです。質問から導かれる主要な読み取り方、十分な知識を持つ懐疑論者が指摘する矛盾点、そして両方を取得するための SQL が含まれます（手法については references/report-patterns/README.mdを参照してください）。 既存のプレイブックは references/report-patterns/にあり、以下の内容を参考にしてください。

• monetary-policy.md — 中央銀行の政策スタンス、管理金利、公開市場操作、バランスシートの背景
• bilateral-trade.md — 国ごとの貿易動向、品目別要因、ミラー統計に関する注意点
• fiscal-policy-revenue.md — 政府収入、税の構成、分配の詳細

優れたプレイブックには、次の内容が含まれます。

1. トリガー — 対象とする質問の形式（「A 国と B 国の最新の貿易動向」、「FRB のスタンスを説明する」など）を定め、 references/report-patterns/README.mdのルーティング表に行として追加します。これにより、エージェントはデータを取得する前にプレイブックを読み込みます。SKILL.mdはこのルーターを参照しているため、変更する必要はありません。
2. 必須の網羅範囲 — ドメインにおける標準的な反対検証です。完全な回答に必要な照合項目（ミラー統計、実質値と名目値、構成、相手国の記録など）を取得することで、エージェントが最初に目についたグラフだけで止まるのを防ぎます。
3. すぐに使える SQL テンプレート — 主要な計算（最新月の前年同月比、年初来の比較、上位 N 件の要因）を行う、3 テーブルスキーマに対する検証済みクエリです。
4. 注意点とガードレール — 単位の正規化、基準年の変更、国レベルと地方レベルの取り違え、明示的に開示すべきデータの欠落などです。

ぜひ見てみたいテーマ：労働市場の健全性、インフレの要因分解、エネルギー市場、住宅、ソブリン債務、セクター別の収益分析、国別のマクロリスク概要。

その他、歓迎する貢献

• SQL の慣用句と落とし穴 — 実際の利用に基づくreferences/data/sql-guide.mdへの追記。
• ドキュメントと修正 — エージェントの最初の試行の成功率を高めるものなら、どのような内容でも歓迎します。

プレイブックの質問を最初から最後まで実行し、保存されたグラフまたはレポートの出力を確認してテストしてください。プルリクエストには、変更前と変更後の正確な例を含めてください。

セキュリティ

このリポジトリにシークレットを含めてはいけません。また、このプラグインにもシークレットは含まれていません。対話的なアクセスは MCP サーバーの OAuth フローを経由するため、コーディングエージェントがトークンを保持し、このリポジトリには何も書き込まれません。ヘッドレスでの使用には、FactIQ の設定ページで作成し、自分の環境内で管理する個人用 API キーを使用します。このキーがこのリポジトリに保存されることはありません。すべての SQL は、FactIQ のデータウェアハウスに対して読み取り専用で実行されます。

ライセンス

MIT