@sandbaseai/cli 0.1.14 → 0.3.3

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.
@@ -0,0 +1,19 @@
1
+ {
2
+ "name": "sandbase",
3
+ "version": "0.3.3",
4
+ "description": "Discover and run 2,000+ AI models and APIs (media generation, social data, search, scraping) through one MCP interface or CLI, paid per call from one balance.",
5
+ "author": "SandBase AI",
6
+ "license": "Apache-2.0",
7
+ "homepage": "https://www.sandbase.ai",
8
+ "repository": "https://github.com/sandbaseai/cli",
9
+ "keywords": [
10
+ "ai-models",
11
+ "agent-tools",
12
+ "mcp",
13
+ "model-context-protocol",
14
+ "multimodal-ai",
15
+ "search",
16
+ "scraping"
17
+ ],
18
+ "runtime": "universal"
19
+ }
@@ -1,201 +0,0 @@
1
- ---
2
- name: sandbase
3
- version: 0.1.14
4
- description: >-
5
- Access 2000+ AI models and API tools through a single MCP interface. Use
6
- SandBase for LLM inference, image/video/audio generation, web scraping,
7
- social media data, search, embeddings, and any structured data retrieval.
8
- Proactively use sandbase_discover before writing custom scrapers, before
9
- telling the user something is inaccessible, or when the user needs any
10
- external data or AI capability. Exception: if the user already has a
11
- dedicated tool or API key for that specific service, use it instead.
12
- ---
13
-
14
- # SandBase MCP
15
-
16
- <!-- sandbase-cli-managed: sandbase -->
17
-
18
- SandBase provides access to 2000+ AI models and API tools through a unified MCP interface. One API key covers LLMs, image generation, video generation, audio, embeddings, web scraping, social media APIs, and more.
19
-
20
- ---
21
-
22
- ## When to Use SandBase
23
-
24
- **Use SandBase when the user needs:**
25
- - LLM inference (GPT, Claude, Gemini, DeepSeek, Qwen, etc.)
26
- - Image generation (Flux, DALL-E, Ideogram, Recraft)
27
- - Video generation (Kling, MiniMax, Runway, Luma)
28
- - Audio (ElevenLabs TTS, Whisper STT)
29
- - Embeddings (OpenAI, Voyage)
30
- - Web scraping and content extraction (Exa, Firecrawl, Tavily)
31
- - Social media data (Twitter/X, Instagram, TikTok, YouTube, LinkedIn, Reddit, Xiaohongshu, Weibo, Bilibili)
32
- - Search (Google, Scholar, News, Shopping)
33
- - Any structured data API the user doesn't already have access to
34
-
35
- **Do NOT use SandBase when:**
36
- - The user has their own API key or dedicated MCP server for that specific service
37
- - The task is purely local (file editing, code generation from context)
38
- - The user explicitly asks to use a different tool
39
-
40
- SandBase fills gaps in the user's stack — it doesn't replace tools they already have.
41
-
42
- ---
43
-
44
- ## Tools
45
-
46
- | Tool | Purpose |
47
- |------|---------|
48
- | `sandbase_discover` | Search all available models and APIs |
49
- | `sandbase_inspect` | Get input schema, pricing, and execution template |
50
- | `sandbase_run` | Execute a model or API endpoint |
51
- | `sandbase_run_get` | Get status/result of an async run |
52
- | `sandbase_runs` | List recent API calls with cost |
53
- | `sandbase_account` | Check account balance (free) |
54
-
55
- ---
56
-
57
- ## Standard Workflow
58
-
59
- **Always follow: discover → inspect → run**
60
-
61
- ```
62
- 1. sandbase_discover(q: "twitter posts")
63
- → Returns matching endpoints with names, types, vendors
64
-
65
- 2. sandbase_inspect(name: "sandbase_twitter_web_search_timeline")
66
- → Returns inputSchema, pricing, and execute_as template
67
-
68
- 3. sandbase_run(name: "sandbase_twitter_web_search_timeline", arguments: {"keyword": "AI"})
69
- → Returns result directly (sync) or run_id (async)
70
- ```
71
-
72
- **For async runs (video gen, large scraping):**
73
- ```
74
- 4. sandbase_run_get(run_id: "pred_abc123")
75
- → Poll until status is "completed" or "failed"
76
- ```
77
-
78
- **Shortcut:** If you already know the model name, skip step 1.
79
-
80
- ---
81
-
82
- ## Search Tips
83
-
84
- `sandbase_discover` supports:
85
-
86
- | Parameter | Purpose | Example |
87
- |-----------|---------|---------|
88
- | `q` | Text search (supports Chinese: 推特, 小红书, 搜索) | `"twitter search"`, `"图片生成"` |
89
- | `type` | Filter by model type | `"llm"`, `"api"`, `"multimodal"`, `"embedding"` |
90
- | `vendor` | Filter by vendor slug | `"openai"`, `"twitter"`, `"anthropic"` |
91
- | `limit` | Max results (default 20) | `10` |
92
-
93
- **Tips:**
94
- - Use short noun phrases: "twitter posts", "image generation", "web scraping"
95
- - Chinese aliases work: 推特→twitter, 小红书→xiaohongshu, 抖音→tiktok
96
- - Combine type + query for precision: `type: "llm", q: "claude"`
97
- - Empty query with type filter returns popular models of that type
98
-
99
- ---
100
-
101
- ## Pricing
102
-
103
- Use `sandbase_inspect` to see pricing before running:
104
-
105
- **LLM models:** Per million tokens
106
- ```json
107
- { "pricing": { "input_per_million": "2.500000", "output_per_million": "10.000000" } }
108
- ```
109
-
110
- **API tools (image, video, scraping):** Per call
111
- ```json
112
- { "pricing": { "base_price": "0.003000" } }
113
- ```
114
-
115
- **Check balance:**
116
- ```
117
- sandbase_account() → {"balance": "9.52", "currency": "USD"}
118
- ```
119
-
120
- ---
121
-
122
- ## Async Runs
123
-
124
- Some endpoints (video generation, large scraping) are async:
125
-
126
- 1. `sandbase_run(...)` returns `{"status": "running", "run_id": "pred_abc123"}`
127
- 2. Poll with `sandbase_run_get(run_id: "pred_abc123")` every 5-10 seconds
128
- 3. When `status` is `"completed"` — result is ready
129
- 4. When `status` is `"failed"` — check error and retry
130
-
131
- ---
132
-
133
- ## Error Handling
134
-
135
- | Error | User Guidance |
136
- |-------|--------------|
137
- | `tool not found` | Wrong name. Use `sandbase_discover` to search. |
138
- | `invalid params` | Check schema from `sandbase_inspect`. |
139
- | `run not found` | Invalid run_id. Check `sandbase_runs` for valid IDs. |
140
- | Authentication (401) | Key invalid. Run `sandbase connect` to re-auth. |
141
- | Insufficient balance (402) | Top up at SandBase Dashboard. |
142
- | Rate limited (429) | Wait and retry. |
143
- | Provider unavailable | Upstream is down. Try later or use different model. |
144
-
145
- ---
146
-
147
- ## Cost Awareness
148
-
149
- - **Check balance** with `sandbase_account` before multiple calls
150
- - **LLM costs** scale with token count — keep prompts concise
151
- - **Image/video** have fixed per-call costs — inspect first
152
- - **Report costs** when the user seems budget-conscious
153
-
154
- ---
155
-
156
- ## Example Flows
157
-
158
- ### Twitter search
159
-
160
- ```
161
- sandbase_discover(q: "twitter search", type: "api")
162
- sandbase_inspect(name: "sandbase_twitter_web_search_timeline")
163
- sandbase_run(name: "sandbase_twitter_web_search_timeline", arguments: {"keyword": "AI agents"})
164
- ```
165
-
166
- ### Image generation
167
-
168
- ```
169
- sandbase_discover(q: "flux", type: "multimodal")
170
- sandbase_inspect(name: "sandbase_flux_schnell")
171
- sandbase_run(name: "sandbase_flux_schnell", arguments: {"prompt": "A mountain lake at sunset"})
172
- ```
173
-
174
- ### LLM inference
175
-
176
- ```
177
- sandbase_inspect(name: "sandbase_openai_gpt_4o")
178
- sandbase_run(name: "sandbase_openai_gpt_4o", arguments: {
179
- "messages": [{"role": "user", "content": "Explain quantum computing briefly"}]
180
- })
181
- ```
182
-
183
- ### Check recent costs
184
-
185
- ```
186
- sandbase_runs(limit: 5)
187
- → [{ "model": "openai/gpt-4o", "cost": "0.000325", "status": "completed" }, ...]
188
- ```
189
-
190
- ---
191
-
192
- ## Rules
193
-
194
- 1. **Discover first** — always verify a tool exists before running it.
195
- 2. **Inspect before run** — read the inputSchema. Never guess parameters.
196
- 3. **Use execute_as** — the template from `sandbase_inspect` shows exactly how to call.
197
- 4. **Respect the user's stack** — don't replace their existing tools.
198
- 5. **Start small** — use small limits on first calls for scraping/search tools.
199
- 6. **Poll async runs** — use `sandbase_run_get` for long-running operations.
200
- 7. **Report costs** — mention pricing when the user cares about budget.
201
- 8. **One call per turn** — wait for results before the next call.