Como usar a API do Jurisprudências.ai no Claude Code

O Jurisprudências.ai disponibiliza uma API REST pública que permite buscar jurisprudência e decisões do STF, STJ, TST, TRT1, TRT2, TRT3, TRT4, TRT5, TRT6, TRT7, TRT8, TRT9, TRT10, TRT13, TRT14, TRT16, TRT17, TRT18, TRT19, TRT20, TRT22, TRT23, TRT24, TRF1, TRF2, TRF3, TRF4, TRF5, TRF6, TJAC, TJAP, TJBA, TJCE, TJDFT, TJES, TJGO, TJMA, TJMG, TJMS, TJMT, TJPA, TJPB, TJPE, TJPR, TJRJ, TJRN, TJRO, TJRR, TJRS, TJSC, TJSE, TJSP, TJTO e CARF de forma programática. Uma das formas mais práticas de usar essa API é diretamente pelo Claude Code — o CLI oficial da Anthropic — com suporte a linguagem natural e integração nativa.

Este artigo mostra como configurar o acesso, instalar a skill oficial e fazer buscas reais de jurisprudência sem sair do terminal.

Pré-requisitos

Você vai precisar de:

• Claude Code instalado e configurado
• Uma conta no Jurisprudências.ai
• Um token de API (gratuito para começar)

1. Gere seu token de API

Acesse jurisprudencias.ai/api-tokens e clique em Criar novo token. O token tem o formato jur_xxxxxxxxxxxx. Guarde-o em lugar seguro — ele não é exibido novamente após criação.

Configure a variável de ambiente no seu shell:

export JURISPRUDENCIAS_API_TOKEN="jur_seu_token_aqui"

Para persistir entre sessões, adicione a linha ao seu ~/.zshrc ou ~/.bashrc.

2. Instale a skill oficial

O Jurisprudências.ai oferece uma skill para o Claude Code que ensina o modelo a usar a API corretamente — incluindo operadores de busca, paginação e formatação de resultados.

Para instalar, execute no terminal:

curl -s https://jurisprudencias.ai/claude-skill.md > ~/.claude/skills/jurisprudencia.md

A partir daí, ao iniciar o Claude Code em qualquer projeto, você pode invocar a skill com:

/jurisprudencia buscar dano moral STJ 2024

O Claude vai construir a query correta, fazer a chamada à API e apresentar os resultados formatados.

3. Como a API funciona

A URL base é https://jurisprudencias.ai/api/v1. Todas as requisições precisam do token no header:

Authorization: Bearer jur_seu_token_aqui

Listar tribunais disponíveis:

curl -s -H "Authorization: Bearer $JURISPRUDENCIAS_API_TOKEN" \
  https://jurisprudencias.ai/api/v1/courts | jq .

Buscar decisões por texto:

curl -s -H "Authorization: Bearer $JURISPRUDENCIAS_API_TOKEN" \
  "https://jurisprudencias.ai/api/v1/courts/stj/decisions?q=dano+moral&page=0" | jq .

Consultar decisão específica pelo número do processo:

curl -s -H "Authorization: Bearer $JURISPRUDENCIAS_API_TOKEN" \
  "https://jurisprudencias.ai/api/v1/courts/stj/decisions/lookup?n=1234567" | jq .

4. Sintaxe de busca avançada

A busca textual suporta estes operadores:

• Frase exata: "dano moral"
• Todos os termos: dano moral (retorna documentos com ambos os termos)
• OR: dano OR moral
• Exclusão: dano -patrimonial

Exemplo com frase exata e filtro de data:

QUERY=$(printf %s '"dano moral"' | jq -sRr @uri)
curl -s -H "Authorization: Bearer $JURISPRUDENCIAS_API_TOKEN" \
  "https://jurisprudencias.ai/api/v1/courts/stj/decisions?q=$QUERY&pub_from=2024-01-01&pub_to=2024-12-31" \
  | jq '.data[] | {processo: .process_number, data: .publication_date, trecho: .excerpt}'

5. Usando no Claude Code em linguagem natural

Com a skill instalada, você pode pedir ao Claude em linguagem natural e ele faz a tradução para a query correta:

/jurisprudencia Preciso de jurisprudência do TJSP sobre rescisão de contrato de prestação de serviços por inadimplemento, preferência por acórdãos de 2023 em diante.

O Claude vai:

1. Identificar o tribunal correto (TJSP)
2. Construir a query de busca com os termos técnicos adequados
3. Chamar a API com os filtros de data
4. Apresentar os resultados com número do processo, data e trecho relevante
5. Oferecer buscar mais páginas se necessário

6. Exemplo completo de sessão

Abaixo um exemplo de interação real no Claude Code:

Você: /jurisprudencia buscar no STF responsabilidade civil do Estado por omissão

Claude: Vou buscar no STF decisões sobre responsabilidade civil do Estado por omissão.

[busca na API com q="responsabilidade+civil+estado+omiss%C3%A3o"]

Encontrei 847 resultados. Aqui estão os mais recentes:

1. ARE 1234567 — RE com Agravo
   Data: 15/08/2024 | Relator: Min. Alexandre de Moraes
   Trecho: "A responsabilidade civil do Estado por condutas omissivas..."

2. RE 987654 — Recurso Extraordinário
   Data: 03/06/2024 | Relator: Min. Luís Roberto Barroso
   Trecho: "Omissão estatal específica configurada quando..."

Deseja ver mais resultados ou o texto completo de alguma decisão?

Tribunais e bases disponíveis

ID	Tribunal
stf	Supremo Tribunal Federal
stj	Superior Tribunal de Justiça
tst	Tribunal Superior do Trabalho
trt2	Tribunal Regional do Trabalho da 2ª Região
trt24	Tribunal Regional do Trabalho da 24ª Região
trf2	Tribunal Regional Federal da 2ª Região
trf3	Tribunal Regional Federal da 3ª Região
trf4	Tribunal Regional Federal da 4ª Região
tjce	Tribunal de Justiça do Ceará
tjdft	Tribunal de Justiça do Distrito Federal e dos Territórios
tjes	Tribunal de Justiça do Estado do Espírito Santo
tjgo	Tribunal de Justiça de Goiás
tjma	Tribunal de Justiça do Maranhão
tjmg	Tribunal de Justiça de Minas Gerais
tjmt	Tribunal de Justiça de Mato Grosso
tjpa	Tribunal de Justiça do Estado do Pará
tjpe	Tribunal de Justiça de Pernambuco
tjpr	Tribunal de Justiça do Paraná
tjrj	Tribunal de Justiça do Rio de Janeiro
tjsp	Tribunal de Justiça de São Paulo
tjrs	Tribunal de Justiça do Rio Grande do Sul
tjsc	Tribunal de Justiça de Santa Catarina
carf	Conselho Administrativo de Recursos Fiscais

A cobertura do TRF2, do TJDFT, do TJES, do TJPA e do TJPE inclui acórdãos públicos, inclusive de Turmas Recursais, com foco inicial em 2026 e link para cada documento oficial. Registros anteriores podem aparecer, mas ainda não formam uma série histórica completa. No TJES, pesquise sem filtro de data para incluir documentos sem publicação ou julgamento informados; a data de juntada do PJe não substitui essas datas.

As coleções regionais adicionadas têm cobertura parcial, com acórdãos de 2026 e alguns registros anteriores quando disponíveis. A presença de um tribunal não indica cobertura completa. Pesquise em Todo período para incluir documentos sem publicação ou julgamento informados; assinatura, juntada e disponibilização não substituem essas datas.

Limites e planos

Os limites são diários e renovados no horário de Brasília. A API REST, o servidor MCP, agentes e integrações conectadas compartilham os mesmos limites da conta.

• Plano gratuito: 5 buscas textuais por dia e 10 consultas de decisão por dia
• Assinantes: 500 buscas textuais por dia e 10.000 consultas de decisão por dia no plano base
• Uso adicional: cada unidade recorrente adiciona 1.000 buscas textuais por dia e 10.000 consultas de decisão por dia, até 100 unidades

Os headers de resposta informam o status dos limites:

• X-RateLimit-Limit — total diário permitido
• X-RateLimit-Remaining — requisições restantes no dia
• X-RateLimit-Reset — timestamp de reset

Para uso intensivo em produção, automações ou produtos integrados, consulte os planos disponíveis em jurisprudencias.ai/billing.

---

Gere seu token em jurisprudencias.ai/api-tokens e comece a buscar jurisprudência diretamente do terminal.