Camella · SDK
SDK TypeScript (npm i camella)
Cliente oficial para /api/v1. Auth es solo una clave cam_live_… — Authorization: Bearer y el header apiKey. No es cookie del sitio, ni token de CLI, ni el harness MCP — salvo que pegues la misma clave ahí.
Instalar
Crear una cuenta es gratis. Crear una API key es gratis. Los planes de pago desbloquean límites más altos y cifras financieras.
La publicación en npm ocurre después de esta página. Hasta entonces, instala desde el monorepo o espera el release público.
npm i camellacreateCamella
El baseUrl por defecto es https://www.camella.app. El cliente envía Authorization: Bearer cam_live_… y apiKey: cam_live_… en cada llamada.
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 |
El SDK no comparte tipos TypeScript con MCP y nunca llama a MCP. 401 / 403 / 404 / 429 son errores tipados. Los campos bloqueados por plan no se desbloquean en el cliente.