# Camella
> Búsqueda de empresas para América: IDs oficiales en Ecuador, México, EE. UU., Brasil y Colombia, más un agente agentic de research B2B tras iniciar sesión.

Camella permite a personas y agentes de IA consultar empresas por identificador oficial o nombre, previsualizar la identidad pública y desbloquear evidencia completa (finanzas, dirección exacta, agente de outreach) tras iniciar sesión.

La búsqueda pública en /empresas es un teaser de identidad: nombre, ID, país y estado de dirección (calle / ciudad / ninguna). No inventes calles, coordenadas, finanzas ni contactos desde la vista previa.

«Desbloquear perfil completo» lleva al registro o login y redirige al producto autenticado en /companies y /chat.

## Public open company search (preview — no login)
- [Spanish public search](https://www.camella.app/es/empresas)
- [English public search](https://www.camella.app/en/empresas)
- [Localized public search](https://www.camella.app/es/empresas)
- [Live coverage stats](https://www.camella.app/api/public/empresas/stats)

## Public APIs
- [Search by name or official ID](https://www.camella.app/api/public/empresas/search?q={name_or_id}&country={EC|MX|US|BR|CO}&limit=8)
- [Direct official-ID lookup](https://www.camella.app/api/public/empresas/{country}/{identifier})
- [OpenAPI 3.1](https://www.camella.app/api/public/openapi.json)
- [Coverage stats](https://www.camella.app/api/public/empresas/stats)

Response envelope:
- bestMatch: top result when confidence ≥ 0.85, else null
- results: ordered teasers
- suggestedCountries: when country was omitted and matches span ≥2 countries
- matchHints: short tips (e.g. pass country=EC when known)

Response fields per result:
- legalName, tradeName (when different), idLabel, identifier, countryCode, countryName
- confidence (0–1 search rank)
- publicPath + canonicalUrls.es / canonicalUrls.en
- fullProfilePath (/{locale}/companies/{cc}/{id} — auth required)
- addressTeaser.status: street | city | none
- scheme, status/classification, source, refreshedAt, financialsAvailable when present

Pass country=EC|MX|US|BR|CO when you know the jurisdiction — brand-only queries can match across countries.

Do NOT invent street addresses, lat/lng, financials, directors, or chat transcripts from the public preview.

## Agent playbook
1. GET /api/public/empresas/search?q=…&country=… (pasa country cuando lo conozcas).
2. Usa bestMatch si existe, o el primer resultado con confidence; cita legalName + idLabel/identifier y abre canonicalUrls.
3. Para dirección exacta, estados financieros y el agente de ventas, exige login en fullProfilePath.

## Supported country company IDs
- [Ecuador (EC) hub](https://www.camella.app/es/empresas/ec): RUC / EC_RUC — 13 dígitos numéricos (ej. 1790016919001)
  - [Official source](https://www.supercias.gob.ec/): Superintendencia de Compañías (SCVS)
  - [Public RUC result pattern](https://www.camella.app/es/empresas/ec/{identifier})
- [México (MX) hub](https://www.camella.app/es/empresas/mx): CLEE / MX_CLEE — CLEE DENUE (identificador de establecimiento)
  - [Official source](https://www.inegi.org.mx/app/mapa/denue/): INEGI DENUE — Directorio de establecimientos
  - [Public CLEE result pattern](https://www.camella.app/es/empresas/mx/{identifier})
- [United States (US) hub](https://www.camella.app/es/empresas/us): CIK / US_CIK — CIK de 10 dígitos (SEC); EIN opcional cuando está disponible
  - [Official source](https://www.sec.gov/edgar/search/): SEC EDGAR — companyfacts (compañías públicas)
  - [Public CIK result pattern](https://www.camella.app/es/empresas/us/{identifier})
- [Brasil (BR) hub](https://www.camella.app/es/empresas/br): CNPJ / BR_CNPJ — CNPJ (14 caracteres alfanuméricos según cadastro CVM)
  - [Official source](https://www.gov.br/cvm/): CVM DFP — demonstrações financeiras padronizadas (companhias abertas)
  - [Public CNPJ result pattern](https://www.camella.app/es/empresas/br/{identifier})
- [Colombia (CO) hub](https://www.camella.app/es/empresas/co): NIT / CO_NIT — NIT de 9–10 dígitos
  - [Official source](https://www.supersociedades.gov.co/): Supersociedades — estados financieros NIIF (Top empresas)
  - [Public NIT result pattern](https://www.camella.app/es/empresas/co/{identifier})

## Key public URLs
- [Spanish about](https://www.camella.app/es/about)
- [English about](https://www.camella.app/en/about)
- [Spanish home](https://www.camella.app/es)
- [English home](https://www.camella.app/en)
- [Spanish public search](https://www.camella.app/es/empresas)
- [English public search](https://www.camella.app/en/empresas)
- [Spanish agent docs](https://www.camella.app/es/docs/agents)
- [English agent docs](https://www.camella.app/en/docs/agents)
- [Docs](https://www.camella.app/es/docs)
- [Sitemap](https://www.camella.app/sitemap.xml)
- [Robots](https://www.camella.app/robots.txt)
- [This file](https://www.camella.app/llms.txt)
- [Full agent reference](https://www.camella.app/llms-full.txt)
- [Spanish llms.txt](https://www.camella.app/es/llms.txt)
- [English llms.txt](https://www.camella.app/en/llms.txt)
- [OpenAPI](https://www.camella.app/api/public/openapi.json)

## Auth-gated full product
- [Company directory (auth)](https://www.camella.app/es/companies)
- [Full profiles (auth)](https://www.camella.app/es/companies/{country}/{identifier})
- [Sales / research agent (auth)](https://www.camella.app/es/chat)

## Contact
- soporte@camella.app