Camella · SDK
SDK TypeScript (npm i camella)
Cliente oficial para /api/v1. Auth é só uma chave cam_live_… — Authorization: Bearer e o header apiKey. Não é cookie do site, nem token de CLI, nem o harness MCP — a menos que você cole a mesma chave lá.
Instalar
Criar uma conta é grátis. Criar uma chave API é grátis. Planos pagos desbloqueiam limites maiores e demonstrações financeiras.
A publicação no npm ocorre depois desta página. Até lá, instale pelo monorepo ou aguarde o release público.
npm i camellacreateCamella
O baseUrl padrão é https://www.camella.app. O cliente envia Authorization: Bearer cam_live_… e apiKey: cam_live_… em cada chamada.
import { createCamella } from 'camella'
const camella = createCamella({
apiKey: process.env.CAMELLA_API_KEY, // cam_live_…
// baseUrl: 'https://www.camella.app',
})
const hits = await camella.search('Banco Pichincha', { country: 'EC', limit: 8 })
const entity = await camella.get('EC', '1790016919001')
const financials = await camella.financials('EC', '1790016919001')
const coverage = await camella.coverage()
const checkout = await camella.checkout({ planId: 'ENTERPRISE' })Métodos
| SDK | HTTP |
|---|---|
search(q, { country?, limit? }) | GET /api/v1/search |
get(country, id) | GET /api/v1/entities/{cc}/{id} |
financials(country, id) | GET /api/v1/entities/{cc}/{id}/financials |
coverage() | GET /api/public/empresas/stats |
checkout({ planId }) | POST /api/subscriptions/checkout |
O SDK não compartilha tipos TypeScript com o MCP e nunca chama o MCP. 401 / 403 / 404 / 429 são erros tipados. Campos bloqueados pelo plano não são desbloqueados no cliente.