okx-sentiment-tracker

OKX ニュースとセンチメント

OKX 向けの暗号資産ニュース集約、コインのセンチメント分析、マクロ経済カレンダーです。すべてのコマンドは読み取り専用で、API 認証情報（OAuth2.1）が必要です。

機能

ユーザーの意図	コマンド
最新／重要なニュース	okx news latest
コイン別ニュース	okx news by-coin
キーワードでニュースを検索	okx news search
センチメントで絞り込んだニュース	okx news by-sentiment
記事全文	okx news detail
コインのセンチメントスナップショット	okx news coin-sentiment
センチメントの推移	okx news coin-trend
センチメントランキング	okx news sentiment-rank
ニュースソース一覧	okx news platforms
経済カレンダーの検索	okx news economic-calendar
有効なカレンダー地域	okx news list-regions

前提条件

1. okx CLI をインストールします：

   npm install -g @okx_ai/okx-trade-cli
   

2. ~/.okx/config.toml に認証情報を設定します
3. セットアップを確認します：

   okx news latest --limit 3
   

OKX ニュースはデモモードに対応していません。常に --profile live を暗黙的に使用してください。エラーが発生した場合を除き、これについて言及しないでください。

「not available in demo」エラーが発生した場合： ユーザーの現在のプロファイルは、デモ／シミュレーション用の認証情報で設定されています。ユーザーに「ニュースモジュールはデモモードに対応していません。ライブプロファイルに切り替えてください。」と伝えてください。次のいずれかの方法を案内します：

• ライブプロファイルが存在する場合は --profile live を使用します：okx --profile live news latest
• または、新しいプロファイルを作成します：okx config add-profile AK=<key> SK=<secret> PP=<passphrase> name=live

すべてのコマンドで、生の JSON 出力に --json を使用できます。

クイックスタート

# Latest news
okx news latest --limit 5

# Today's important news
okx news important --begin $(date -d 'today 00:00:00' +%s000 2>/dev/null || date -v0H -v0M -v0S +%s000)

# BTC news
okx news by-coin --coins BTC

# Search for SEC ETF news
okx news search --keyword "SEC ETF"

# BTC sentiment overview
okx news coin-sentiment --coins BTC

# Trending coins (hottest right now)
okx news sentiment-rank

# Upcoming economic events (today only)
okx news economic-calendar --before $(date -v0H -v0M -v0S +%s000) --after $(date -v+1d -v0H -v0M -v0S +%s000) --limit 100

意図 → コマンドの対応

ニュースを閲覧する

latest、by-coin、search のデフォルトは --importance low で、重要度の高低を問わずすべてのニュースが返されます。ユーザーが主要ニュース／速報／重要なニュースを明示的に求めた場合にのみ、--importance high を指定してください。専用の okx news important コマンドを使うと、この指定を簡略化できます。

ユーザーの発言	コマンド
「最近、暗号資産市場で何が起きていますか」／「最近のニュースをざっと教えて」	okx news latest
「今日、何か大きなニュースはありますか」／「今、主なニュースは何ですか」	okx news important
「昨日、暗号資産市場で何が起きましたか」	okx news latest --begin <yesterday_0am> --end <today_0am>
「最近、BTC に関するニュースはありますか」／「BTC はどうなっていますか」	okx news by-coin --coins BTC
「ETH または SOL に大きな動きはありますか」	okx news by-coin --coins ETH,SOL --importance high

ニュースを検索する

ユーザーの発言	コマンド
「SEC の ETF 決定について何か進展はありますか」	okx news search --keyword "SEC ETF"
「ステーブルコイン規制の最新情報は何ですか」	okx news search --keyword "stablecoin regulation"
「ビットコインの半減期について何かニュースはありますか」	okx news search --keyword "Bitcoin halving"

コインのセンチメントを分析する

ユーザーの発言	コマンド
「今の BTC 市場は強気ですか、弱気ですか」／「BTC に対する人々の見方はどうですか」	okx news coin-sentiment --coins BTC
「ETH と SOL に対する人々の見方を比べてください」	okx news coin-sentiment --coins ETH,SOL
「過去 24 時間で BTC のセンチメントはどう変化しましたか」	okx news coin-trend BTC --period 1h --points 24
「過去 1 週間の BTC のセンチメントを見せてください」	okx news coin-trend BTC --period 24h --points 7
「今、暗号資産で注目されているものは何ですか」／「最も注目を集めているコインはどれですか」	okx news sentiment-rank
「人々が最も期待しているコインはどれですか」／「強気なコインの上位を教えて」	okx news sentiment-rank --sort-by bullish
「最もネガティブなセンチメントのコインはどれですか」	okx news sentiment-rank --sort-by bearish

経済カレンダー

重大な注意 — 時間範囲を指定するには、必ず --before と --after の両方を使ってください。 --before だけを使うと、イベントが逆順で2028年まで返されます。その場合、--limit で最も近いイベントではなく、最も遠いイベントが切り捨てられます。必ず両方を指定してください。

意味（直感に反します）：--before <ts> = tsより新しいイベント（下限）、--after <ts> = tsより古いイベント（上限、デフォルト=現在）。

ユーザーの発言	コマンド
「今日の経済指標は何がありますか」 / 「economic events today」	okx news economic-calendar --before <today_0am_ms> --after <tomorrow_0am_ms> --limit 100
「今週、米国で重要な経済イベントは何がありますか」	okx news economic-calendar --region united_states --importance 3 --before <week_start_ms> --after <week_end_ms> --limit 100
「非農業部門雇用者数はいつ発表されますか」 / 「when is NFP」	okx news economic-calendar --region united_states --importance 3 --before <now_ms> --after <now_plus_60d_ms> --limit 100 を実行し、クライアント側で event フィールドを「Non Farm」でフィルタリングします
「CPIは発表されましたか」 / 「latest CPI data」	okx news economic-calendar --region united_states --importance 3 --limit 20（デフォルトの after=now で過去の重要度の高いイベントを取得します。actual フィールドを確認してください）
「欧州中央銀行の金利決定」 / 「ECB rate decision」	okx news economic-calendar --region euro_area --importance 3 --before <now_ms> --after <now_plus_90d_ms> --limit 100 を実行し、「Interest Rate Decision」でフィルタリングします

before / after の選び方：

意図	パラメーター	説明
今日のイベント	--before <today_0am> --after <tomorrow_0am>	範囲 = 今日の0:00 → 明日の0:00
今週のイベント	--before <week_start> --after <week_end>	範囲 = 月曜の0:00 → 日曜の24:00
今後N日間	--before <now> --after <now_plus_Nd>	範囲 = 現在 → N日先
過去のイベント（デフォルト）	両方を省略するか、--after <upper_bound>	デフォルトの after=now では、直近の過去イベントが返されます
過去の期間	--before <window_start> --after <window_end>	両方の境界を明示します

注意：

• ⚠️ 将来のイベントを検索する場合は、必ず --before と --after の両方を使ってください。 --before だけでは2028年まで返され、limitによって誤った側のイベントが切り捨てられます。例外は、デフォルトの after=now が適切な過去イベントの検索だけです。
• レート制限：5秒あたり1リクエスト（IPベース）。繰り返し呼び出さないでください。
• キーワード／イベントのフィルターはありません。レスポンスの event フィールドをクライアント側で確認してください。広い期間を指定して --limit 100 で単一の API 呼び出しを行い、結果をローカルでフィルタリングしてください（異なるキーワードを試すために呼び出しを繰り返さないでください）。
• ユーザーが特定の重要度（例：「重要な」「high importance」）を指定した場合は、--importance 3 を渡し、重要度が3のイベントのみを出力してください。重要度の低いイベントで結果数を補わないでください。
• 特定のイベント（NFP、CPI、ECBの決定）を検索する場合は、ノイズを減らすため、必ず --importance 3 を追加してください。これらはいずれも重要度の高いイベントです。対象イベントを確実に取得できるよう、--limit 100 と広い期間を指定してください。
• actual="" = 未発表、空でない値 = 発表済み。
• 3か月を超える過去データにはVIP1以上が必要です。
• デモモードはサポートされていません。通知せずに --profile live を使用してください。
• --region の値は snake_case です（例：united_states、euro_area）。無効な値を指定してもエラーは出ず、結果が空になります。 結果が空で、地域名の誤記が疑われる場合は、okx news list-regions を実行して有効な210個の値すべてを取得し、ユーザーの入力に近い値を照合して再試行してください。正確な値が分からない場合は、--region を省略し、レスポンスの region フィールドでクライアント側フィルタリングを行ってください。

BTCのマクロ経済の影響（スキル横断）

ユーザーの発言	ワークフロー
「BTCはどのようなマクロデータの影響を受けますか」 / 「macro impact on BTC this week」	→ BTCマクロ経済の影響ワークフロー
「今週のマクロ経済は暗号資産にどのような影響を与えますか」 / 「how will macro data affect crypto」	→ BTCマクロ経済の影響ワークフロー

これらのクエリでは、経済カレンダー、BTCのセンチメント／ニュース、市場データを並列に実行する必要があります。順番に実行しないでください。

センチメントの異常検知（複数コイン）

ユーザーの発言	ワークフロー
「どのコインのセンチメントが最も大きく変化しましたか」／「センチメントに異常はありますか」／「センチメントが反転したコインはどれですか」	→ 異常検知ワークフロー
「過去1週間で何か異変はありましたか」／「センチメントの急変」／「センチメントの反転」	→ 異常検知ワークフロー
「急に強気／弱気に転じたコインはありますか」／「強気／弱気に転じたコインはありますか」	→ 異常検知ワークフロー

これらのクエリには、広く調べてから深掘りするアプローチが必要です。まずすべてのコインをスキャンして異常を検出し、その後、ニュースとの相関を詳しく調べます。references/workflows.md の複数フェーズのワークフローに従ってください。分析対象のコインをいくつか選ぶだけでは不十分です。

ソースで絞り込んだニュース

--platform を使って、ニュースソースを直接絞り込みます。okx news platforms で正確な値を必ず確認してください。ユーザーの表現からプラットフォーム識別子を推測してはいけません。

ユーザーの発言	コマンド
「ChainCatcher の最近の報道を教えて」／「ChainCatcher のニュースを見せて」	okx news latest --platform <platform_id> --limit 10
「Odaily のニュースはありますか」／「TechFlowPost のニュースを教えて」	okx news latest --platform <platform_id> --limit 10
「吴说区块链の最近のニュースはありますか」／「特定のニュースメディアのニュースを教えて」	okx news latest --platform <platform_id> --limit 20

重要：ソースで絞り込む場合は、取得結果を最大化するため、--limit を大きめ（10～20）に設定してください。個々のソースの記事数は通常、集約フィードより少ないためです。ここでは --importance low（デフォルト）が適切です。--importance high に絞り込まないでください。

プラットフォームによって投稿頻度は一定ではありません。 API の --begin のデフォルトは72時間前ですが、投稿が集中するソースには範囲が狭すぎるため、結果が0件になることがよくあります。--platform で絞り込んだクエリの結果が約5件未満（または0件）の場合は、そのソースにデータがないと判断する前に、--begin を7日前、次に30日前に設定して再試行してください。候補となるプラットフォーム ID は okx news platforms で確認してください。どのプラットフォームが有効かを決めつけてはいけません。

スキル横断ワークフロー

複数ステップのシナリオ（市場概況、日次ブリーフィングなど）と、MCP ツールから CLI への完全な対応表については、references/workflows.md を参照してください。

コマンドリファレンス

okx news latest

最新の暗号資産ニュースを時刻順に取得します。

okx news latest [--coins BTC,ETH] [--begin <ms>] [--end <ms>]
               [--importance high|low] [--platform <source>]
               [--detail-lvl brief|summary|full] [--lang zh-CN|en-US]
               [--limit 10] [--after <cursor>] [--json]

--importance のデフォルトは low です（重要度の高低を問わず、すべてのニュースを返します）。速報や主要ニュースのみに絞り込む場合は --importance high を指定するか、okx news important を使用してください。

---

okx news important

複数のソースで報じられた、影響度の高い速報を取得します。

okx news important [--coins BTC,ETH] [--begin <ms>] [--end <ms>]
                  [--detail-lvl brief|summary|full]
                  [--lang zh-CN|en-US] [--limit 10] [--json]

---

okx news by-coin

特定のコインに関するニュースを取得します。

okx news by-coin --coins <BTC,ETH,...>
               [--importance high|low] [--platform <source>]
               [--begin <ms>] [--end <ms>] [--lang zh-CN|en-US]
               [--limit 10] [--json]

--importance のデフォルトは low です（すべてのニュースを返します）。速報や主要ニュースのみを取得する場合に限り、--importance high を指定してください。

---

okx news search

任意のフィルターを指定して、全文キーワード検索を行います。

okx news search --keyword <text>
               [--coins BTC,ETH] [--importance high|low]
               [--platform <source>]
               [--sentiment bullish|bearish|neutral]
               [--sort-by latest|relevant]
               [--begin <ms>] [--end <ms>] [--lang zh-CN|en-US]
               [--limit 10] [--after <cursor>] [--json]

--importance のデフォルトは low です（すべてのニュースを返します）。速報や主要ニュースのみを取得する場合に限り、--importance high を指定してください。

---

okx news detail

ID を指定して、記事の全文を取得します。

okx news detail <id>                  # news ID from previous result
               [--lang zh-CN|en-US] [--json]

---

okx news by-sentiment

キーワードを指定せずに、センチメントで絞り込んだニュースを閲覧します。

okx news by-sentiment --sentiment <bullish|bearish|neutral>
               [--coins BTC,ETH] [--importance high|low]
               [--sort-by latest|relevant]
               [--begin <ms>] [--end <ms>] [--lang zh-CN|en-US]
               [--limit 10] [--after <cursor>] [--json]

--importance のデフォルトは low です（すべてのニュースを返します）。速報や主要ニュースのみを取得する場合に限り、--importance high を指定してください。

---

okx news platforms

利用可能なニュースプラットフォームを一覧表示します。返された値は、ソースで絞り込む際に latest、by-coin、または search コマンドの --platform に指定してください。

okx news platforms [--json]

---

okx news coin-sentiment

特定のコインの現在のセンチメントスナップショットを取得します。

okx news coin-sentiment --coins <BTC,ETH,...>
               [--period 1h|4h|24h]  # aggregation granularity, default 24h
               [--json]

返される値：symbol、label（強気／弱気／中立／混合）、bullishRatio、bearishRatio、mentionCount。

---

okx news coin-trend

あるコインのセンチメント推移を時系列で取得します。注：位置引数を使用します（--coins ではありません）。

okx news coin-trend <coin>            # positional arg, e.g. BTC
               [--period 1h|4h|24h]  # aggregation granularity, default 1h
               [--points 24]          # trend data points, default 24
               [--json]

trendPoints の目安：期間が1時間の場合は24（過去24時間）、4時間の場合は6、24時間の場合は7を指定します。

---

okx news sentiment-rank

ソーシャル上の話題性またはセンチメントの方向性によるコインランキングを取得します。

okx news sentiment-rank [--period 1h|4h|24h]
               [--sort-by hot|bullish|bearish]  # hot=by mentions (default), bullish, bearish
               [--limit 10]                     # max 50
               [--json]

---

okx news economic-calendar

マクロ経済カレンダーのデータを取得します。3か月を超える過去データには VIP1+ が必要です。

okx news economic-calendar [--region <country>] [--importance <1|2|3>]
                           [--before <ms>] [--after <ms>]
                           [--limit 100] [--json]

レート制限：5秒あたり1リクエスト（IP単位）。他のニュースコマンドよりも大幅に厳しくなっています。

before/after は逆の意味です：--before <ts> = ts より新しい（未来）、--after <ts> = ts より古い（過去）。例については Economic Calendar intent mapping を参照してください。

主な地域：united_states、china、euro_area、united_kingdom、japan、germany、canada、australia

重要度：1=低、2=中、3=高

---

okx news list-regions

economic-calendar の有効な --region の値をすべて一覧表示します。地域のクエリで結果が空の場合に、値を確認するために使用します。

okx news list-regions [--json]

---

MCP ツールリファレンス

ツール	説明
news_get_latest	時刻順に並べた最新ニュースです。サーバーのデフォルトは importance=high（絞り込みあり）です。すべてのニュースを対象に広げるには、importance=low を指定します。
news_get_by_coin	特定のコインに関するニュースです（coins はカンマ区切りの文字列です）
news_search	フィルターを使った全文キーワード検索です（任意の sentiment フィルターを指定できます）
news_get_detail	ID に基づく記事全文です
news_get_domains	利用可能なニュースソースのドメインを一覧表示します
news_get_coin_sentiment	センチメントのスナップショット（trendPoints なし）、または時系列のトレンド（trendPoints を指定）です
news_get_sentiment_ranking	話題性またはセンチメントの方向性によるコインランキングです
news_get_economic_calendar	マクロ経済カレンダーのデータです。レート制限は5秒あたり1リクエストです
news_list_calendar_regions	economic-calendar で有効な210の地域の値をすべて一覧表示します

コインシンボルの正規化

API が受け付けるのは、標準的な大文字のティッカーシンボル（例：BTC、ETH、SOL）のみです。ユーザーはコインを正式名称、略称、俗称、または各言語での愛称で呼ぶ場合があります。コマンドに渡す前に、必ず正しいティッカーに解決してください。対象のコインが特定できない場合は、検索する前にユーザーに確認してください。

空の結果とウェブ検索のフォールバック

ニッチなコインや非常に具体的なキーワード検索では、OKX のニュースデータが少ない場合があります。API のデフォルトの --begin 期間は72時間にすぎず、それだけで多くの検索結果が空になる原因となります。コマンドの結果が空、または不十分な場合は、ウェブ検索に進まず、次の手順を順番に適用してください。

1. --platform を使用した場合 — ほかの条件を変更する前に、--begin を7日前、次に30日前まで広げます。投稿頻度にばらつきのあるソースでは、デフォルトの期間で0件でも、より広い期間では数十件返されることがよくあります。
2. --importance high を指定した場合 — これを外します（デフォルトはすでに low = すべてのニュースです）。
3. 狭い時間範囲が原因と思われる場合は、--platform 以外のクエリでも --begin / --end の範囲を広げます。
4. コインを指定したクエリで何も得られなかった場合は、--coins を外して一般的なニュースを取得します。
5. ウェブ検索を補足として使用します — "<topic> news site:coindesk.com OR site:cointelegraph.com OR site:theblock.co" をウェブで検索して追加の情報を集め、OKX の結果と合わせて統合した概要を作成します。
6. 情報源を明示します — ユーザーが情報源の信頼性を判断できるよう、OKX API とウェブ検索のどちらから得た結果かを伝えます。

このフォールバックは、特に次の場合に有効です。

• 報道量の少ないコイン（例：新規上場トークン）
• 一致する結果がない、非常に具体的なキーワード検索
• 選択したソースの投稿頻度にばらつきがある --platform クエリ

既知の制限

ソースのカバレッジ

プラットフォームごとの投稿頻度は異なり、時間とともに変化します。1日に多くの記事を公開するソースもあれば、投稿が集中する時期と、その間の静かな時期を繰り返すソースもあります。デフォルトの72時間のウィンドウで記事がほとんど、またはまったく返されないからといって、そのソースが非アクティブであるとは限りません。単に最近投稿していないだけか、最近の投稿が重複排除によって除外された可能性があります。

--platform で絞り込んだクエリにデータがないと判断する前に、次の手順を実行してください。

1. --begin を7日前まで広げて再試行し、次に30日前まで広げて再試行します。
2. 30日間のウィンドウでも結果がない場合は、そのソースから最近の記事が見つからなかったことをユーザーに伝え、--platform を削除して集約フィードを利用するか、ウェブ検索を行うよう提案します。

どのプラットフォームがアクティブかについて、前提をハードコードしないでください。okx news platforms から候補を取得し、データに基づいて判断してください。

過去の検索に関する制限

okx news search と okx news by-coin は、主に最近の記事（通常は当日および直近数日）をインデックスします。約7日以上前の日付を指定して --begin／--end で検索すると、その時点で記事が存在していても、結果が空になることがあります。これはAPIのインデックスに関する制限であり、データが存在しないことを意味するものではありません。

過去の分析には、記事検索よりも okx news coin-trend（センチメントのトレンドデータ）のほうが信頼できます。こちらは時系列データをより長期間保持します。

エッジケース

• ページネーション：次のページを取得するには --after <cursor> を使用します。カーソルはレスポンスの nextCursor から取得します。
• 時間パラメーター：--begin／--end はUnixエポックミリ秒です。
• コインの形式：大文字のシンボルをカンマ区切りで指定します（例：BTC,ETH,SOL）。正式名称や別名は指定しないでください。
• coin-trend --points：必ず明示的に指定します。1h→24、4h→6、24h→7
• 言語：ユーザーのメッセージから推定します。中国語の場合は --lang zh-CN、英語の場合は --lang en-US（デフォルト）を指定します。
• sentiment-rank --sort-by：hot＝言及数順（デフォルト）、bullish＝強気順、bearish＝弱気順