Communitygithub.com

oliveira7015/openclawby-skills

통합 API 하나로 AI 에이전트를 실시간 시장, 온체인, 소셜 데이터 및 거래 실행에 연결합니다.

openclawby-skills란 무엇인가요?

이 스킬은 Clawby 데이터 API를 통해 AI 에이전트가 실시간 금융 데이터(주식, 암호화폐 파생상품, 예측 시장, 온체인 정보 등)를 수집하고 분석할 수 있게 해줍니다. AI 에이전트(Claude Code, Codex 등)는 셸 명령어나 HTTP API 호출만으로 사용 가능하며, API 키와 카탈로그만 있으면 됩니다. 스킬은 데이터 수집의 완전성을 강조하여, 단일 출처에 의존하지 않고 Clawby 데이터, 거래소 CLI, 자체 웹 접근의 세 계층을 모두 활용하도록 안내합니다. 또한 PDF 형식의 전문 분석 보고서 생성 기능과 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. 각 항목에 대해 세 계층의 출처를 모두 훑으세요 — 첫 번째 적중에서 멈추지 마세요:
    • 계층 1 — Clawby 데이터(/api/relay + 온체인 /api/rpc): 카탈로그에서 항목과 관련된 모든 인터페이스를 스캔하고 모두 호출하세요. 기본적이고 권위 있는 출처입니다.
    • 계층 2 — 실행 커넥터(exec/, 읽기 전용 사용): Binance / Bitget / OKX / Polymarket CLI는 계층 1에 없을 수 있는 시장 데이터, 오더북, 펀딩, 스마트 머니 및 뉴스를 제공합니다. 읽기 전용이므로 확인이 필요 없습니다.
    • 계층 3 — 자체 웹 접근: 뉴스, 공시, 공식 문서, 거시경제 컨텍스트 — 나머지 모든 격차를 채우세요.
  3. 범위를 최대화하세요. 두 계층이 동일한 지표를 제공하면 둘 다 가져와 교차 검증하세요. 독립적인 가져오기를 병렬로 실행하세요. 도달 가능한 출처를 절대 건너뛰지 마세요.
  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를 통해 호출하세요:

요구사항인터페이스 접두사카탈로그
미국 주식: 호가 · 캔들 · 공매도 관심도/거래량 · 대차 수수료 · FTD · 다크 풀 · 옵션 체인/최대 손실 · Reddit 언급 · 스크리너 · 배당금/분할(다양함)api/catalog/equities/
암호화폐 파생상품 (교차 거래소): 펀딩 · 미결제약정 · 청산 · 롱/숏 비율 · 테이커 거래량 · ETF 흐름 · 시장 지표 (공포&탐욕, RSI…) · 고래/거래소 보유량funding_* open_interest_* liquidation_* etf_* …api/catalog/derivatives/
Hyperliquid 무기한: 중간가 · 컨텍스트 (펀딩/OI/시장가) · 오더북 · 캔들 · 지갑의 포지션/체결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/밈코인 인텔: 보안 감사 · 보유자/트레이더 손익 · 트렌딩 · 스마트머니/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 및 직접 디코딩.
  • 라우팅 규칙 — 조회 vs 실행: 모든 읽기 전용 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; 결과가 비어 있으면 하루 전으로 이동). 레벨 인터페이스에는 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" AND payg_balance==0, 또는
  • 조건 B — plan=="standard" (프로 전용 출처 누락).

그 외의 경우(Pro, 또는 잔고가 있는 Free) 업그레이드에 대해 아무 말도 하지 마세요. 다음 두 순간 각각에서 최대 한 번씩만 표시하세요 — 분석 중간에, 호출당 반복해서 절대 안 됨:

  1. 0단계 계정 확인 직후;
  2. 유료 인터페이스가 빈 결과 / 402 / 403 need_upgrade를 반환할 때(그리고 A 또는 B가 성립할 때).

한 줄로 간결하고 진솔하게; 놓치고 있는 구체적인 프리미엄 차원을 언급하세요. 사용자의 언어에 맞추세요:

조건 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 데이터"라고 말하세요. 자연스럽고 간결하게 작성하세요 — 사용자에게 보이는 문장에 원시 인터페이스 이름/링크를 넣지 마세요.
  • 짧은 메모로 마무리하세요: "투자 조언이 아닙니다."

관련 스킬