Repository navigation
fix(brasil-api): get_cnpj para de tomar 403 (User-Agent no cliente HTTP) - #226
Merged
Merged
Conversation
Node's fetch (undici) fills in "User-Agent: node" when the caller omits the header. BrasilAPI's edge answers 403 Forbidden to that UA on /cnpj, so get_cnpj failed for every user of this server, on every call, not just in some error path. Measured live on 2026-08-28 against brasilapi.com.br: GET /cnpj/v1/00000000000191 UA "node" -> 403 GET /cnpj/v1/00000000000191 UA "codespar-mcp-dev-latam/..." -> 200 GET /cep/v1/01001000 UA "node" -> 200 brasilApiRequest now sets the same UA format the other servers in this repo use (payments/malga, payments/rinne). Tests: two unit tests pin the header on the request the server builds, and a new contract.test.ts produces the third-party half for real (gated by BRASIL_API_CONTRACT, skipped in CI) with a paired positive control that shows the gate is BrasilAPI's, not a dead probe. The tsconfig exclude is required, not cosmetic: test-utils/contract.ts lives outside the package rootDir, so without it tsc fails and still emits a CommonJS test-utils/contract.js that breaks every contract test in the repo. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Lane
catalogoda auditoria. Dois achados atribuidos: catalog-satellites#5 (consertado aqui) ecatalog-satellites#10 (nao cabe neste repo, detalhado abaixo). catalog-satellites#11 ficou
fora da lane por despacho.
catalog-satellites#5 —
get_cnpjdevolve 403 em uso normal (CONSERTADO)Mecanismo
packages/identity/brasil-api/src/index.ts:56monta a unica requisicao HTTP do servidor:A ficha diz "o cliente HTTP nao manda User-Agent". Medi antes de mexer e a descricao precisa e
outra: o
fetchdo Node (undici) preenche o header sozinho quando o chamador nao passa nada.Servidor HTTP local, Node v25.5.0, mesma chamada acima:
O que a BrasilAPI rejeita e esse
node. Medido ao vivo em 28/08/2026, tres execucoes seguidas,mesma URL, so o header mudando:
GET /cep/v1/01001000responde 200 comUA=node, e por isso o problema so aparecia no CNPJ. ComobrasilApiRequeste o caminho unico das 24 tools, a correcao vale para todas.Limite do que foi medido: as tres execucoes sairam de um unico host, no mesmo minuto, mudando so o
header. Isso estabelece que o discriminador e o
User-Agent, nao que a regra da borda sejaidentica para toda origem de rede. Nao testei de uma segunda rede.
O que mudou
packages/identity/brasil-api/src/index.ts: constanteUSER_AGENT = "codespar-mcp-dev-latam/mcp-brasil-api/0.2.2"e o header nofetch. O formato segue o que osservidores mais recentes do repo ja usam (
packages/payments/malga/src/index.ts:65,packages/payments/rinne/src/index.ts:76). Verifiquei ao vivo que essa string tambem devolve 200.packages/identity/brasil-api/src/__tests__/index.test.ts: dois testes de unidade.packages/identity/brasil-api/src/__tests__/contract.test.ts(novo): teste de contrato ao vivo,gated por
BRASIL_API_CONTRACT, seguindotest-utils/contract.ts. Nao usa credencial: aBrasilAPI e publica e o gate so serve para nao botar rede no CI.
packages/identity/brasil-api/tsconfig.json:"exclude": ["src/__tests__"]. Isso nao ecosmetico e esta explicado na secao "Efeito colateral" abaixo.
docs/CONTRIBUTING.md: como rodar o teste de contrato novo e o aviso doexclude.Por que os testes nao caem nas armadilhas
O defeito depende do comportamento de um terceiro, entao ele nao foi escrito a mao: o vermelho vem
da API real. O teste de contrato tem controle positivo pareado dentro do mesmo
it: dispara amesma URL duas vezes, uma com o UA default e outra com um UA descritivo, e exige que a segunda
passe antes de exigir que a primeira falhe. Se a BrasilAPI estiver fora do ar ou limitando este
host, o controle falha primeiro e a asserção de rejeicao nao e lida como sinal.
O teste de unidade tambem carrega controle positivo: le
content-typedo mesmo objeto capturadoantes de olhar o
user-agent. Se o instrumento (new Headers(init.headers)) estivesse quebrado, ocontent-typeviria nulo e o teste acusaria a sonda, nao o codigo.Vermelho antes
Unidade (
npx vitest run packages/identity/brasil-api/src/__tests__/index.test.ts):Contrato ao vivo (
BRASIL_API_CONTRACT=1 npx vitest run .../contract.test.ts), erro produzido pelaAPI de verdade, nao redigido por mim:
Verde depois
Suite inteira do repo (
npm test), antes e depois:Delta: +2 testes de unidade passando, +2 de contrato pulados sem credencial. Nenhum teste existente
mudou de estado.
Revertido confere
Devolvi so
src/index.tspara o estado demain(git checkoutno arquivo de producao), mantendoos dois arquivos de teste, e rodei de novo:
Os testes nao espelham a logica: com o arquivo de producao revertido eles falham, e o controle
positivo continua verde nos dois estados.
Divergencia da ficha proposta
A ficha sugeria, para "fechar a classe", mover o
fetchpara um helper empackages/shared(
@codespar/mcp-shared) e fazer os servidores usarem esse helper. Nao fiz, e recomendo naofazer assim. Medida:
@codespar/mcp-brasil-apie publicado no npm e instalado vianpx. Declarar dependencia de umpacote que nao existe no registry quebraria a instalacao de todo mundo, para trocar um header
duplicado por um
import. Adotar o helper e uma mudanca de empacotamento (publicar omcp-sharedprimeiro), nao parte deste conserto. Fica registrado como o que este PR nao fecha.Efeito colateral que o
excludedo tsconfig evitatest-utils/contract.tsfica fora dorootDirde qualquer pacote. Sem"exclude": ["src/__tests__"], otscdo pacote nao so falha:como ainda emite um
test-utils/contract.jsem CommonJS ao lado do.ts. Bati nisso durante otrabalho: com esse arquivo no disco, os 4 arquivos de contrato do repo passam a falhar em bloco com
Vitest cannot be imported in a CommonJS module using require(). Os dois pacotes que ja tem testede contrato (
payments/mercado-pago,payments/celcoin) ja carregam esseexclude; brasil-apiagora tambem. Efeito bonus:
dist/deixa de embarcar os testes no pacote publicado (antes:dist/index.js,dist/index.d.ts,dist/__tests__/...; agora so os dois primeiros).O que este PR nao fecha
User-Agent; a classecontinua aberta. Este PR conserta o unico caso medido como alcancavel e quebrado em producao
(
get_cnpj= 403 em toda chamada). Varrer o resto exige medir provedor por provedor, e ocaminho Celcoin esta congelado ate a homologacao de 31/08.
@codespar/mcp-sharednem centraliza o cliente HTTP (motivo acima).brasil-api(package.jsoneserver.jsondizem0.2.2, onew Server(...)emindex.tsainda diz0.2.1, em duas ocorrencias). Fora doescopo da ficha e sem medicao de impacto; deixei intacto de proposito.
catalog-satellites#10 — os dois repos satelite nao tem CI (NAO CONSERTADO AQUI)
Confirmei o achado, mas ele nao pode ser feito neste PR: o patch pede workflows em
codespar/x402-monetization-examplesecodespar/agentic-payments-standards, e a lane tem cloneso de
mcp-dev-latam. Abrir PR nos outros dois seria trabalhar fora do clone da lane.Verificacao que fiz (leitura pura, via API):
Os dois sao publicos,
default_branch: main, e nao tem diretorio.githubnenhum. O achadoprocede. Controle positivo do mecanismo: este repo tem CI de verdade
(
.github/workflows/ci.yml, jobsbuild-and-test,catalog,security), e foi contra ele querodei a verificacao de estado do CI abaixo.
Uma ressalva sobre o teste proposto na ficha ("PR de controle com import quebrado"): esse teste so
existe depois que o workflow esta no repo de destino, e o vermelho dele e "o PR nao tem check
nenhum", que nao da para rodar localmente. Quem pegar o achado precisa de clone dos dois repos e
de dois PRs separados.
Estado real do CI
Reproduzi os tres jobs do
.github/workflows/ci.ymllocalmente neste branch:build-and-test:npm run build --workspaces --if-present-> exit 0, zeroerror TS;npm test-> 36 arquivos passando, 3 pulados, 150 testes passando, 34 pulados.catalog:npm run audit:catalog-> exit 0 (so achados MED preexistentes, sobre headers## Authenticationfaltando em tres servers da Colombia; nenhum HIGH).security: o grep de segredo do workflow ->No hardcoded secrets found.E o CI do GitHub Actions rodou neste branch e voltou verde nos tres jobs
(run 33180857042):
Nenhum job vermelho, nenhum check pendente. O teste de contrato novo aparece como pulado no CI,
que e o comportamento pretendido: sem
BRASIL_API_CONTRACTele nao toca a rede.Segredo
Nenhum. O CNPJ usado no teste de contrato e
00000000000191(Banco do Brasil S.A.), registropublico. A BrasilAPI nao tem autenticacao, e nenhum
.envfoi criado ou lido.