---
name: amparo-transparente
description: Consulta as contas públicas de Amparo-SP (gastos, receitas, contratos, licitações, fornecedores, doações de campanha) na API do Amparo Transparente. Use em perguntas sobre dinheiro público de Amparo.
---

# Skill: contas públicas de Amparo

Use esta skill quando a pessoa perguntar sobre o dinheiro público de Amparo,
São Paulo: gastos, pagamentos, fornecedores, contratos, licitações, receitas
ou restos a pagar da Prefeitura, da Câmara ou do SAAE, e doações de campanha
ligadas às empresas que recebem do município.

## Como chegar aos dados

Os dados vêm de uma API pública, gratuita e sem chave, que responde em JSON:

    https://amparo-transparencia.juniorter.in/api/consulta?...

Faça as chamadas com a ferramenta de acesso à internet que você tiver: leitura
de páginas (web fetch), navegador, ou código com acesso à rede (curl, Python).
Os parâmetros e as regras estão no manual abaixo.

Acrescente formato=texto a TODA consulta, inclusive às dos exemplos do
manual, que o omitem:

    https://amparo-transparencia.juniorter.in/api/consulta?conjunto=gastos&q=merenda&evento=Pago&formato=texto

A resposta é o mesmo JSON, entregue como texto puro. O navegador de algumas
IAs recusa abrir JSON e aceita texto, e sem o parâmetro a consulta falha
nessas ferramentas.

Se nenhuma ferramenta conseguir abrir o endereço, NÃO responda com números de
memória. Diga à pessoa que a IA precisa de acesso à internet para esta
consulta (no Claude, em Configurações > Capacidades), ou mostre o link da
consulta que você faria e peça que ela abra e cole o resultado aqui.

## Roteiro para perguntas complexas

1. Quebre a pergunta em consultas simples: um total, um ranking, uma série.
2. Antes de filtrar por elemento, função ou órgão, confira o nome exato com
   listar= (catálogos). Nome errado volta vazio.
3. Para "quanto gastou", use evento=Pago. Nunca some as três etapas.
4. Para rankings e evolução no tempo, use agrupar_por, que soma no banco
   inteiro. Não some registros de uma página.
5. Leia "metrica" e "avisos" de cada resposta antes de citar o número.
6. Responda em português, começando pela resposta, com valores no formato
   R$ 1.234.567,89, dizendo período, órgão e etapa da despesa. Use tabela para
   rankings e comparações. Termine com os links (campos url e
   pagina_equivalente) para a pessoa conferir no site.
7. Quando o acervo não bastar, complete com a BrasilAPI (seção abaixo), e
   diga na resposta o que veio de cada fonte.

## Aprofundar com a BrasilAPI

A BrasilAPI é outra API pública, gratuita e sem chave, com dados oficiais do
Brasil: https://brasilapi.com.br/api/...

Os termos dela pedem uso em escala humana. Consulte só os itens da pergunta,
como as cinco primeiras empresas de um ranking, e nunca percorra listas
inteiras nem repita chamadas em massa.

Alguns serviços dela saem do ar de vez em quando (CEP, NCM, FIPE e eleições
falharam em testes). Se um falhar, diga que não deu para confirmar aquele
ponto e responda com o que o acervo mostra.

### Os que mais ajudam nas contas de Amparo

- Empresa: GET /api/cnpj/v1/{cnpj}
  Razão social, atividade principal (cnae_fiscal_descricao) e secundárias,
  data de abertura (data_inicio_atividade), situação cadastral, porte,
  capital social, endereço e município, e o quadro de sócios (qsa: nome,
  qualificação e data de entrada). O CNPJ do fornecedor está no fim do campo
  id_fornecedor dos gastos ("CNPJ - PESSOA JURÍDICA - 00000000000000") e em
  cnpj_empresa das doações.
  Responde: a empresa é de Amparo? existe há quanto tempo? a atividade
  combina com o que ela vendeu? está ativa? quem são os sócios?
- Atividade econômica: GET /api/ibge/cnae/v1/classes/{classe}, com os cinco
  primeiros dígitos de cnae_fiscal. Também /divisoes/{divisao} e /grupos/{grupo}.
- Inflação e juros: GET /api/taxas/v1 e /api/taxas/v1/{sigla} (Selic, CDI,
  IPCA, valores atuais); GET /api/indices/igpm/v1/intervalo?initial_date=AAAA-MM-DD&final_date=AAAA-MM-DD
  e /api/indices/igpm/v1/ultimos?limit=12 (IGP-M, usado para reajustar
  contratos). Serve para comparar valores de anos diferentes; diga qual
  índice usou.
- Veículos (tabela FIPE): /api/fipe/marcas/v1/{tipo}, /api/fipe/veiculos/v1/{tipo}/{marca},
  /api/fipe/anos/v1/{tipo}/{marca}/{modelo}, /api/fipe/detalhes/v1/{tipo}/{marca}/{modelo}/{ano}
  e /api/fipe/preco/v1/{codigo_fipe}; tipo = carros | motos | caminhoes;
  /api/fipe/tabelas/v1 lista os meses de referência. Serve para comparar a
  compra de um veículo com o preço de mercado da época.
- Produtos e tributos: /api/ncm/v1?search=TERMO, /api/ncm/v1/{codigo};
  alíquotas em /api/ibpt/ncm/v1/{uf}/{codigo}, /api/ibpt/nbs/v1/{uf}/{codigo}
  e /api/ibpt/lc116/v1/{uf}/{codigo}.
- Livros: /api/isbn/v1/{isbn}, para compras de material didático.
- Datas: /api/feriados/v1/{ano} e
  /api/diasuteis/v1?dataInicial=AAAA-MM-DD&dataFinal=AAAA-MM-DD&incluirFeriadosNacionais=true,
  para prazos e para pagamentos em feriado ou fim de semana.
- Eleições (TSE): /api/eleicoes/ordinarias, /api/eleicoes/anos-eleitorais,
  /api/eleicoes/cargos-por-municipio?election=&municipality=,
  /api/eleicoes/candidaturas?election=&year=&municipality=&position= e
  /api/eleicoes/candidaturas/{candidato}?election=&year=&municipality=.
  Os parâmetros são códigos do TSE; pegue-os nas listas antes. Completa o
  cruzamento de doações com os dados da candidatura.
- Endereço e lugar: /api/cep/v2/{cep} (também v1 e v3), /api/ddd/v1/{ddd},
  /api/geolocation/v1?latitude=&longitude=, /api/ibge/municipios/v1/SP,
  /api/ibge/uf/v1/{uf}, /api/ibge/regioes/v1.
- Saúde: /api/hospitais/v1?municipio=&uf= (estabelecimentos habilitados para
  soro antiveneno, oncologia e doenças raras), /api/hospitais/v1/cnes/{cnes},
  /api/oms/cid10/v1/{codigo}, /api/tuss/v1/search?q=TERMO.
- Domínio de site: /api/registrobr/v1/{dominio}.
- Bancos e mercado: /api/banks/v1/{codigo}, /api/pix/v1/participants,
  /api/cambio/v1/cotacao/{moeda}/{AAAA-MM-DD}, /api/cvm/corretoras/v1,
  /api/cvm/fundos/v1/{cnpj}, /api/tickers/b3/acoes/v1.

### Os demais

Universidades (/api/universities/v1), previsão do tempo (/api/cptec/v1/...),
incidência solar (/api/solar/v1) e status da API (/api/status/v1) existem,
mas raramente ajudam a responder sobre contas públicas.

### O que não fazer

- Não use /api/cpf/v1 para tentar identificar pessoas. Ele só valida o número
  e diz a região fiscal, e o acervo não guarda CPF completo de ninguém.
- Não use os sócios de uma empresa como ponto de partida para investigar a
  vida pessoal deles. Cite o nome e a qualificação no quadro societário, e só.
- A BrasilAPI não é fonte oficial: ela repassa dados da Receita, do IBGE, do
  Banco Central e de outros. Cite como "BrasilAPI, com dados de ..." quando
  usar.

---

# Amparo Transparente

> Dados das contas públicas de Amparo, São Paulo, Brasil, reunidos de fontes
> oficiais e apresentados em linguagem simples. Projeto independente, sem
> vínculo com a Prefeitura ou com a Câmara. Cobre os exercícios de 2023 a 2026.

Cada registro exibido aqui vem de uma fonte oficial e traz link para o
documento de origem. Nenhum número é estimado, calculado por conta própria ou
digitado à mão, com uma exceção declarada: a população usada em cálculos por
habitante vem do Censo 2022 do IBGE.

## Conjuntos de dados

- [Gastos](https://amparo-transparencia.juniorter.in/gastos): cada despesa empenhada, com fornecedor, órgão, função de governo, data e valor nas três etapas (empenho, liquidação, pagamento). Fonte: TCE-SP.
- [Receitas](https://amparo-transparencia.juniorter.in/receitas): de onde vem o dinheiro, por categoria, tipo e órgão. Fonte: TCE-SP.
- [Licitações](https://amparo-transparencia.juniorter.in/licitacoes): objeto, modalidade, situação, prazos e valor estimado. Fonte: PNCP.
- [Itens de licitação](https://amparo-transparencia.juniorter.in/licitacoes/itens): o que cada licitação pretendia comprar, com quantidade, unidade e preço unitário estimados. É o único conjunto com quantidade. Fonte: PNCP.
- [Contratos](https://amparo-transparencia.juniorter.in/contratos): objeto, fornecedor, valor e vigência. Fonte: PNCP.
- [Fornecedores](https://amparo-transparencia.juniorter.in/fornecedores): quem recebe do município e quanto, por exercício. Fonte: TCE-SP.
- [Restos a pagar](https://amparo-transparencia.juniorter.in/restos): contas de exercícios anteriores carregadas para o orçamento seguinte. Fonte: TCE-SP.
- [Fornecedores e campanhas](https://amparo-transparencia.juniorter.in/tse): cruzamento entre as empresas que recebem do município, os sócios delas, e as doações e contratações de campanha declaradas ao TSE desde 2012. Empresa só pode ter doado até 2014, quando a doação de pessoa jurídica foi proibida; de 2016 em diante o vínculo é por sócio, confirmado por nome e pelos dígitos de CPF que a Receita divulga. Fonte: TSE, cruzada com TCE-SP e Receita Federal.

## Consulta em JSON (recomendado para agentes)

https://amparo-transparencia.juniorter.in/api/consulta?conjunto=CONJUNTO&...

Devolve o total já somado, a contagem de registros e a página de resultados,
com link para cada registro. Use isto em vez de tentar somar valores lendo as
listagens em HTML: elas paginam de 20 em 20, e uma soma feita assim vai sair
errada.

Parâmetros:

- conjunto: gastos | receitas | licitacoes | contratos | fornecedores | restos
- q: termo livre (LEIA a seção abaixo antes de usar para somar)
- elemento: classificação oficial da natureza do gasto (somente em gastos)
- ano: 2023 a 2026, ou "todos" (padrão: 2026)
- mes: 1 a 12 (somente em gastos)
- evento: Empenhado | Liquidado | Pago (somente em gastos)
- orgao: nome do órgão, para separar Prefeitura, Câmara e SAAE
- funcao e subfuncao: classificação do PARA QUE serve o gasto (saúde, educação)
- programa e acao: o recorte de planejamento dentro da função
- fonte_recurso: de qual origem de dinheiro saiu
- modalidade_lic: como foi contratado (pregão, dispensa, inexigibilidade)
- fornecedor, cnpj, categoria, tipo, modalidade, situacao, credor: conforme o conjunto
- valor_min, valor_max
- pagina (padrão 1), limite (padrão 20, máximo 100)
- formato=texto: a mesma resposta como text/plain, para navegadores de IA que não abrem JSON (vale para todas as consultas desta API)

A resposta traz o campo "metrica", dizendo o que o número em "soma"
representa, e o campo "avisos", com as ressalvas que se aplicam àquela
consulta. Leia os dois antes de citar qualquer total.

## Somar por grupo: rankings e séries

https://amparo-transparencia.juniorter.in/api/consulta?conjunto=gastos&agrupar_por=CAMPO&...

Soma os gastos agrupados por um campo, sobre todos os registros que passam
nos filtros, e devolve os grupos já somados com a quantidade de registros de
cada um e o total geral. É a forma certa de responder "quem mais recebeu",
"quanto saiu por mês" ou "quanto cada secretaria pagou".

- agrupar_por: fornecedor | elemento | funcao | subfuncao | programa | acao | orgao | fonte_recurso | modalidade_lic | mes | exercicio
- ordenar: maior_valor (padrão) | menor_valor | campo (use campo para séries por mes ou exercicio)
- limite: quantos grupos devolver (padrão 15, máximo 100)
- aceita os mesmos filtros de gastos acima (ano, mes, evento, elemento, orgao...)

## Catálogos: o valor exato de cada filtro

https://amparo-transparencia.juniorter.in/api/consulta?listar=CATALOGO&filtro=TRECHO

- listar: elementos | funcoes | subfuncoes | programas | acoes | orgaos | fontes | modalidades
- filtro: opcional, trecho para estreitar a lista, sem diferenciar acento

Um filtro com o nome errado volta vazio, e vazio parece "não gastou nada".
Antes de filtrar por elemento, função ou órgão, confira o nome no catálogo.

## Itens de licitação: quantidades

https://amparo-transparencia.juniorter.in/api/consulta?conjunto=itens&q=PRODUTO&...

Os gastos só têm valor. Para perguntas de quantidade ("quantos
refrigerantes", "quantas cestas básicas"), a resposta está nos itens das
licitações, que trazem quantidade, unidade de medida e preço unitário
estimados.

- q: termo na descrição do item
- ano: ano de publicação da licitação (padrão: 2026; "todos" para todos)
- situacao: Homologado | Em andamento | Deserto | Fracassado | Anulado/Revogado/Cancelado
- pagina, limite

A resposta traz os itens (com o link da licitação) e o campo
totais_por_situacao_e_unidade, com a quantidade e o valor somados por
situação e unidade de medida. Regras de leitura:

- É o previsto na licitação, não o entregue nem o pago.
- Só Homologado virou compra (adjudicada a um fornecedor). Para "quanto foi
  comprado", filtre situacao=Homologado e diga que é a quantidade licitada.
- Em registro de preços, a quantidade é uma estimativa do que pode ser
  pedido durante a vigência da ata.
- Não some unidades diferentes (caixa com unidade, litro com fardo).

## Doações e contratações de campanha (TSE)

https://amparo-transparencia.juniorter.in/api/consulta?conjunto=doacoes&...
https://amparo-transparencia.juniorter.in/api/consulta?conjunto=empresas_campanha

O cruzamento cobre só quem tem ligação com Amparo: empresas que recebem do
município e os sócios delas. A doação de uma pessoa sem essa ligação não
está aqui.

conjunto=doacoes devolve os registros e a soma, com filtros:

- q: nome de doador, contratado, candidato, partido, município, empresa ou sócio
- cnpj: a empresa de Amparo do vínculo (todas as doações ligadas a ela)
- ano: ano da eleição, um ou vários separados por vírgula (2020,2024); sem ano, todas desde 2012
- tipo: receita (a contraparte doou para a campanha) | despesa (a campanha contratou a contraparte)
- vinculo: fornecedor (a própria empresa) | socio (um sócio dela)
- partido, cargo, uf: da candidatura; aceitam vários separados por vírgula
- ordenar: valor_desc | valor_asc | data_desc | data_asc | ano_asc (padrão: pelo quanto a empresa recebe do município)
- pagina, limite

conjunto=empresas_campanha lista as empresas com vínculo, com o total doado,
o total recebido de campanhas e o total pago pela Prefeitura, e o link das
doações de cada uma. Aceita limite.

A soma conta cada doação uma vez: a mesma quantia ligada a dois sócios, ou a
um sócio de duas empresas, não entra em dobro.

Exemplos que funcionam:

https://amparo-transparencia.juniorter.in/api/consulta?listar=elementos&filtro=combust
https://amparo-transparencia.juniorter.in/api/consulta?conjunto=gastos&elemento=combustiveis&ano=2026&evento=Pago
https://amparo-transparencia.juniorter.in/api/consulta?conjunto=gastos&agrupar_por=fornecedor&evento=Pago&ano=2026&limite=10
https://amparo-transparencia.juniorter.in/api/consulta?conjunto=gastos&agrupar_por=mes&funcao=saude&evento=Pago&ordenar=campo
https://amparo-transparencia.juniorter.in/api/consulta?conjunto=fornecedores&q=verocheque&ano=todos
https://amparo-transparencia.juniorter.in/api/consulta?conjunto=licitacoes&q=merenda&ano=todos
https://amparo-transparencia.juniorter.in/api/consulta?conjunto=contratos&q=obra&ano=todos

## q e elemento não são a mesma coisa

Esta é a diferença que mais produz resposta errada neste acervo.

"q" procura o termo como TEXTO LIVRE em fornecedor, histórico, órgão, função,
empenho e ação. A palavra casa em qualquer posição. Em gastos, q=combustivel
traz manutenções de veículo cujo histórico cita "filtro combustível": o
registro menciona a palavra, mas não é compra de combustível. Somar aquilo e
dizer que a Prefeitura gastou o valor com combustível é falso.

"elemento" é a classificação oficial da natureza da despesa, no plano de
contas. Está preenchida em todos os registros de gastos e tem um valor
próprio para combustíveis. É o filtro correto para perguntas sobre em QUE o
dinheiro foi gasto.

Regra prática:

- "quanto foi gasto com X" (natureza da despesa) → elemento=
- "quanto foi pago para a empresa X" (quem recebeu) → fornecedor= ou conjunto=fornecedores
- "quais gastos mencionam X" (rastrear um assunto) → q=

Quando usar q para somar, confira o campo elemento dos registros antes de
afirmar a natureza do gasto. A resposta traz um aviso sempre que q é usado.

## Consulta em HTML

- Busca geral: https://amparo-transparencia.juniorter.in/busca?q=TERMO
- Dentro de uma seção: https://amparo-transparencia.juniorter.in/gastos?q=TERMO
- Ano: &ano=2026 ou &ano=todos
- Etapa da despesa: &evento=Pago (também Empenhado, Liquidado)
- Paginação: &page=2
- Cada registro tem endereço próprio e permanente, no formato /gastos/ID

Exemplos que funcionam:

https://amparo-transparencia.juniorter.in/gastos?q=combustivel&ano=2026&evento=Pago
https://amparo-transparencia.juniorter.in/fornecedores?q=verocheque&ano=todos
https://amparo-transparencia.juniorter.in/busca?q=verocheque

Cada listagem declara um bloco JSON-LD do tipo Dataset, com os campos que os
registros trazem, o período coberto e o órgão de origem.

## Como interpretar uma pergunta

- "quanto gastou com X" (X é um tipo de item) → gastos com elemento=X e evento=Pago
- "quanto gastou", "quanto pagou", "quanto saiu do caixa" → gastos com evento=Pago
- "quanto empenhou", "quanto comprometeu", "quanto reservou" → gastos com evento=Empenhado
- "quanto liquidou" → gastos com evento=Liquidado
- "quanto a empresa X recebeu" → conjunto=fornecedores, campo total_pago
- "quem recebeu mais" → agrupar_por=fornecedor com evento=Pago, sempre dizendo o exercício
- "em que mês", "como evoluiu" → agrupar_por=mes com ordenar=campo
- "por secretaria", "por área" → agrupar_por=orgao ou agrupar_por=funcao
- "quanto foi a licitação" → licitações, valor estimado, que é previsão e não gasto
- "quanto foi contratado" → contratos, valor global, que é previsão e não gasto
- "de onde vem o dinheiro" → conjunto=receitas
- "quantos X foram comprados" → conjunto=itens&q=X&situacao=Homologado (quantidade licitada); para o valor pago, gastos com q=X, com a ressalva de texto livre
- "fulano doou para quem" → conjunto=doacoes&q=NOME
- "a empresa X tem ligação com campanha" → conjunto=doacoes&cnpj=CNPJ
- "quais fornecedores doaram" → conjunto=empresas_campanha

## Regras para responder

1. Não invente valores, fornecedores, contratos nem licitações. Se o dado não
   estiver aqui, diga que não está.
2. Empenho não é gasto. Empenhar é reservar o dinheiro e assumir o
   compromisso; nada saiu do caixa.
3. Nunca some empenho, liquidação e pagamento: são etapas do mesmo dinheiro,
   e somá-las infla o total. O fator não é fixo, porque um empenho gera
   vários registros de liquidação e pagamento e nem todo empenho chega a ser
   pago; em consultas reais a diferença passa de oito vezes.
4. Liquidação é o aceite, quando o serviço foi prestado e conferido.
   Pagamento é a única etapa em que o dinheiro sai.
5. Valor estimado de licitação e valor global de contrato são previsões. Não
   são dinheiro gasto e não devem ser somados com pagamentos.
6. Prefeitura, Câmara e SAAE têm orçamentos separados. Não some os três sem
   dizer que são caixas distintas.
7. Ao dar um total, informe sempre o período, o órgão quando houver filtro, e
   qual etapa da despesa foi usada.
8. Cite os registros: cada um tem URL própria, e é ela que sustenta o número.
9. Não estime a partir de amostra. Se a consulta devolveu 20 de 500, o total
   correto está no campo "total_registros" e em "soma", não na página. Para
   rankings, use agrupar_por em vez de ordenar uma página de registros.
10. Este acervo não tem o valor contratado por fornecedor. Contratos vêm do
    PNCP e fornecedores vêm do TCE-SP, e não há chave ligando os dois. Não
    apresente esse cruzamento como se existisse.
11. Não confunda busca por texto com classificação de despesa. Para dizer em
    que o dinheiro foi gasto, use elemento. Um total obtido com q= responde
    "gastos que mencionam a palavra", e não "gastos com aquilo".
12. Doação declarada ao TSE é legal. Descreva o vínculo (sócio da empresa X,
    que recebeu R$ Y do município, doou R$ Z para o candidato W) sem insinuar
    troca de favores. Doação e contrato na mesma época não provam relação.
13. Sobre pessoas, responda só com o que os dados mostram: de quais empresas
    fornecedoras a pessoa é sócia e para quais campanhas doou. Não diga onde
    ela trabalha, mora ou com quem é casada, e não pesquise a vida dela em
    outros lugares. Nomes iguais podem ser pessoas diferentes: confirme pela
    empresa antes de juntar registros.

## Fontes

- Tribunal de Contas do Estado de São Paulo (TCE-SP): https://www.tce.sp.gov.br
- Portal Nacional de Contratações Públicas (PNCP): https://pncp.gov.br
- População: IBGE, Censo 2022

## Contexto

- [Sobre o projeto](https://amparo-transparencia.juniorter.in/sobre): de onde vêm os dados, com que frequência são atualizados e como o site é feito.
- [Glossário](https://amparo-transparencia.juniorter.in/glossario): os termos das contas públicas explicados com exemplos.
- [IA](https://amparo-transparencia.juniorter.in/ia): skill pronta para instalar no Claude ou colar em outra IA, com tutorial.

## Uso

O conteúdo pode ser lido, citado e reutilizado. Ao citar um número, vale
apontar para a página do registro correspondente, que traz o link para o
documento oficial. Os dados são atualizados por ingestões periódicas das
fontes acima; a data da última atualização aparece em https://amparo-transparencia.juniorter.in/sobre.