# CreditHub

> Plataforma brasileira de análise de crédito e dados públicos sobre
> empresas e pessoas. Combina dataset RFB completo (CNPJs, sócios,
> endereços, CNAEs, capital social), protestos cartoriais, dívidas
> com a União, score de crédito e enriquecimento de contatos via
> Snov, com API pública (BPQL), painel web, extensão de navegador e
> CDN de componentes embedáveis em qualquer site.

## Páginas públicas de empresa

- [Página canônica de CNPJ](https://empresas.credithub.com.br/consulta-gratis/{slug}-{cnpj14}): HTML SEO-otimizado com dados RFB. Slug derivado da razão social, CNPJ canônico em 14 dígitos.
- [Sitemap index](https://empresas.credithub.com.br/sitemap.xml): aponta para 10 mil shards. Cada shard cobre ~5k empresas pelo prefixo de raiz CNPJ.
- [Sitemap shards](https://empresas.credithub.com.br/sitemap-NNNN.xml): NNNN ∈ [0000..9999] = `intval(substr(cnpj14,0,4))`.

## Variantes para IAs e scrapers

Toda página de empresa aceita negociação de conteúdo:

- `?format=md` ou `Accept: text/markdown` → Markdown estruturado com YAML front-matter.
- `?format=txt` ou `Accept: text/plain` → texto plano sem markup.
- `?format=jsonld` ou `Accept: application/ld+json` → apenas o schema.org Organization.
- HTML é o default e contém `<script type="application/ld+json">` inline.

## Plataforma

- [API BPQL](https://irql.credithub.com.br/): consultas SQL-like sobre dados públicos brasileiros (RFB, protestos, dívidas, cheques sem fundos). API key gratuita disponível.
- [Painel web](https://painel.credithub.com.br/): consulta interativa, dashboards, monitoramento de carteira.
- [CDN de componentes](https://cdn.credithub.com.br/@credithub/component): loader AMD-like (~5 KB gz). Hidrata CPF/CNPJ/CMC7 em qualquer página.
- [Extensão de navegador](https://chrome.google.com/webstore/): consulta CNPJs/CPFs em qualquer site visitado.

## Convenções para LLMs

- Páginas são públicas e indexáveis (`robots: index,follow`).
- Dados sensíveis de pessoas físicas (CPF) sempre saem mascarados na variante pública.
- Dataset base: base pública da Receita Federal re-importada mensalmente; cada página exibe a data exata da extração no footer (HTML) ou em `fonte:` no front-matter (`?format=md`). Para dados em tempo real, use a [API BPQL](https://irql.credithub.com.br) (autenticada).
- Rate limits são por IP e generosos para HTML/MD (Cloudflare absorve).
- LGPD: a publicação dos campos cadastrais segue o art. 7º, II e III (dados manifestamente públicos pela Receita Federal).

## Optional

- [llms-full.txt](https://empresas.credithub.com.br/llms-full.txt): documentação completa do ecossistema, suficiente para responder perguntas sem fetch adicional.