okx-cex-skill-mp

OKX Skills Marketplace

OKX Skills Marketplace から AI 取引スキルを閲覧、検索、インストール、管理できます。スキルは、取引アシスタントの機能を拡張するモジュール式の AI プロンプトパッケージです。市場分析、取引の実行、リスク管理、ポートフォリオの最適化などを網羅しています。

⚠️ サードパーティコンテンツに関する注意 OKX Skills Marketplace で利用できるスキルは、OKX ではなく、独立したサードパーティの開発者が作成、公開したものです。OKX は、サードパーティ製スキルのコンテンツ、正確性、動作について、作成、審査、推奨、責任のいずれも行いません。使用前に必ずスキルの SKILL.md を確認し、信頼できる作成者のスキルのみをインストールしてください。 okx skill add を使ってスキルをインストールすると、マーケットプレイスからダウンロードされ、エージェントのスキルディレクトリ（例：~/.agents/skills/<skill-name>/）にローカル保存されます。スキルはエージェントのすべての権限を使ってローカルマシン上で実行されます。サードパーティ製ソフトウェアをインストールする場合と同様に、慎重に扱ってください。

スキルの振り分け

• スキルマーケットプレイス → okx-cex-skill-mp（このスキル）
• 市場データ／インジケーター → okx-cex-market
• アカウント残高／ポジション → okx-cex-portfolio
• 注文の発注／キャンセル → okx-cex-trade
• グリッド／DCA ボット → okx-cex-bot

前提条件

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

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

2. API 認証情報を設定します（マーケットプレイスへのアクセスに必要です）：

   okx config init
   

---

インストール方法

ユーザーがスキルのインストールを希望する場合は、必ず次の順序に従ってください。

1. 必ず最初に okx skill add <name> を試してください — スキルをダウンロードし、検出されたすべてのエージェント（Claude Code、OpenClaw、Cursor、Windsurf など）に一度でインストールします。
2. add が失敗した場合に限り、手動ダウンロードに切り替えてください。
   • add が失敗した理由（ネットワークエラー、npx が利用できない、権限の問題など）をユーザーに伝えます。
   • 代替手段として okx skill download <name> --dir <path> を提示します。
   • ファイルを手動で解凍し、エージェントのスキルディレクトリに配置するよう案内します。

add がすでに失敗している場合を除き、add を省略して直接 download を実行してはいけません。

---

コマンドリファレンス

#	コマンド	説明
1	okx skill search <keyword>	キーワードでマーケットプレイスを検索
2	okx skill search --categories <id>	カテゴリーでスキルを絞り込み
3	okx skill categories	利用可能なすべてのカテゴリーを一覧表示
4	okx skill add <name>	ダウンロードし、検出されたすべてのエージェントにインストール
5	okx skill download <name> [--dir <path>] [--format zip|skill]	パッケージをダウンロード（デフォルトの形式：zip）
6	okx skill list	ローカルにインストール済みのスキルを一覧表示
7	okx skill check <name>	新しいバージョンが利用可能か確認
8	okx skill remove <name>	スキルをアンインストール
9	okx skill verify <name>	インストール済みスキルの署名を必要に応じて再検証

任意のコマンドに --json を追加すると、生の JSON 出力を取得できます。--env を追加すると、出力を {"env", "profile", "data"} 形式でラップできます。

---

コマンドの詳細

1. スキルを検索

okx skill search grid

出力：

  NAME              VERSION   DESCRIPTION
  grid-premium      1.2.0     Enhanced grid trading with technical analysis
  grid-dca          1.0.0     Grid strategy combined with DCA

2 skills found (page 1/1). Use `okx skill add <name>` to install.

カテゴリーで絞り込んで検索：

okx skill search --categories trading-strategy

ページネーション（レスポンスには総ページ数を示す totalPage が含まれます）：

okx skill search grid --page 2 --limit 5
# Output: "3 skills found (page 2/4). Use `okx skill add <name>` to install."

2. カテゴリーを閲覧

okx skill categories

出力：

  ID                  NAME
  trading-strategy    Trading Strategy
  risk-management     Risk Management
  analysis            Market Analysis

3. スキルをインストール

okx skill add grid-premium

出力：

Downloading grid-premium...
Verifying signature...
  Signature verified (key: okx-skill-signing-key-2026, files: 3)
Installing to detected agents...
✓ Skill "grid-premium" v1.2.0 installed
  Note: This skill was created by a third-party developer, not by OKX. Review SKILL.md before use.

内部で行われる処理：

1. OKX マーケットプレイス API からスキルの zip をダウンロードします
2. パッケージを展開して検証します（SKILL.md の存在を確認し、メタデータを読み取ります）
3. Ed25519 署名と SHA-256 ファイル整合性を検証します — 検証に失敗した場合はインストールをブロックします
4. npx skills add を実行し、ローカルで検出されたすべてのエージェントにインストールします
5. インストール情報（検証ステータスを含む）を ~/.okx/skills/registry.json に記録します

強制インストール（検証を回避）：

okx skill add grid-premium --force

⚠️ セキュリティ警告：--force は署名検証を回避し、検証に失敗した場合でもスキルをインストールします。ソースを信頼し、リスクを理解している場合にのみ使用してください。回避したことは、ステータス bypassed とともにレジストリに記録されます。

4. ダウンロードのみ（インストールなし）

add が失敗した場合、または生のパッケージが必要な場合：

okx skill download grid-premium --dir ~/Downloads/

出力：

✓ Downloaded grid-premium.zip
  Path: /Users/me/Downloads/grid-premium.zip

.skill 形式でダウンロードする場合（この拡張子を認識するエージェント向け）：

okx skill download grid-premium --dir ~/Downloads/ --format skill

zip には次のファイルが含まれています：

• SKILL.md — スキルのメインの指示ファイル
• _meta.json — メタデータ（名前、バージョン、タイトル、説明）
• reference/ — 任意の補足ドキュメント

5. インストール済みスキルの一覧表示

okx skill list

出力：

  NAME              VERSION   INSTALLED AT
  grid-premium      1.2.0     2026-03-25 10:30:00
  dca-smart         2.1.0     2026-03-20 14:00:00

2 skills installed.

6. 更新の確認

okx skill check grid-premium

出力：

grid-premium: installed v1.0.0 → latest v1.2.0 (update available)
  Use `okx skill add grid-premium` to update.

更新するには、okx skill add <name> を再度実行するだけです。以前のバージョンは上書きされます。

7. スキルの削除

okx skill remove grid-premium

出力：

✓ Skill "grid-premium" removed

8. スキルの署名を検証

再インストールせずに、インストール済みのスキルの署名を再検証します：

okx skill verify grid-premium

出力（成功）：

✓ grid-premium: signature verified (key: okx-skill-signing-key-2026, files: 3)

出力（失敗）：

✗ grid-premium: verification failed — Invalid signature

• 失敗時の終了コードは 1 です。
• 結果は ~/.okx/skills/registry.json に保存されます。
• 機械可読な出力には --json を使用します。

---

MCP ツール（代替手段）

CLI を利用できない場合（例：ターミナルにアクセスできない Claude Desktop）、同じマーケットプレイス機能を MCP ツールから利用できます：

MCP ツール	対応する CLI	説明
skills_search	okx skill search	キーワードまたはカテゴリーで検索します。レスポンスにはページネーション用の totalPage が含まれます。
skills_get_categories	okx skill categories	カテゴリーを一覧表示します
skills_download	okx skill download	パッケージをディレクトリにダウンロードします（デフォルト形式：.skill。zip の場合は format: "zip" を指定します）

注：MCP ツールがサポートするのは検索とダウンロードのみです。完全なインストールフロー（add）には CLI アクセスが必要です。

---

エラー処理

エラー	意味	対応
70002 SKILL_DELETED	スキルがマーケットプレイスから削除されています	別のスキルを選択してください
70003 NO_APPROVED_VERSION	承認済みのバージョンがありません	スキルは審査中です。後でもう一度お試しください
70030 VERSION_NOT_APPROVED	バージョンはまだダウンロードが承認されていません	審査を待つか、以前のバージョンを使用してください
50111/50112/50113	認証エラー	okx config init を実行して認証情報を設定してください
npx skills add の失敗	npx を利用できないか、ネットワークに問題があります	代わりに okx skill download を使用してから、手動でインストールしてください