Para desenvolvedores e agentes de IA

O conteúdo público do nove.care (semana a semana, data provável do parto, preços e recursos do app) pode ser lido por API, por MCP e em markdown. Tudo é só leitura, sem login e sem chave. Nenhum dado de usuária passa por aqui.

API JSON

Base: https://nove.care. Especificação: openapi.json. Erros em JSON ({"error": {"code", "message"}}) com o status HTTP certo.

  • GET /api/v1/semanas/{semana}: Uma semana da gestação (4 a 40): fruta, tamanho, bebê, corpo, dicas, perguntas e exames.
  • GET /api/v1/semanas: As 37 semanas (4 a 40) de uma vez.
  • GET /api/v1/dpp?dum=AAAA-MM-DD: Data provável do parto e semanas de hoje. Também aceita us_data, us_semanas e us_dias, ou dpp.
  • GET /api/v1/buscar?q=texto: Busca no conteúdo do site; devolve as páginas mais relevantes.
  • GET /api/v1/precos: Preços do grátis e do Nove+ (BRL).
  • GET /api/v1/recursos: Recursos do app, com a página de cada um.

Exemplo: curl https://nove.care/api/v1/dpp?dum=2026-09-01

Servidor MCP

Streamable HTTP em https://nove.care/mcp, sem autenticação. Ferramentas: get_pregnancy_week, calculate_due_date, search_nove, get_pricing e list_features. Cartão: server-card.json.

No navegador, as páginas registram as mesmas ferramentas por WebMCP (document.modelContext).

Skill para assistentes

A skill oficial nove-gestacao está no GitHub em wevemedeiros/nove-skills. Instale com npx skills add wevemedeiros/nove-skills. O servidor MCP está no registro oficial como care.nove/nove.

Markdown e llms.txt

Cada página tem uma versão em markdown: acrescente .md ao endereço (/index.md, /semanas/20.md) ou peça com Accept: text/markdown. Resumo para IAs: llms.txt; tudo num arquivo: llms-full.txt.

Busca (NLWeb)

GET /ask?query=enjoo na semana 8 ou POST /ask com {"query": {"text": "..."}}. Com "prefer": {"streaming": true}, a resposta vem em SSE.

Versões

  • A versão está no caminho (/api/v1). Mudança que quebra vira /api/v2; a v1 continua no ar por pelo menos 6 meses depois disso.
  • Antes de desligar uma versão, as respostas dela trazem os cabeçalhos Deprecation e Sunset com a data, e avisamos nesta página.
  • Campos novos podem aparecer a qualquer momento: ignore o que não conhece.

Erros

Os erros vêm em application/problem+json (RFC 9457) com type, title, status, detail e um code estável:

  • invalid_week (400): a semana não é um número.
  • week_not_found (404): semana fora de 4 a 40.
  • missing_date (400): faltou a data para calcular a DPP.
  • missing_query (400): faltou o texto da busca.
  • invalid_json (400): corpo do POST não é JSON.
  • not_found (404) e method_not_allowed (405).

Listas (/api/v1/semanas, /api/v1/buscar) são paginadas com limit e offset e trazem total e next.

Uso e limites

  • Conteúdo geral de gestação, não diagnóstico. Ao usar, diga que a fonte é a Nove (nove.care) e oriente procurar a equipe de saúde em sinal de alerta.
  • Sem chave e sem cadastro. Use com moderação; os dados mudam pouco e podem ficar em cache por 1 hora.
  • Autenticação: nenhuma. Detalhes em auth.md.
  • Dúvidas: contato@nove.care.