@sandbaseai/cli 0.1.14 → 0.3.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.ja.md ADDED
@@ -0,0 +1,209 @@
1
+ <p align="center">
2
+ <h1 align="center">@sandbaseai/cli</h1>
3
+ <p align="center">
4
+ <strong>AIエージェントに超能力を。1コマンドで2,000以上のAIモデルとAPI。</strong>
5
+ </p>
6
+ <p align="center">
7
+ <a href="./README.md">English</a> | <a href="./README.zh-CN.md">中文</a> | 日本語 | <a href="./README.ko.md">한국어</a> | <a href="./README.es.md">Español</a> | <a href="./README.fr.md">Français</a> | <a href="./README.de.md">Deutsch</a> | <a href="./README.pt-BR.md">Português</a>
8
+ </p>
9
+ <p align="center">
10
+ <a href="https://github.com/sandbaseai/cli/releases/latest"><img alt="GitHub Release" src="https://img.shields.io/github/v/release/sandbaseai/cli"></a>
11
+ <a href="https://github.com/sandbaseai/cli/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/sandbaseai/cli/actions/workflows/ci.yml/badge.svg"></a>
12
+ <a href="https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.sandbaseai%2Fcli"><img alt="公式 MCP Registry" src="https://img.shields.io/badge/MCP%20Registry-listed-5a67d8"></a>
13
+ <a href="https://github.com/sandbaseai/cli/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/github/license/sandbaseai/cli"></a>
14
+ <a href="https://github.com/sandbaseai/cli/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/sandbaseai/cli?style=social"></a>
15
+ </p>
16
+ </p>
17
+
18
+ <p align="center">
19
+ <img src="https://raw.githubusercontent.com/sandbaseai/cli/main/.github/assets/sandbase-cli-hero.webp" alt="SandBase CLI MCP bridge" width="100%">
20
+ </p>
21
+
22
+ ---
23
+
24
+ あなたのAIコーディングアシスタントは優秀ですが、箱の中に閉じ込められています。Web検索もSNS確認も画像生成もリアルタイムデータ取得も — 自分で各APIを接続しない限りできません。
25
+
26
+ **SandBaseがそれを変えます。** 1コマンドで、[Model Context Protocol](https://modelcontextprotocol.io)を通じてエージェントを2,000以上のAIモデルとAPIに接続。APIキー管理不要。設定の手間なし。
27
+
28
+ ```sh
29
+ npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
30
+ ```
31
+
32
+ macOS または Linux では、公式 Homebrew Formula も利用できます:
33
+
34
+ ```sh
35
+ brew install sandbaseai/tap/sandbaseai-cli
36
+ sandbase connect
37
+ ```
38
+
39
+ これだけ。あなたのエージェントはすべてにアクセスできるようになりました。
40
+
41
+ ## SandBase オープンソーススタック
42
+
43
+ - **[SandBase Harness](https://github.com/sandbaseai/sandbase-harness)** — 永続セッション、サンドボックス分離、承認、監査、リプレイを備えたセルフホスト型エージェントランタイム。
44
+ - **[SandBase Agent Skills](https://github.com/sandbaseai/sandbase-skills)** — リサーチ、ソーシャルインテリジェンス、マーケティング、ビジネス向けのインストール可能な 88 Skills。
45
+
46
+ ---
47
+
48
+ ## 検証可能なエージェントワークフロー
49
+
50
+ 接続後、エージェントに次の監査可能な手順を実行させます。
51
+
52
+ 1. `sandbase_discover` でタスクに適したモデルや API を検索します。
53
+ 2. `sandbase_inspect` で入力スキーマ、現在の料金、実行要件を確認します。
54
+ 3. `sandbase_run` を呼び出す前に、エンドポイント、パラメータ、想定コストを確認します。
55
+ 4. 非同期タスクは、返された `run_id` を使って `sandbase_run_get` で追跡します。
56
+ 5. `sandbase_runs` で最近の実行状態と記録されたコストを確認します。
57
+ 6. `sandbase_account` で現在のアカウント残高を確認します。
58
+
59
+ たとえば、課金されない検索リクエストから始めます。
60
+
61
+ > 正方形の商品イラストに適した画像モデルを探し、上位 2 候補の必須入力と現在の料金を比較してください。まだモデルは実行しないでください。
62
+
63
+ カタログ、料金、レイテンシ、可用性は変わる可能性があります。固定された例ではなく、現在のセッションで得られたツール応答を使用してください。
64
+
65
+ ---
66
+
67
+ ## 含まれるツール
68
+
69
+ | カテゴリ | ツール | できること |
70
+ |---------|--------|-----------|
71
+ | **Web検索** | Google、Exa、Tavily、Scholar | リアルタイムで何でも検索 |
72
+ | **SNS** | Twitter/X、YouTube、Reddit、Instagram、TikTok | トレンド監視、投稿取得、分析 |
73
+ | **スクレイピング** | Firecrawl、Exa Content | 任意の公開ページからデータ抽出 |
74
+ | **AIモデル** | GPT-4o、Claude、Gemini、DeepSeek、Qwen | キー管理なしで任意モデルを実行 |
75
+ | **画像生成** | Flux、DALL-E、Ideogram、Recraft | ロゴ、イラスト、モックアップ |
76
+ | **動画生成** | Kling、MiniMax、Runway、Luma | ショートクリップ、アニメーション |
77
+ | **音声** | ElevenLabs、Whisper | テキスト→音声、音声→テキスト |
78
+ | **EC** | Taobao、Amazon | 商品調査、価格比較 |
79
+ | **金融** | 株式データ、企業情報 | 市場調査と分析 |
80
+
81
+ ---
82
+
83
+ ## 対応クライアント(25ターゲット)
84
+
85
+ すべての主要AIコーディングツールで動作:
86
+
87
+ | 自動設定 | 手動設定 |
88
+ |---------|---------|
89
+ | Cursor、Cursor CLI | ChatGPT |
90
+ | Claude Code | Claude Desktop |
91
+ | Codex | |
92
+ | Kiro IDE、Kiro CLI | |
93
+ | Windsurf | |
94
+ | Gemini CLI | |
95
+ | Amp | |
96
+ | Warp | |
97
+ | OpenCode、Qwen Code、Kimi CLI | |
98
+ | Hermes、OpenClaw | |
99
+
100
+ サインインやファイル変更なしで、完全な互換性カタログを確認できます:
101
+
102
+ ```sh
103
+ npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz catalog --json
104
+ ```
105
+
106
+ このコマンドは変更されない GitHub `v0.1.17` リリースアーカイブを使用します。SHA-256:
107
+ `1ad535b2899ca460b57b3c268aef278fee28fd28e649a89b92951514fd71fffa`
108
+
109
+ npm の `latest` は現在も v0.1.14 のため、Trusted Publishing が有効になるまでは上記のバージョン固定 GitHub URL を使用してください。
110
+
111
+ ```sh
112
+ # 検出されたすべてのクライアントを一度に接続
113
+ npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
114
+
115
+ # 特定のクライアントを指定
116
+ npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client cursor
117
+ ```
118
+
119
+ ---
120
+
121
+ ## 仕組み
122
+
123
+ ```
124
+ ┌─────────────────┐ ┌───────────────┐ ┌────────────────────┐
125
+ │ あなたのAgent │ MCP │ ローカルBridge │ HTTPS │ SandBase API │
126
+ │ (Cursorなど) │────────▶│ (オンデマンド) │────────▶│ 2,000+ モデル/API │
127
+ │ │◀────────│ │◀────────│ │
128
+ └─────────────────┘ └───────────────┘ └────────────────────┘
129
+ ```
130
+
131
+ 1. `connect`実行 → ブラウザ認証 → 承認
132
+ 2. APIキーをローカル保存(権限 `0600`)
133
+ 3. クライアントにMCP設定を自動書き込み
134
+ 4. エージェントがオンデマンドでツール呼び出し。デーモンなし。
135
+
136
+ ---
137
+
138
+ ## コマンド
139
+
140
+ ### CLIコマンド
141
+
142
+ ```sh
143
+ sandbase connect [--client <name>] # 認証 + 設定
144
+ sandbase doctor [--client <name>] # ヘルスチェック
145
+ sandbase unregister [--client <name>] # 設定削除
146
+ sandbase catalog --json # 対応クライアント一覧
147
+ ```
148
+
149
+ ### MCPツール(接続後にエージェントが使用可能)
150
+
151
+ | ツール | 用途 |
152
+ |--------|------|
153
+ | `sandbase_discover` | 2,000以上の利用可能なモデルとAPIを検索 |
154
+ | `sandbase_inspect` | 入力スキーマ、料金、実行テンプレートを取得 |
155
+ | `sandbase_run` | モデルまたはAPIエンドポイントを実行 |
156
+ | `sandbase_run_get` | 非同期タスクのステータス/結果をポーリング |
157
+ | `sandbase_runs` | 最近のAPI呼び出しとコストを一覧表示 |
158
+ | `sandbase_account` | アカウント残高を確認(無料) |
159
+
160
+ **エージェントが自動的に従うワークフロー:**
161
+
162
+ ```
163
+ discover → inspect → run
164
+ ```
165
+
166
+ ```
167
+ 1. sandbase_discover(q: "twitter search") → マッチするツールを検索
168
+ 2. sandbase_inspect(name: "twitter_timeline") → スキーマ + 料金を取得
169
+ 3. sandbase_run(name: "twitter_timeline", ...) → 実行してデータを返す
170
+ ```
171
+
172
+ ---
173
+
174
+ ## セキュリティ
175
+
176
+ - **URLやCLI引数にシークレットなし** — OAuth device flow + PKCE
177
+ - **制限されたファイル権限** — 認証情報は `0600` で保存
178
+ - **所有権を認識した更新** — 既存の JSONC コメントとユーザー管理の MCP エントリを保持
179
+ - **正確なロールバック** — 失敗時や `unregister` 実行時には、SandBase が作成した設定だけを削除
180
+ - **いつでも取り消し** — [SandBase Dashboard](https://sandbase.ai/console/keys)でワンクリック
181
+
182
+ ---
183
+
184
+ ## 始めよう
185
+
186
+ ```sh
187
+ npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
188
+ ```
189
+
190
+ そして、エージェントに今までできなかったことを頼んでみてください。
191
+
192
+ **[無料アカウント作成 →](https://sandbase.ai)**
193
+
194
+ SandBase でセットアップ時間を短縮できたら、[リポジトリに Star を付けてください](https://github.com/sandbaseai/cli)。より多くのエージェントユーザーがこのプロジェクトを見つけやすくなります。
195
+
196
+ ---
197
+
198
+ ## リンク
199
+
200
+ - [SandBase プラットフォーム](https://sandbase.ai)
201
+ - [ドキュメント](https://www.sandbase.ai/docs/)
202
+ - [Claude Code・Codex向け実践チュートリアル](https://github.com/sandbaseai/cli/discussions/49)
203
+ - [公式 MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers/io.github.sandbaseai%2Fcli/versions/0.1.17)
204
+ - [npm パッケージ](https://www.npmjs.com/package/@sandbaseai/cli)
205
+ - [ダッシュボード](https://sandbase.ai/console)
206
+
207
+ ## ライセンス
208
+
209
+ Apache-2.0
package/README.ko.md ADDED
@@ -0,0 +1,148 @@
1
+ <p align="center">
2
+ <h1 align="center">@sandbaseai/cli</h1>
3
+ <p align="center">
4
+ <strong>AI 에이전트에 초능력을. 한 줄 명령어로 2,000개 이상의 AI 모델과 API.</strong>
5
+ </p>
6
+ <p align="center">
7
+ <a href="./README.md">English</a> | <a href="./README.zh-CN.md">中文</a> | <a href="./README.ja.md">日本語</a> | 한국어 | <a href="./README.es.md">Español</a> | <a href="./README.fr.md">Français</a> | <a href="./README.de.md">Deutsch</a> | <a href="./README.pt-BR.md">Português</a>
8
+ </p>
9
+ <p align="center">
10
+ <a href="https://github.com/sandbaseai/cli/releases/latest"><img alt="GitHub 릴리스" src="https://img.shields.io/github/v/release/sandbaseai/cli"></a>
11
+ <a href="https://github.com/sandbaseai/cli/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/sandbaseai/cli/actions/workflows/ci.yml/badge.svg"></a>
12
+ <a href="https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.sandbaseai%2Fcli"><img alt="공식 MCP Registry" src="https://img.shields.io/badge/MCP%20Registry-listed-5a67d8"></a>
13
+ <a href="https://github.com/sandbaseai/cli/blob/main/LICENSE"><img alt="라이선스" src="https://img.shields.io/github/license/sandbaseai/cli"></a>
14
+ <a href="https://github.com/sandbaseai/cli/stargazers"><img alt="GitHub Stars" src="https://img.shields.io/github/stars/sandbaseai/cli?style=social"></a>
15
+ </p>
16
+ </p>
17
+
18
+ <p align="center">
19
+ <img src="https://raw.githubusercontent.com/sandbaseai/cli/main/.github/assets/sandbase-cli-hero.webp" alt="SandBase CLI MCP bridge" width="100%">
20
+ </p>
21
+
22
+ ---
23
+
24
+ AI 코딩 어시스턴트는 똑똑하지만 상자 안에 갇혀 있습니다. 웹 검색, SNS 확인, 이미지 생성, 실시간 데이터 접근 — 직접 각 API를 연결하지 않으면 불가능합니다.
25
+
26
+ **SandBase가 이를 바꿉니다.** 한 줄 명령어로 에이전트를 2,000개 이상의 AI 모델과 API에 [MCP](https://modelcontextprotocol.io)를 통해 연결합니다. API 키 관리 불필요. 설정 고민 없음.
27
+
28
+ ```sh
29
+ npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
30
+ ```
31
+
32
+ macOS 또는 Linux에서는 공식 Homebrew Formula로 설치할 수도 있습니다.
33
+
34
+ ```sh
35
+ brew install sandbaseai/tap/sandbaseai-cli
36
+ sandbase connect
37
+ ```
38
+
39
+ 이게 전부입니다. 에이전트가 이제 모든 것에 접근할 수 있습니다.
40
+
41
+ ## SandBase 오픈 소스 스택
42
+
43
+ - **[SandBase Harness](https://github.com/sandbaseai/sandbase-harness)** — 영구 세션, 샌드박스 격리, 승인, 감사 및 재생을 제공하는 셀프 호스팅 에이전트 런타임입니다.
44
+ - **[SandBase Agent Skills](https://github.com/sandbaseai/sandbase-skills)** — 리서치, 소셜 인텔리전스, 마케팅 및 비즈니스 워크플로를 위한 설치형 Skills 88개입니다.
45
+
46
+ ---
47
+
48
+ ## 검증 가능한 에이전트 워크플로
49
+
50
+ 연결 후 에이전트가 다음과 같이 확인 가능한 순서를 따르도록 요청하세요.
51
+
52
+ 1. `sandbase_discover`로 작업에 맞는 모델이나 API를 찾습니다.
53
+ 2. `sandbase_inspect`로 입력 스키마, 현재 가격, 실행 요구사항을 확인합니다.
54
+ 3. `sandbase_run`을 호출하기 전에 endpoint, 파라미터, 예상 비용을 확인합니다.
55
+ 4. 비동기 작업은 반환된 `run_id`로 `sandbase_run_get`을 조회합니다.
56
+ 5. `sandbase_runs`로 최근 실행 상태와 기록된 비용을 검토합니다.
57
+ 6. `sandbase_account`로 현재 계정 잔액을 확인합니다.
58
+
59
+ 예를 들어 과금되지 않는 검색 요청부터 시작하세요.
60
+
61
+ > 정사각형 제품 일러스트에 적합한 이미지 모델을 찾고, 상위 두 후보의 필수 입력과 현재 가격을 비교해 줘. 아직 모델을 실행하지 마.
62
+
63
+ 카탈로그, 가격, 지연 시간, 가용성은 바뀔 수 있습니다. 고정된 예시 값 대신 현재 세션의 도구 응답을 사용하세요.
64
+
65
+ ---
66
+
67
+ ## 지원 클라이언트 (25개 대상)
68
+
69
+ | 자동 설정 | 수동 설정 |
70
+ |----------|----------|
71
+ | Cursor, Claude Code, Codex | ChatGPT |
72
+ | Kiro IDE, Kiro CLI, Windsurf | Claude Desktop |
73
+ | Gemini CLI, Amp, Warp | |
74
+ | OpenCode, Qwen Code, Kimi CLI | |
75
+ | Hermes, OpenClaw | |
76
+
77
+ 로그인하거나 로컬 설정을 변경하지 않고 먼저 호환성만 확인하려면 읽기 전용 카탈로그 명령으로 현재 지원되는 25개 클라이언트를 확인하세요:
78
+
79
+ ```sh
80
+ npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz catalog --json
81
+ ```
82
+
83
+ 이 명령은 변경되지 않는 GitHub `v0.1.17` 릴리스 아카이브를 사용합니다. SHA-256:
84
+ `1ad535b2899ca460b57b3c268aef278fee28fd28e649a89b92951514fd71fffa`
85
+
86
+ npm의 `latest` 태그는 아직 v0.1.14이므로 Trusted Publishing이 활성화될 때까지 위의 버전 고정 GitHub URL을 사용하세요.
87
+
88
+ ```sh
89
+ # 감지된 모든 클라이언트 한번에 연결
90
+ npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
91
+
92
+ # 특정 클라이언트 지정
93
+ npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client cursor
94
+ ```
95
+
96
+ ---
97
+
98
+ ## 명령어
99
+
100
+ ### CLI 명령어
101
+
102
+ ```sh
103
+ sandbase connect [--client <name>] # 인증 + 설정
104
+ sandbase doctor [--client <name>] # 상태 확인
105
+ sandbase unregister [--client <name>] # 설정 제거
106
+ sandbase catalog --json # 지원 클라이언트 목록
107
+ ```
108
+
109
+ ### MCP 도구 (연결 후 에이전트가 사용)
110
+
111
+ | 도구 | 용도 |
112
+ |------|------|
113
+ | `sandbase_discover` | 2,000+ AI 모델 및 API 검색 |
114
+ | `sandbase_inspect` | 입력 스키마, 가격, 실행 템플릿 확인 |
115
+ | `sandbase_run` | 모델 또는 API 실행 |
116
+ | `sandbase_run_get` | 비동기 작업 상태/결과 조회 |
117
+ | `sandbase_runs` | 최근 API 호출 및 비용 확인 |
118
+ | `sandbase_account` | 계정 잔액 확인 (무료) |
119
+
120
+ ---
121
+
122
+ ## 보안
123
+
124
+ - **URL이나 CLI 인수에 시크릿 없음** — OAuth device flow + PKCE
125
+ - **제한된 파일 권한** — 인증 정보 `0600`으로 저장
126
+ - **자동 롤백** — 실패 시 모든 것이 깨끗하게 복원
127
+ - **언제든 취소** — [SandBase Dashboard](https://sandbase.ai/console/keys)에서 원클릭
128
+
129
+ ---
130
+
131
+ ## 시작하기
132
+
133
+ ```sh
134
+ npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
135
+ ```
136
+
137
+ **[무료 계정 만들기 →](https://sandbase.ai)**
138
+
139
+ SandBase로 설정 시간을 절약했다면 [프로젝트에 Star를 남겨 주세요](https://github.com/sandbaseai/cli). 더 많은 에이전트 사용자가 프로젝트를 발견하는 데 도움이 됩니다.
140
+
141
+ ## 실전 가이드
142
+
143
+ - [Claude Code·Codex: 모델/API 탐색, 가격 확인, 실행](https://github.com/sandbaseai/cli/discussions/51)
144
+ - [공식 MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers/io.github.sandbaseai%2Fcli/versions/0.1.17)
145
+
146
+ ## 라이선스
147
+
148
+ Apache-2.0