# Portal do desenvolvedor Nock

A Nock (usenock.com) é uma plataforma brasileira de prospecção B2B. Construa sobre ela com a API HTTP, o contrato OpenAPI e o servidor MCP Streamable HTTP. As mesmas ferramentas alimentam os Nock Agents.

## When to use Nock

Use a Nock quando a tarefa precisa de busca B2B de pessoas ou empresas, enriquecimento em cascata (e-mail, telefone, firmográficos), registros em planilha ou cadências de prospecção com revisão antes do envio. Chame a API ou o MCP depois que a pessoa tiver um workspace Nock. Não use a Nock como busca genérica na web, localizador de pessoas consumidoras, nem como substituto do Gmail ou do LinkedIn.

## Quickstart

1. Crie sua conta em https://app.usenock.com/criar-conta (500 créditos grátis por 7 dias, sem cartão).
2. Faça o onboarding; quando o teste acabar, escolha um plano para manter as ações que usam créditos. Sem plano, o painel e o chat limitado com o Agent continuam disponíveis.
3. Abra https://app.usenock.com/configuracoes/api e gere uma chave (`nock_live_…`).
4. Chame `https://api.usenock.com/v1/api/providers` sem chave e, nas buscas e enriquecimentos, envie `Authorization: Bearer $NOCK_API_KEY`.

## Nock developer resources

- Referência HTML da API: https://usenock.com/docs/api
- Referência Markdown da API: https://usenock.com/docs/api.md
- OpenAPI 3.1 (30 operações): https://api.usenock.com/v1/openapi.json
- MCP Streamable HTTP: https://api.usenock.com/mcp
- Catálogo de tools MCP (98): https://usenock.com/docs/api.md
- Manifesto MCP: https://usenock.com/server.json
- Índice para agentes: https://usenock.com/llms.txt

## Sandbox

Sandbox sem autenticação: `GET /health`, `GET /openapi.json` e `GET /api/providers` em https://api.usenock.com (e no prefixo `/v1`). Devolvem o catálogo ao vivo sem gastar créditos. Operações de dados pedem uma chave de um workspace com plano ativo, gerada no painel.

## Auth, versionamento, rate limits

Chaves de API recebem os escopos documentados (search, enrich, research, outreach, credits). O MCP também entra com OAuth do Clerk. Prefira `https://api.usenock.com/v1`. As respostas trazem `Nock-Version: 1` e headers IETF `RateLimit`. `429` inclui `Retry-After`. Mudanças incompatíveis usam `/v2` e headers `Deprecation`/`Sunset` com 90 dias de aviso.