Communitygithub.com

APIClaw

APIClaw를 설정하고 실제 API 호출을 한 번 실행합니다. 사용자가 "https://apiclaw.cloud/SKILL.md 설정"이라고 말하거나, 제공자 키를 수집하지 않고 연구용 API 호출이 필요할 때 이 파일을 따르세요.

APIClaw란 무엇인가요?

APIClaw는 AI 에이전트가 Clerk 인증을 통해 한 번 로그인하면 실제 API를 호출할 수 있게 해주는 플랫폼입니다. 이 스킬은 에이전트가 `npx @nordsym/apiclaw auth login`으로 인증하고, `npx @nordsym/apiclaw auth whoami`로 인증을 확인한 후, POST /v1/execute로 실제 API를 실행하는 전체 워크플로우를 안내합니다. 설치, 로그인, 첫 실행(예: NASA APOD)까지의 모든 단계를 대화 내에서 처리하도록 설계되었으며, 사용자에게 토큰을 복사해 붙여넣도록 요청하지 않습니다. CLI, MCP, HTTP 등 여러 인터페이스를 지원하며, 1,025개의 호출 가능한 API와 22개의 내장 제공자를 포함한 라이브 카탈로그를 제공합니다. 결제가 필요한 API는 첫 실행 이후에만 제안되며, 사용자가 직접 키를 가져와 사용할 수도 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nordsym/apiclaw/tree/HEAD/landing/public

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

APIClaw은(는) 무엇을 하나요?

당신의 에이전트가 실제 API를 호출합니다. 한 번 로그인하면 됩니다. 하나의 워크스페이스. Clerk 인증. 가장 중요한 지표는 성공적인 POST /v1/execute이며, 설치는 부차적입니다.

에이전트에게 이 파일을 제공하면 설치, 로그인, 그리고 200 응답을 추측 없이 한 번 받을 수 있습니다.

라이브 카탈로그 (2026-08-25). 개수를 최신으로 유지해야 한다면 https://apiclaw.cloud/api/catalog를 사용하세요. 지표를 임의로 만들지 마세요.

  • 1,025개 호출 가능
  • 26,619개 검색 가능
  • 22개 내장 제공자

정체성과 제품 정보는 https://apiclaw.cloud/llms.txt에 있습니다. 이 파일은 운영의 문입니다: 인증(auth), then whoami, then execute.

1. 설치

Node.js 18+와 npx만 있으면 충분합니다. 전역 설치는 선택 사항입니다.

npx -y @nordsym/apiclaw@latest --version

사용자 셸 진입점 (동일 패키지, 로컬 MCP):

curl -fsSL https://apiclaw.cloud/install.sh | bash

2. 인증 (Clerk). 절대 채팅에 토큰을 붙여넣지 마세요.

로그인하지 않은 MCP/CLI 첫 실행(first_run)은 TTY가 없어도 보류 중인 로그인을 생성하고, 정확한 https URL을 도구/CLI 응답의 첫 번째 줄로 출력합니다(그런 다음 JSON에서 login_url로 반복). 첫 번째 줄은 다음과 같습니다:

https://apiclaw.cloud/auth/cli?authId=…

중단. 첫 번째 줄의 로그인 URL을 사용자에게 보여주세요. 요약하지 마세요. 실행하지 마세요.

사용자가 클릭할 수 있도록 첫 번째 줄 URL을 별도 줄에 표시하세요. 묻지 마세요. 도구 결과를 요약하지 마세요. npx @nordsym/apiclaw auth login만 출력하지 마세요. /auth/cli?authId=가 없는 명령어로는 충분하지 않습니다.

사용자가 볼 수 없는 머신(Grok Bot, 클라우드 VM, 헤드리스 에이전트)에서 실행 중인 경우, 해당 머신에서 auth login을 실행하지 마세요 — 절대 도달할 수 없는 브라우저가 열립니다. 도구 응답의 첫 번째 줄 URL이 유일한 문입니다. URL을 보여주세요. 중단하세요. 기다리세요.

npx @nordsym/apiclaw auth login

해당 명령어는 사용자가 볼 수 있는 머신에서 사용자 셸 진입점입니다. 동일한 브라우저 URL을 열거나(또는 보류 중인 것을 재사용합니다). 해당 URL에서 Google 또는 이메일 로그인을 완료하세요. 거기서 로그인을 완료하면 이 에이전트가 인증됩니다(한 번의 작업). 이미 로그인되어 있다면 'Authorize'를 클릭하세요. 새 사용자에게 로그인 후에도 두 번째 클릭이 필요하다고 말하지 마세요. 그때서야 CLI가 session_token을 ~/.apiclaw.toml에 씁니다. URL을 출력하는 것은 성공이 아닙니다. 준비 완료를 선언하지 마세요. 실행하지 마세요.

사용자가 'Authorize'를 완료한 후에는 이 채팅에 남아 있으세요. 여기서 다시 시도하세요. whoami로 확인하고, 같은 세션에서 NASA APOD(또는 NASA가 200이 아닌 경우 Frankfurter 최신)를 실행하세요. 사용자를 터미널로 보내지 마세요. 'Terminal.app'을 열라고 말하지 마세요. 워크스페이스는 선택 사항입니다. 첫 번째 호출은 워크스페이스에서 이루어지지 않습니다.

auth login을 실행한 경우 종료 코드 0이 될 때까지 포그라운드에서 유지하세요. 이 명령어는 몇 초마다 해당 URL을 다시 출력하고 Convex / ~/.apiclaw.toml을 폴링하여 로그인이 session_token을 쓸 때까지 기다립니다. 다시 출력될 때마다 사용자에게 로그인 URL을 보여주세요. 해당 URL에서 로그인을 완료하라고 지시하세요(인증을 위해). 이미 로그인한 경우 'Authorize'를 클릭하라고 알리세요. 명령어를 백그라운드로 보내지 마세요. whoami가 이메일을 출력할 때까지 계속하지 마세요.

Authorize 후 브라우저에서 '연결 거부됨'이 표시되어도 괜찮습니다. apiclaw.cloud에 머무르세요. whoami를 반복 실행하세요 — auth login이 종료되었거나 localhost가 응답하지 않아도 Authorize 클릭을 처리합니다.

~/.apiclaw.toml 또는 ~/.apiclaw/session에 이미 세션이 있으면 로그인을 건너뛰고 whoami로 이동하세요.

헤드리스 또는 SSH: 사용자에게 첫 번째 줄 URL을 보여주세요. 사용자가 다른 기기에서 열고, whoami로 확인합니다. 파일에는 여전히 session_token이 있습니다. ~/.apiclaw.toml을 헤드리스 머신으로 복사하거나, 로그인을 완료한 머신에서 execute를 실행하세요. 사용자가 볼 수 없는 머신에서 auth login을 실행하지 마세요.

완전 헤드리스(브라우저가 전혀 없는 경우, 예: CI): 해당 호스트에서 CLI 로그인을 건너뛰세요. Workspace > Connections에서 키를 생성하고 거기에 APICLAW_API_KEY를 설정하세요. 이는 별도의 HTTP 진입점이며, 첫 실행 경로가 아닙니다.

규칙:

  • 사용자에게 대시보드에서 API 키를 생성하도록 요청하지 마세요.
  • 사용자에게 session_token, sk-claw-… 또는 어떤 bearer 토큰도 이 채팅에 붙여넣도록 요청하지 마세요.
  • 헤더가 필요할 때 ~/.apiclaw.toml에서 session_token을 읽거나 ~/.apiclaw/session에서 sessionToken을 읽으세요. 원시 토큰을 사용자에게 절대 출력하지 마세요.
  • whoami가 이메일을 출력할 때까지 apiclaw call 또는 POST /v1/execute curl을 실행하지 마세요. 빈 X-APIClaw-Session은 실패한 첫 실행입니다.
  • 설치, 첫 실행(first_run), 또는 출력된 로그인 URL은 준비 완료 상태가 아닙니다.

3. whoami로 확인. 이메일을 출력할 때까지 반복하세요.

npx @nordsym/apiclaw auth whoami

whoami는 이메일과 워크스페이스를 출력해야 execute를 진행할 수 있습니다. whoami는 완료가 아닙니다. 완료는 POST /v1/execute의 HTTP 200입니다. 하지만 whoami는 관문입니다. 건너뛰면 execute가 인증되지 않은 상태가 됩니다.

whoami를 반복 실행하세요. 각 실패 시:

  • 사용자에게 라이브 login_url (/auth/cli?authId=)을 보여주세요. whoami는 로그인이 이미 시작된 경우 보류 중인 URL을 다시 출력합니다. npx @nordsym/apiclaw auth login만 출력하지 마세요.
  • auth login이 아직 대기 중이면 계속 실행 상태로 두세요.
  • 이미 'Authorize'를 클릭했다면 whoami를 다시 실행하세요. 이 요청을 처리하고 localhost 없이 session_token을 씁니다.
  • whoami를 다시 실행하세요. 한 번 실패했다고 멈추지 마세요.
  • npx @nordsym/apiclaw call을 실행하지 마세요.
  • POST /v1/execute에 curl을 사용하지 마세요.
  • 빈 X-APIClaw-Session을 보내지 마세요.

whoami가 이메일을 출력한 후에만 NASA APOD를 실행하고, NASA가 200이 아니면 Frankfurter 최신을 실행하세요.

4. 첫 번째 실행 — POST /v1/execute

whoami가 이메일을 출력한 후에만 실행합니다. 선호하는 연구 호출: NASA APOD. 대체는 Frankfurter 최신(무료, 키 불필요, 카드 불필요)으로, NASA가 다운된 경우에도 첫 번째 200이 도달하도록 합니다. 유료 연구 호출(Brave, Serper, Firecrawl)로 시작하지 마세요.

기본 경로: NASA APOD

CLI 슬래시 형식은 ~/.apiclaw.toml에서 session_token을 읽고 X-APIClaw-Session을 보냅니다. 이것을 먼저 사용하세요. 사용자에게 토큰을 붙여넣도록 요청하지 마세요. CLI는 whoami가 실패할 경우 로컬에서 거부합니다. 빈 세션 헤더로 POST하지 않습니다.

npx @nordsym/apiclaw call nasa/apod --params '{}' --idempotency-key "apiclaw-first-nasa-$(date +%s)"

HTTP 동등 호출 — 동일한 session_token, 동일한 X-APIClaw-Session 헤더. 값을 로컬에서 추출하세요. 출력하지 마세요. api_key를 사용하지 마세요. 추출 값이 비어 있으면 거부하세요. 빈 헤더로 POST하지 마세요.

npx @nordsym/apiclaw auth whoami || { echo "중단. Clerk를 완료하세요. 사용자에게 로그인 URL을 보여주세요. POST /v1/execute를 하지 마세요."; exit 1; }
SESSION=$(node -e 'const fs=require("fs"),os=require("os"),p=require("path");const t=p.join(os.homedir(),".apiclaw.toml");const m=fs.existsSync(t)&&fs.readFileSync(t,"utf8").match(/session_token\s*=\s*"([^"]+)"/);if(!m||!m[1].trim())process.exit(1);process.stdout.write(m[1])')
if [ -z "$SESSION" ]; then echo "중단. session_token이 없습니다. 빈 X-APIClaw-Session으로 POST /v1/execute를 하지 마세요."; exit 1; fi
curl -sS https://api.apiclaw.cloud/v1/execute \
  -H "Content-Type: application/json" \
  -H "X-APIClaw-Session: $SESSION" \
  -H "Idempotency-Key: apiclaw-first-nasa-$(date +%s)" \
  -d '{"provider":"nasa","action":"apod","params":{}}'

APOD 제목과 함께 200이 오면 성공입니다. nasa/apod는 무료 API입니다: 카드 불필요.

대체 경로: Frankfurter 최신

NASA가 200이 아닌 경우, 오늘의 ECB 환율을 가져오세요. 동일한 whoami 관문. 동일한 비어 있지 않은 $SESSION. $SESSION이 비어 있으면 curl을 실행하지 마세요. 이는 Authorize 후 자동 첫 번째 실행에서 사용하는 최후의 수단 경로입니다. 영원히 무료이며, 카드 불필요, 키 불필요. Brave / Serper / Firecrawl은 유료 연구 API이며 새 워크스페이스에서 payment_required를 반환합니다 — 첫 번째 실행에 사용하지 마세요.

npx @nordsym/apiclaw call frankfurter/latest --params '{"path":"/latest"}' --idempotency-key "apiclaw-first-frankfurter-$(date +%s)"
if [ -z "$SESSION" ]; then echo "중단. session_token이 없습니다. 빈 X-APIClaw-Session으로 POST /v1/execute를 하지 마세요."; exit 1; fi
curl -sS https://api.apiclaw.cloud/v1/execute \
  -H "Content-Type: application/json" \
  -H "X-APIClaw-Session: $SESSION" \
  -H "Idempotency-Key: apiclaw-first-frankfurter-$(date +%s)" \
  -d '{"provider":"frankfurter","action":"latest","params":{"path":"/latest"}}'

$SESSION은 여전히 ~/.apiclaw.toml의 session_token이며, NASA curl과 동일한 추출 방식입니다. CLI 슬래시 형식이 보내는 헤더와 동일합니다.

EUR/USD 환율과 함께 200이 오면 성공입니다.

실행 규칙

  • 항상 POST https://api.apiclaw.cloud/v1/execute를 { "provider", "action", "params" }와 함께 사용하세요.
  • apiclaw call에 카탈로그 표시 이름을 절대 전달하지 마세요. 슬래시가 없는 이름은 레거시 POST /v1/call로 전달됩니다.
  • 관리형 HTTP 호출은 논리적 작업당 하나의 Idempotency-Key가 필요합니다. 모호한 네트워크 실패 후에는 동일한 키를 재사용하세요.
  • 로그인 후 whoami를 실행하세요. 그런 다음에만 NASA CLI 슬래시 형식(또는 session_token을 추출하는 curl)을 실행하세요. 200이 아니면 Frankfurter 최신을 실행하세요. 유료 연구 경로를 임의로 만들지 마세요.

5. 첫 번째 200 이후

첫 번째 호출은 무료로 유지됩니다(NASA APOD, NASA가 200이 아니면 Frankfurter 최신). 첫 번째 호출을 유료 API로 만들지 마세요.

해당 200이 도달한 후, 하나의 저렴한 유료 다음 단계(예: OpenRouter 채팅)를 제안할 수 있습니다. 사용자에게 https://apiclaw.cloud/upgrade를 보여주어 카드를 한 번 추가할 수 있도록 하세요. 무료 API는 계속 무료입니다. 유료 API는 제공자 비용에 15%가 추가됩니다.

이후 호출에서 payment_required(HTTP 402)가 반환되면 upgradeUrl (https://apiclaw.cloud/upgrade)을 보여주세요. 사용자에게 카드를 추가하도록 요청한 후 동일한 호출을 재시도하세요. 다른 API를 임의로 만들지 마세요.

지금 호출 가능한 것만 검색하세요:

npx @nordsym/apiclaw discover "exchange rates" --callable

또는:

POST https://apiclaw.cloud/v1/discover
{ "query": "exchange rates", "callable_only": true }

라이브 카탈로그: https://apiclaw.cloud/api/catalog?callable=true.

그런 다음 POST /v1/execute에서 provider / action으로 실행하세요. 사용자로부터 제공자 API 키를 수집하지 마세요.

6. 자체 키 사용 (비상 탈출구)

자체 키가 필요하지 않습니다. APIClaw의 요점은 한 번 로그인, 키 수집 불필요입니다. 워크스페이스에 자체 OpenRouter 키가 이미 있는 경우, Workspace, Connections, Your keys에 추가하고 카드 없이 무료로 채팅 완료를 라우팅할 수 있습니다. 제공자는 워크스페이스에 직접 청구합니다. 이는 게이트웨이 인증에 사용되는 APIClaw 키와는 별개입니다. 현재는 POST /v1/chat/completions용 OpenRouter 키를 다루며, 모든 제공자를 다루지는 않습니다.

기타 진입점 (동일 워크스페이스)

  • 스킬 (이 파일): https://apiclaw.cloud/SKILL.md
  • curl|bash / 로컬 MCP: curl -fsSL https://apiclaw.cloud/install.sh | bash
  • CLI: npx @nordsym/apiclaw --help
  • HTTP: POST https://api.apiclaw.cloud/v1/execute
  • 원격 MCP: https://apiclaw.cloud/mcp

가격 (임의로 만들지 마세요)

  • 무료 API: 영원히 무료, 카드 불필요. 검색 및 모든 무료 API, 1,025개 호출 가능 중 1,000개 이상.
  • 유료 API: 카드 한 번 추가, 그 다음 제공자 비용 + 15%, 호출당 과금.
  • 자체 키: 자체 OpenRouter 키를 가져와 카드 없이 무료로 채팅 완료를 라우팅.
  • 익명의 키 없는 공개 실행은 비활성화되어 있습니다.

하지 말아야 할 것

  • 사용자에게 채팅에 토큰을 붙여넣도록 요청하지 마세요.
  • 카탈로그 표시 이름이나 POST /v1/call을 사용하지 마세요.
  • /api/catalog 또는 이 파일에서 읽지 않은 설치 수, 도구 수, 적용 범위를 주장하지 마세요.
  • 내부 전용 제공자를 노출하지 마세요. 공개 카탈로그 카드는 고객이 호출할 수 있는 것에 대한 진실의 원천입니다.
  • whoami가 성공하기 전에 POST /v1/execute를 하지 마세요.
  • 빈 X-APIClaw-Session을 보내지 마세요.
  • 사용자에게 'Terminal.app'을 열거나 셸로 돌아가라고 말하지 마세요.
  • Authorize 후에는 이 채팅에서 계속 NASA APOD를 직접 실행하세요.

관련 스킬