Communitygithub.com

sandbase

통합 MCP 인터페이스를 통해 2,000개 이상의 AI 모델 및 API 도구(추론, 미디어 생성, 검색, 스크래핑, 임베딩, 소셜 데이터, 구조화된 검색 등)에 접근합니다. 사용자 맞춤 통합을 구축하거나 외부 데이터 접근 불가를 선언하기 전에 sandbase_discover를 먼저 사용하고, 사용자가 이미 전용 도구나 API 키를 가지고 있다면 기존 도구를 우선 사용하세요.

sandbase란 무엇인가요?

SandBase MCP는 2,000개 이상의 AI 모델과 API 도구를 하나의 통합 MCP 인터페이스로 제공하는 서비스입니다. LLM 추론(GPT, Claude, Gemini, DeepSeek, Qwen 등), 이미지 생성(Flux, DALL-E, Ideogram, Recraft), 비디오 생성(Kling, MiniMax, Runway, Luma), 오디오(ElevenLabs TTS, Whisper STT), 임베딩(OpenAI, Voyage), 웹 스크래핑(Exa, Firecrawl, Tavily), 소셜 미디어 데이터(Twitter/X, Instagram, TikTok, YouTube, LinkedIn, Reddit, Xiaohongshu, Weibo, Bilibili), 검색(Google, Scholar, News, Shopping) 등 다양한 기능을 한 계정으로 사용할 수 있습니다. Agent는 표준 워크플로(discover → inspect → run)를 따라야 하며, 사용자가 특정 서비스에 대한 자체 API 키나 전용 MCP 서버를 가지고 있다면 SandBase를 사용하지 않아야 합니다. 또한 sandbase_inspect로 가격 정보를 확인하고, 비동기 실행(sandbase_run_get)을 지원하며, sandbase_account로 잔액을 확인할 수 있어 비용을 관리할 수 있습니다.

지원 대상✓Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/sandbaseai/cli/tree/main/assets/skills/sandbase

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

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

문서

SandBase MCP

SandBase는 2,000개 이상의 AI 모델 및 API 도구를 통합 MCP 인터페이스로 제공합니다. 하나의 계정으로 LLM, 이미지 생성, 비디오 생성, 오디오, 임베딩, 웹 스크래핑, 소셜 미디어 API 등을 사용할 수 있습니다.


SandBase를 사용해야 하는 경우

다음과 같은 경우 SandBase를 사용하세요:

  • LLM 추론 (GPT, Claude, Gemini, DeepSeek, Qwen 등)
  • 이미지 생성 (Flux, DALL-E, Ideogram, Recraft)
  • 비디오 생성 (Kling, MiniMax, Runway, Luma)
  • 오디오 (ElevenLabs TTS, Whisper STT)
  • 임베딩 (OpenAI, Voyage)
  • 웹 스크래핑 및 콘텐츠 추출 (Exa, Firecrawl, Tavily)
  • 소셜 미디어 데이터 (Twitter/X, Instagram, TikTok, YouTube, LinkedIn, Reddit, Xiaohongshu, Weibo, Bilibili)
  • 검색 (Google, Scholar, News, Shopping)
  • 사용자가 아직 접근 권한이 없는 구조화된 데이터 API

다음과 같은 경우 SandBase를 사용하지 마세요:

  • 사용자가 특정 서비스에 대한 자체 API 키 또는 전용 MCP 서버를 가지고 있는 경우
  • 작업이 순수하게 로컬인 경우 (파일 편집, 컨텍스트에서 코드 생성)
  • 사용자가 다른 도구를 사용하도록 명시적으로 요청한 경우

SandBase는 사용자 스택의 빈틈을 채워줍니다 — 이미 가지고 있는 도구를 대체하지 않습니다.


도구 목록

도구목적
sandbase_discover2,000개 이상의 AI 모델 검색
sandbase_inspect입력 스키마, 가격 및 실행 템플릿 확인
sandbase_run모델 또는 API 엔드포인트 실행
sandbase_run_get비동기 실행 상태/결과 조회
sandbase_runs최근 API 호출 및 비용 조회
sandbase_account계정 잔액 확인 (무료)

표준 워크플로

항상 다음 순서를 따르세요: discover → inspect → run

1. sandbase_discover(q: "twitter posts")
   → 일치하는 엔드포인트와 이름, 유형, 공급업체 반환

2. sandbase_inspect(name: "sandbase_twitter_web_search_timeline")
   → inputSchema, 가격, execute_as 템플릿 반환

3. sandbase_run(name: "sandbase_twitter_web_search_timeline", arguments: {"keyword": "AI"})
   → 결과 직접 반환 (동기) 또는 run_id 반환 (비동기)

비동기 실행의 경우 (비디오 생성, 대규모 스크래핑):

4. sandbase_run_get(run_id: "pred_abc123")
   → 상태가 "completed" 또는 "failed"가 될 때까지 폴링

단축: 모델 이름을 이미 알고 있다면 1단계를 건너뜁니다.


검색 팁

sandbase_discover는 다음 매개변수를 지원합니다:

매개변수목적예시
q텍스트 검색 (중국어 지원: 推特, 小红书, 搜索)"twitter search", "图片生成"
type모델 유형별 필터"llm", "api", "multimodal", "embedding"
vendor공급업체 슬러그별 필터"openai", "twitter", "anthropic"
limit최대 결과 수 (기본 20)10

팁:

  • 짧은 명사구 사용: "twitter posts", "image generation", "web scraping"
  • 중국어 별칭 사용 가능: 推特→twitter, 小红书→xiaohongshu, 抖音→tiktok
  • 유형과 검색어를 결합하여 정밀도 향상: type: "llm", q: "claude"
  • 유형 필터와 함께 빈 검색어를 사용하면 해당 유형의 인기 모델 반환

가격

실행 전에 sandbase_inspect를 사용하여 가격을 확인하세요:

LLM 모델: 백만 토큰당

{ "pricing": { "input_per_million": "2.500000", "output_per_million": "10.000000" } }

API 도구 (이미지, 비디오, 스크래핑): 호출당

{ "pricing": { "base_price": "0.003000" } }

잔액 확인:

sandbase_account() → {"balance": "9.52", "currency": "USD"}

비동기 실행

일부 엔드포인트 (비디오 생성, 대규모 스크래핑)는 비동기입니다:

  1. sandbase_run(...)가 {"status": "running", "run_id": "pred_abc123"} 반환
  2. sandbase_run_get(run_id: "pred_abc123")로 5-10초마다 폴링
  3. status가 "completed"이면 — 결과 준비 완료
  4. status가 "failed"이면 — 오류 확인 후 재시도

오류 처리

오류사용자 안내
tool not found잘못된 이름. sandbase_discover로 검색하세요.
invalid paramssandbase_inspect에서 스키마를 확인하세요.
run not found잘못된 run_id. sandbase_runs에서 유효한 ID를 확인하세요.
인증 오류 (401)키가 잘못됨. sandbase connect를 실행하여 재인증하세요.
잔액 부족 (402)SandBase 대시보드에서 충전하세요.
속도 제한 (429)잠시 기다렸다가 재시도하세요.
공급자 사용 불가업스트림이 다운됨. 나중에 다시 시도하거나 다른 모델을 사용하세요.

비용 인식

  • 잔액 확인: 여러 번 호출하기 전에 sandbase_account로 잔액 확인
  • LLM 비용은 토큰 수에 비례 — 프롬프트를 간결하게 유지
  • 이미지/비디오는 호출당 고정 비용 — 먼저 inspect로 확인
  • 비용 보고 — 사용자가 예산에 민감해 보일 때 비용 알림

예시 흐름

Twitter 검색

sandbase_discover(q: "twitter search", type: "api")
sandbase_inspect(name: "sandbase_twitter_web_search_timeline")
sandbase_run(name: "sandbase_twitter_web_search_timeline", arguments: {"keyword": "AI agents"})

이미지 생성

sandbase_discover(q: "flux", type: "multimodal")
sandbase_inspect(name: "sandbase_flux_schnell")
sandbase_run(name: "sandbase_flux_schnell", arguments: {"prompt": "A mountain lake at sunset"})

LLM 추론

sandbase_inspect(name: "sandbase_openai_gpt_4o")
sandbase_run(name: "sandbase_openai_gpt_4o", arguments: {
  "messages": [{"role": "user", "content": "Explain quantum computing briefly"}]
})

최근 비용 확인

sandbase_runs(limit: 5)
→ [{ "model": "openai/gpt-4o", "cost": "0.000325", "status": "completed" }, ...]

규칙

  1. 먼저 검색 — 실행하기 전에 항상 도구가 존재하는지 확인하세요.
  2. 실행 전 검사 — inputSchema를 읽으세요. 매개변수를 추측하지 마세요.
  3. execute_as 사용 — sandbase_inspect의 템플릿이 호출 방법을 정확히 보여줍니다.
  4. 사용자 스택 존중 — 이미 있는 도구를 대체하지 마세요.
  5. 작게 시작 — 스크래핑/검색 도구의 첫 호출은 작은 제한값을 사용하세요.
  6. 비동기 실행 폴링 — 장기 실행 작업에는 sandbase_run_get을 사용하세요.
  7. 비용 보고 — 사용자가 예산을 신경 쓸 때 가격을 언급하세요.
  8. 턴당 한 번 호출 — 다음 호출 전에 결과를 기다리세요.

관련 스킬