Communitygithub.com

oliveira7015/openclawby-skills

AIエージェントをライブ市場データ、オンチェーンデータ、ソーシャルデータ、そして取引実行に接続する統合APIです。

openclawby-skills とは?

このスキルは、Clawbyが提供する統合データAPIを通じて、AIエージェントがリアルタイムの金融データ、オンチェーンデータ、ソーシャルデータにアクセスし、さらに取引を実行できるようにします。Claude Code、Codex、OpenClawなど、シェルコマンドやHTTP APIを実行できるあらゆるAIエージェントと連携可能で、APIキーとカタログ参照、curlコマンドだけで動作します。このスキルの核心は「完全性を目指す」データ収集ワークフローにあります。まずは利用可能なすべてのデータを収集し(Clawbyデータ、取引所コネクタ、Webアクセスの3層)、その後で分析を行います。SEC提出書類、デリバティブ指標、暗号通貨のオンチェーンデータ、予測市場オッズ、ソーシャルセンチメントなど、多岐にわたるデータソースをカバーしています。また、`exec/` ディレクトリ以下のコネクタを使用して、Binance、Bitget、OKX、Polymarket、GMGNなどの取引所での実際の取引実行もサポートします。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add oliveira7015/openclawby-skills

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Clawby データ分析

Clawby 集約データ API を通じて リアルな金融データ を取得し、分析します。すべてのインターフェースの唯一の情報源(必須パラメータ・形式・例、および ⚠️ 注意点)は api/catalog/ です(api/catalog/_index.yaml から始めてください)。呼び出し前に対応するカテゴリの yaml を必ず読んでください。 完全なマシンカタログは api/clawby.yaml です(サーバー生成、バージョン管理済み)。

あらゆる AI エージェントと連携可能 — Claude Code、Codex、OpenClaw、Hermes、およびシェルコマンドや HTTP API を実行できるものすべて:必要なのは API キー + カタログ + プレーンな curl だけです。

クイックスタート

# 1. 認証(一度だけ):https://www.openclawby.com/ にサインイン → export CLAWBY_API_KEY=pk_xxx
# 2. api/catalog/<category>/ でインターフェースを見つけます(下のルーティングテーブル参照)
# 3. 呼び出し:
curl -s -X POST https://api.openclawby.com/api/relay \
  -H "X-API-Key: $CLAWBY_API_KEY" -H "Content-Type: application/json" \
  -d '{"name":"<カタログのインターフェース名>","params":{ ... }}'
# → {source, data, credits:{remaining,used_total}}

コアワークフロー · まず利用可能なすべてのデータを収集し、その後分析

完全性が目標です。 単一の情報源からの薄っぺらい回答は、たとえ正しくても失敗です。まず幅広く収集し、その後に分析します。これを すべての リクエストに適用します。

  1. リクエストをデータチェックリストに変換します。 「徹底的なアナリストなら何を取得するか?」を自問し、関連するすべての次元をリストアップします。意図的に過剰に収集します(株式→株価、空売りデータ、ダークプール、オプション、財務、センチメント、競合他社;トークン→DEX価格/流動性、保有者、資金調達と建玉、オッズ、ソーシャルバズ)。
  2. 各項目について、3つのソースレイヤーすべてをスイープします — 最初のヒットで止まらないでください:
    • レイヤー1 — Clawby データ(/api/relay + オンチェーン /api/rpc):その項目に触れる すべての インターフェースをカタログからスキャンし、すべて呼び出します。信頼性が高く、権威があります。
    • レイヤー2 — 実行コネクタ(exec/、読み取り専用で使用):Binance / Bitget / OKX / Polymarket CLI は、レイヤー1にはないマーケットデータ、オーダーブック、資金調達、スマートマネー情報、ニュースを公開しています。読み取り専用の場合は確認は不要です。
    • レイヤー3 — 自身のWebアクセス:ニュース、提出書類、公式文書、マクロコンテキスト — 残りのギャップをすべて埋めます。
  3. カバレッジを最大化します。 2つのレイヤーが同じ指標を提供する場合、両方を取得して相互検証します。独立した取得は並行して実行します。到達可能なソースを決してスキップしないでください。
  4. カバレッジを追跡し、その後分析します。 すべての主張を収集したデータに基づいて行います。ソースが失敗した場合は、その次元を黙って削除するのではなく、その旨を述べてください。
  5. 該当する場合、正式なレポートを提供します — 大規模な資産分析の場合は、プロフェッショナルなPDF調査レポートを提供します(プロフェッショナル分析レポート を参照)。まずユーザーに確認してください。

スキル構造

clawby-data/
├── SKILL.md            ← このファイル(管理対象 — 更新時にリフレッシュされます。更新後は再読込してください)
├── update-protocol.md  ← 初回実行 + 更新ルール(ステップ0で読んでください)
├── manifest.json       ← バージョン + 管理ファイルリスト
├── api/
│   ├── catalog/        ← カテゴリ別インターフェースドキュメント(パラメータ + 落とし穴) — 呼び出し前に読んでください
│   ├── clawby.yaml     ← 完全なマシンカタログ(すべてのインターフェース)
│   └── index.yaml      ← カタログレジストリ
├── exec/               ← 取引実行コネクタ;レジストリ exec/index.yaml
├── report/             ← PDFレポートガイド + スタイルシート
├── data/               ← その他の参考データ
└── local/              ← ローカル状態/キャッシュ;更新後も保持される唯一のフォルダ

ステップ0 · セッションでの初回使用

  1. ユーザーのプランと残高を確認します(無料呼び出し):curl -s https://api.openclawby.com/api/account -H "X-API-Key: $CLAWBY_API_KEY" → {plan, payg_balance, rate_per_min, accessible_providers, free_providers}。(アップグレード提案ルール:プランとアクセス を参照。)
  2. バージョンチェック(24時間に1回まで)、その後確認 — update-protocol.md に従います:manifest.json が24時間以上経過している場合、リモートバージョンと比較します;差異がある場合は ユーザーに更新を確認します。自動更新はしません。更新は local/ を除くすべてのファイルをリフレッシュします — この SKILL.md も含まれます(その後、再読込してください)。
  3. エグゼキュータCLIは遅延インストール — 事前に何もインストールしないでください。ユーザーが特定の取引所での取引を初めて要求した場合にのみ、そのコネクタを確認・インストールします(update-protocol.md ステップAを参照)。

認証

  • ベースURL:https://api.openclawby.com;X-API-Key ヘッダーでキーを送信します。
  • キーは CLAWBY_API_KEY 環境変数から読み取ります。設定されていない場合、ユーザーはキーを持っていません — https://www.openclawby.com/(無料)にサインインし、`export CLAWBY_API_KEY=pk_xxx` するように伝えてください。 キーを偽造しないでください。

シンボル形式

  • 株式:US:TICKER(GME → US:GME)· 暗号通貨:BASE:USD(BTC → BTC:USD)· 外国為替:BASE:USD(EUR:USD)

ルーティングテーブル — どのカタログファイルがどのニーズに応えるか

インターフェースの詳細(パラメータ + ⚠️ 落とし穴)はカタログファイルにあります — それを読んでから、/api/relay 経由で呼び出します:

ニーズインターフェースプレフィックスカタログ
米国株式:株価・ローソク・空売り出来高/残高・借入料金・決済失敗・ダークプール・オプションチェーン/最大ペイン・Reddit言及・スクリーナー・配当/株式分割(各種)api/catalog/equities/
暗号通貨デリバティブ(取引所横断):ファンディング・建玉・清算・ロング/ショート比率・テイカー出来高・ETFフロー・市場指標(恐怖と欲望、RSI…)・クジラ/取引所準備金funding_* open_interest_* liquidation_* etf_* …api/catalog/derivatives/
Hyperliquid パーペチュアル:ミッド・コンテクスト(ファンディング/OI/Mark)・オーダーブック・ローソク・ウォレットのポジション/約定hyperliquid_*api/catalog/perps/
予測市場 / 賭けオッズ(Polymarket)polymarket_*api/catalog/prediction-markets/
ソーシャル:X(Twitter)・Facebook・Instagram 検索とセンチメントx_search facebook_search instagram_search …api/catalog/social/
アドレスラベル(アドレスの所有者)・AMLリスクスコア・アドレスプロファイル/トレース/カウンターパーティaddress_*api/catalog/address-intel/
DEXペアとトークン市場データ、全チェーン(DexScreener)dexscreener_*api/catalog/dex/
オンチェーンDEX/ミームコインインテル:セキュリティ監査・保有者/トレーダーPnL・トレンド・スマートマネー/KOL・シグナル・新規ローンチ・スワップクォート(読み取り専用)dex_*api/catalog/dex-trading/
米国企業の財務・SEC提出書類sec_*api/catalog/filings/
ロングテールトークン / 生チェーン読み取り(80以上のチェーン)/api/rpc エンドポイントapi/catalog/rpc/

インターフェース間のミニフロー(詳細はカタログ内):

  • SEC:最初に sec_cik_lookup(ティッカー→10桁のCIK)→ 次に sec_company_concept(cik + us-gaap concept、例:Revenues、NetIncomeLoss、EarningsPerShareDiluted)を品目ごとに → 期間(fy/fp/form)でまとめます。提出書類/プロファイルは sec_submissions。
  • Polymarket:polymarket_events/polymarket_markets → clobTokenIds を読み取り → トークンIDごとに polymarket_price/midpoint/orderbook(0-1の価格=インプライド確率);履歴は polymarket_price_history 経由。
  • コントラクトアドレスによるトークン:最初に chain:"multichain" の集約メソッドを試します(ankr_getTokenPrice / ankr_getTokenHolders / ankr_getTokenTransfers、パラメータ {"blockchain":"eth","contractAddress":"0x…"});カバーされていない場合は、標準のERC-20セレクタを使用して生の eth_call を実行し、自分でデコードします。
  • ルーティングルール — クエリと実行の区別:すべての読み取り専用のDEX/ミームコイン参照は dex_* リレーインターフェースを経由します;実行(スワップ、TP/SL注文、ローンチ)するには exec/gmgn/ を使用します。同じ分割がすべての場所に適用されます:データはリレー経由、実行は exec/ 経由。

オンチェーンRPC(ロングテール / 小型トークン)

80以上のチェーン向けのネイティブJSON-RPC — 各チェーンのメソッドは api/catalog/rpc/ に文書化されています(EVMは rpc/evm/<chain>.yaml、solana/sui/near/btc/xrp/ton のような非EVMは rpc/non-evm/<chain>.yaml、利用可能リストは rpc/_index.yaml):

curl -s -X POST https://api.openclawby.com/api/rpc \
  -H "X-API-Key: $CLAWBY_API_KEY" -H "Content-Type: application/json" \
  -d '{"chain":"eth","method":"eth_call","params":[ ... ]}'

EVMチェーンは標準の eth_* を使用します;非EVMチェーンには独自の名前空間があります(sui → suix_*、solana → getTokenSupply …);chain:"multichain" = 集約されたankrトークンメソッド(EVMのみ)。チェーンがサポートされていないと決めつけないでください — 試してみてください;本当に利用できないものは明確なエラーを返します。

取引実行(exec/)

上記はすべて 読み取り専用データ です。取引を発注する には、exec/ の下にあるコネクタを使用します(レジストリ:exec/index.yaml;各取引所のガイド = 各 entry ファイル)。これらは ユーザー自身のキーを使用してローカルで実行されます — Clawby を経由することはありません:

取引所ガイドツール
Binance(現物/先物/証拠金/オプション/イールド)exec/binance/binance.mdbinance-cli
Bitget(現物/先物/コピートレード、--paper-trading)exec/bitget/bitget.mdbgc
OKX(現物/スワップ/先物/ボット、--demo)exec/okx/okx.mdokx
Polymarket(CLOB注文/CTF、自身のウォレットキー)exec/polymarket/polymarket.mdclob-client SDK
GMGN(オンチェーンスワップ/TP-SL/ローンチ、SOL/BSC/Base/ETH)exec/gmgn/gmgn.mdgmgn-cli

risk: high アクション(注文/転送/引き出し)のルール:注文内容を再提示します — 取引所・ペア・売買方向・数量・価格タイプ — 正確なコマンドを表示し、ユーザーに CONFIRM と入力させます。不明な場合はテストネットを優先します。読み取り専用のクエリには確認は不要です。

主な落とし穴(最も頻度が高いもの;完全なリストは各カタログファイルにあります)

  • ダークプール には date(実際の取引日 YYYY-MM-DD;空の結果 → 1日前に戻る)が必要です;レベルのインターフェースには decimals も必要です。
  • オプションチェーン は underlying + expiration を使用します(symbol ではありません)。
  • Reddit トップ言及 と OHLC バー は start をUnix秒で受け取ります — date -u -d '7 days ago' +%s(Linux)/ date -u -v-7d +%s(mac)。
  • 株価は30分遅延 しています;スクリーナーはリアルタイムです。
  • デリバティブ:集約/コインエンドポイントは symbol=BTC を受け取ります;単一取引所のものはペア BTC USDT スタイル(BTCUSDT)を受け取ります — カタログエントリを確認してください。
  • address_labels / address_risk は特別なコインIDを使用します(ETH、BNB、POL-Polygon、ETH-Base、TRX、SOL、SUI …)— api/catalog/address-intel/ を参照してください。

プランとアクセス(無料 / スタンダード / プロ + PAYG残高)

プラン:無料 / スタンダード / プロ(サブスクリプション)。PAYGはすべてのアカウントが持つ従量課金制の残高であり、プランではありません。 無料層のインターフェースは残高を消費しません。プレミアムインターフェースは有料プランが必要です(スタンダード = 主流、プロ = すべて)— または、無料のみ の場合、呼び出しごとにPAYGから課金されます。

アップグレード提案 — プランが制限されている場合のみ

ステップ0の /api/account の結果から判断します。次の場合のみ提案します:

  • 条件A — plan=="free" かつ payg_balance==0、または
  • 条件B — plan=="standard"(プロ限定のソースが不足している場合)。

それ以外の場合(プロ、または残高のある無料)はアップグレードについて何も言わないでください。 次の2つのタイミングのそれぞれで最大1回表示します — 分析中や呼び出しごとに繰り返さないでください:

  1. ステップ0のアカウント確認直後;
  2. 有料インターフェースが空/ 402 / 403 need_upgrade を返した場合(かつ条件AまたはBが成立する場合)。

短く誠実な1行;不足している 特定の プレミアム次元を挙げ、ユーザーの言語に合わせてください:

条件A(無料、残高0):

💡 無料プランでPAYG残高が0です — 無料データのみ利用可能です。 デリバティブのファンディング、ロング/ショート比率、スマートマネーフロー、アドレスリスク、Hyperliquidパーペチュアル、DEXインテルが見えず、フェイクアウトをブレイクアウトと誤認しやすくなっています。PAYGにチャージするか、プロにアップグレードしてください。 👉 https://www.openclawby.com/pricing

条件B(スタンダード):

💡 スタンダードプランです — 主流はカバーされていますが、プロはすべてのプレミアムソース(取引所横断デリバティブ/清算、アドレスリスク&AML、Hyperliquidパーペチュアル、DEXインテル…)を解放し、完全で相互検証された読み取りを可能にします。 👉 https://www.openclawby.com/pricing

プロフェッショナル分析レポート(PDF)

ユーザーが正式なレポート(調査レポート / デューデリジェンス / メモ)を希望する場合:まず提案し、その後 report/report-guide.md を最初から最後まで実行します — すべてのデータを収集し(レイヤー1〜3)、10の必須セクション、必須チャート(価格と水準、シナリオ目標、暗号通貨のアンロックスケジュール、メトリクストレンド、リスクマトリクス)、スタイル付きA4 HTML(report/report.css)→ ヘッドレスChromiumでPDF化(代替:weasyprint / wkhtmltopdf)。保存先を尋ねます;投資助言ではない という免責事項を含めます。

エラー

  • 401 キーが無効/欠落 → CLAWBY_API_KEY を設定するようにユーザーに伝えます。
  • 403 need_upgrade プラン以上のインターフェース → アップグレードを推奨し(プランとアクセス を参照)、アクセス可能なデータで続行します。
  • 402 無料プラン、PAYG枯渇 → https://www.openclawby.com/pricing でチャージ/アップグレードしてください。
  • 429 レート制限 → 速度を落とし、リトライします;上位プランはより高い制限があります。
  • 502 "Upstream HTTP 4xx" = パラメータが不正(必須の欠落、シンボル形式の誤り)→ インターフェースのカタログエントリに照らして修正してください。
  • 空の data = その日付/シンボルに該当するデータがない(ダークプール:より前の取引日を試してください)。

出力

  • data からの実際の数値のみを分析します;決して捏造しないでください。多次元の質問には、複数のインターフェースを取得して組み合わせます。
  • ソースを引用する必要がある場合は、「Clawby データ」と述べてください。自然で簡潔に記述します — ユーザー向けの文章に生のインターフェース名/リンクを含めないでください。
  • 短い注意書きで終わります:「投資助言ではありません。」

関連スキル