kyb-brasil
Brazilian KYB beyond registry checks: CGU sanctions, forced labour, PGFN, IBAMA, signed risk score
我该使用它吗
质量与安全性
A
基于对工具定义和协议合规性的自动分析。
上下文开销
~7,492token 数（工具定义）
~7.0 KB典型响应大小
对注意力有显著影响（占 128k 上下文窗口的 5.85%）
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中：
{
"mcpServers": {
"kyb-brasil": {
"url": "https://kyb-br-agents-dev.marcelfons.workers.dev/mcp"
}
}
}远程端点
https://kyb-br-agents-dev.marcelfons.workers.dev/mcpstreamable-httphttps://kyb-br-agents.marcelfons.workers.dev/mcpstreamable-http它能做什么
工具清单
工具（11）
🟢 只读🟡 写入🔴 删除⚪ 未知
🟢br_about
Free. What KYB Brasil is and why to use it over a plain registry check: every tool with price and HTTP route, how x402 payment works, free-tier limits, the attestation key, docs (OpenAPI, llms.txt, skill.md) and sources. Call it first when you do not know the service.
输入模式
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"service": {
"type": "string"
},
"version": {
"type": "string"
},
"why_this_one": {
"type": "array",
"items": {
"type": "string"
}
},
"tools": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"price_usd": {
"type": "number"
},
"http": {
"type": "string"
}
},
"required": [
"name",
"price_usd",
"http"
],
"additionalProperties": {}
}
}
},
"required": [
"service",
"version",
"why_this_one",
"tools"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢br_company_check(cnpj)
Free. Brazilian company (CNPJ) registration check at the Receita Federal: status (ATIVA/BAIXADA/INAPTA...), legal name, CNAE, size, age, normalized address. Structured JSON plus a summary in English and Portuguese, with sources[] and data_freshness. Rate limited (50/day).
输入模式
{
"type": "object",
"properties": {
"cnpj": {
"type": "string",
"minLength": 14,
"maxLength": 18,
"description": "Brazilian CNPJ, 14 characters, with or without punctuation (e.g. 00.000.000/0001-91)."
}
},
"required": [
"cnpj"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"cnpj": {
"type": "string",
"description": "Normalized 14-character CNPJ."
},
"summary": {
"type": "object",
"properties": {
"en": {
"type": "string"
},
"pt": {
"type": "string"
}
},
"required": [
"en",
"pt"
],
"additionalProperties": false,
"description": "Short summary in English and Portuguese."
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"url": {
"type": "string"
},
"fetched_at": {
"type": "string"
}
},
"required": [
"name",
"url",
"fetched_at"
],
"additionalProperties": {}
},
"description": "Source URL and fetch time of each fact."
},
"data_freshness": {
"type": "string"
},
"generated_at": {
"type": "string"
},
"cached": {
"type": "boolean"
},
"legal_name": {
"type": "string"
},
"registration_status": {
"type": "string",
"description": "ATIVA, SUSPENSA, INAPTA, BAIXADA, NULA or UNKNOWN."
},
"opened_at": {
"type": [
"string",
"null"
]
},
"main_activity": {
"anyOf": [
{
"type": "object",
"properties": {
"code": {
"type": "string"
},
"description": {
"type": "string"
}
},
"required": [
"code",
"description"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"address": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"required": [
"cnpj",
"summary",
"sources",
"data_freshness",
"generated_at",
"cached",
"legal_name",
"registration_status",
"opened_at",
"main_activity",
"address"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢br_company_search(query, state, limit)
Free. Find a Brazilian company's CNPJ by name (legal or trade name, optional state/UF) in the Receita Federal registry of ACTIVE establishments (monthly dump; individual entrepreneurs/MEI not indexed, query those by CNPJ). Returns up to 20 candidates with CNPJ, names, city/state, main activity and opening date. Use the CNPJ with the other tools. Rate limited (50/day).
输入模式
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 3,
"maxLength": 120,
"description": "Company name, legal or trade (e.g. 'Petrobras', 'construtora alfa')."
},
"state": {
"description": "Optional UF to narrow down (e.g. 'SP').",
"type": "string",
"minLength": 2,
"maxLength": 2
},
"limit": {
"description": "Max results, default 10.",
"type": "integer",
"minimum": 1,
"maximum": 20
}
},
"required": [
"query"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"query": {
"type": "string"
},
"state": {
"type": [
"string",
"null"
]
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cnpj": {
"type": "string"
},
"cnpj_formatted": {
"type": "string"
},
"legal_name": {
"type": "string"
},
"trade_name": {
"type": [
"string",
"null"
]
},
"registration_status": {
"type": "string"
},
"is_headquarters": {
"type": "boolean"
},
"city": {
"type": [
"string",
"null"
]
},
"state": {
"type": [
"string",
"null"
]
}
},
"required": [
"cnpj",
"cnpj_formatted",
"legal_name",
"trade_name",
"registration_status",
"is_headquarters",
"city",
"state"
],
"additionalProperties": {}
}
},
"reference_month": {
"type": "string"
},
"summary": {
"type": "object",
"properties": {
"en": {
"type": "string"
},
"pt": {
"type": "string"
}
},
"required": [
"en",
"pt"
],
"additionalProperties": false,
"description": "Short summary in English and Portuguese."
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"url": {
"type": "string"
},
"fetched_at": {
"type": "string"
}
},
"required": [
"name",
"url",
"fetched_at"
],
"additionalProperties": {}
}
},
"data_freshness": {
"type": "string"
},
"generated_at": {
"type": "string"
},
"cached": {
"type": "boolean"
}
},
"required": [
"query",
"state",
"results",
"reference_month",
"summary",
"sources",
"data_freshness",
"generated_at",
"cached"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢br_company_count(cnae, state, city, opened_after, opened_before, ...)
Free. How many ACTIVE Brazilian establishments match a prospecting filter (CNAE code or prefix, state/UF, city, opening date range, headquarters only), from the Receita Federal monthly registry. Use it to budget pages before paying for br_company_list. Rate limited (50/day).
输入模式
{
"type": "object",
"properties": {
"cnae": {
"description": "CNAE code or prefix: '6201-5/00', '6201500', '6201' (class) or '62' (division).",
"type": "string",
"maxLength": 12
},
"state": {
"description": "UF, e.g. 'SP'.",
"type": "string",
"minLength": 2,
"maxLength": 2
},
"city": {
"description": "Municipality name (accents and case ignored).",
"type": "string",
"maxLength": 80
},
"opened_after": {
"description": "Opened on or after (YYYY-MM-DD).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"opened_before": {
"description": "Opened on or before (YYYY-MM-DD).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"hq_only": {
"description": "Only headquarters (one row per company).",
"type": "boolean"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"filters": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"total": {
"type": "number"
},
"pages_of_100": {
"type": "number"
},
"reference_month": {
"type": "string"
},
"summary": {
"type": "object",
"properties": {
"en": {
"type": "string"
},
"pt": {
"type": "string"
}
},
"required": [
"en",
"pt"
],
"additionalProperties": false,
"description": "Short summary in English and Portuguese."
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"url": {
"type": "string"
},
"fetched_at": {
"type": "string"
}
},
"required": [
"name",
"url",
"fetched_at"
],
"additionalProperties": {}
}
},
"data_freshness": {
"type": "string"
},
"generated_at": {
"type": "string"
},
"cached": {
"type": "boolean"
}
},
"required": [
"filters",
"total",
"pages_of_100",
"reference_month",
"summary",
"sources",
"data_freshness",
"generated_at",
"cached"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢br_replay(token)
Free. Fetch again, without paying, a paid answer from the last 10 minutes using the receipt.replay_token it carried. Use it when the first response was lost (timeout, disconnect) instead of paying twice.
输入模式
{
"type": "object",
"properties": {
"token": {
"type": "string",
"description": "receipt.replay_token from a paid answer (valid 10 minutes)."
}
},
"required": [
"token"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"generated_at": {
"type": "string"
},
"cached": {
"type": "boolean"
},
"receipt": {
"type": "object",
"properties": {
"replay_token": {
"type": "string"
},
"replay_until": {
"type": "string"
}
},
"required": [
"replay_token",
"replay_until"
],
"additionalProperties": false,
"description": "Re-read this answer free for 10 minutes with br_replay."
},
"attestation": {
"type": "object",
"properties": {
"algorithm": {
"type": "string"
},
"key_id": {
"type": "string"
},
"sha256": {
"type": "string"
},
"signed_at": {
"type": "string"
},
"signature": {
"type": "string"
},
"verify_url": {
"type": "string"
}
},
"required": [
"algorithm",
"key_id",
"sha256",
"signed_at",
"signature",
"verify_url"
],
"additionalProperties": false,
"description": "Ed25519 signature of this answer; verify at verify_url or with the public key at /.well-known/kyb-attestation.json."
}
},
"required": [
"generated_at",
"cached",
"receipt"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢br_sanctions_screen(cnpj)
Screen a Brazilian CNPJ, all branches of the same company (CNPJ root) and its corporate partners against the official CGU sanction lists: CEIS (debarred), CNEP (anti-corruption penalties), CEPIM (barred non-profits), leniency agreements, plus the Ministry of Labour forced-labour employer list. Each hit has type, body, dates, active flag and an evidence URL. Beyond a plain CEIS/CNEP check. Signed answer (Ed25519 attestation), verifiable at /v1/verify.
输入模式
{
"type": "object",
"properties": {
"cnpj": {
"type": "string",
"minLength": 14,
"maxLength": 18,
"description": "Brazilian CNPJ, 14 characters, with or without punctuation (e.g. 00.000.000/0001-91)."
}
},
"required": [
"cnpj"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"cnpj": {
"type": "string",
"description": "Normalized 14-character CNPJ."
},
"summary": {
"type": "object",
"properties": {
"en": {
"type": "string"
},
"pt": {
"type": "string"
}
},
"required": [
"en",
"pt"
],
"additionalProperties": false,
"description": "Short summary in English and Portuguese."
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"url": {
"type": "string"
},
"fetched_at": {
"type": "string"
}
},
"required": [
"name",
"url",
"fetched_at"
],
"additionalProperties": {}
},
"description": "Source URL and fetch time of each fact."
},
"data_freshness": {
"type": "string"
},
"generated_at": {
"type": "string"
},
"cached": {
"type": "boolean"
},
"receipt": {
"type": "object",
"properties": {
"replay_token": {
"type": "string"
},
"replay_until": {
"type": "string"
}
},
"required": [
"replay_token",
"replay_until"
],
"additionalProperties": false,
"description": "Re-read this answer free for 10 minutes with br_replay."
},
"attestation": {
"type": "object",
"properties": {
"algorithm": {
"type": "string"
},
"key_id": {
"type": "string"
},
"sha256": {
"type": "string"
},
"signed_at": {
"type": "string"
},
"signature": {
"type": "string"
},
"verify_url": {
"type": "string"
}
},
"required": [
"algorithm",
"key_id",
"sha256",
"signed_at",
"signature",
"verify_url"
],
"additionalProperties": false,
"description": "Ed25519 signature of this answer; verify at verify_url or with the public key at /.well-known/kyb-attestation.json."
},
"clear": {
"type": "boolean",
"description": "True when there is no ACTIVE sanction on the company, its branches or corporate partners."
},
"active_hits": {
"type": "number"
},
"expired_hits": {
"type": "number"
},
"hits": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"description": "Each hit: list, sanctioned_entity, sanction_type, dates, active, evidence_url."
},
"screened_entities": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"required": [
"cnpj",
"summary",
"sources",
"data_freshness",
"generated_at",
"cached",
"clear",
"active_hits",
"expired_hits",
"hits",
"screened_entities"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢br_risk_screen(cnpj)
Red flags a registry check misses, a third of the dossier price: Receita Federal status + sanctions (CEIS/CNEP/CEPIM/leniency/forced labour) + PGFN debt and fiscal regularity (Simples/MEI, CND hint) + IBAMA embargoes + court cases (DJEN, 12 months) + OFAC/UN/EU screening + economic group (companies sharing partners) + 0-100 risk score + per-section data quality. No contracts, BNDES or gazettes. Signed answer (Ed25519 attestation), verifiable at /v1/verify.
输入模式
{
"type": "object",
"properties": {
"cnpj": {
"type": "string",
"minLength": 14,
"maxLength": 18,
"description": "Brazilian CNPJ, 14 characters, with or without punctuation (e.g. 00.000.000/0001-91)."
}
},
"required": [
"cnpj"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"cnpj": {
"type": "string",
"description": "Normalized 14-character CNPJ."
},
"summary": {
"type": "object",
"properties": {
"en": {
"type": "string"
},
"pt": {
"type": "string"
}
},
"required": [
"en",
"pt"
],
"additionalProperties": false,
"description": "Short summary in English and Portuguese."
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"url": {
"type": "string"
},
"fetched_at": {
"type": "string"
}
},
"required": [
"name",
"url",
"fetched_at"
],
"additionalProperties": {}
},
"description": "Source URL and fetch time of each fact."
},
"data_freshness": {
"type": "string"
},
"generated_at": {
"type": "string"
},
"cached": {
"type": "boolean"
},
"company": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"sanctions": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"federal_debt": {
"anyOf": [
{
"type": "object",
"properties": {
"inscriptions": {
"type": "number"
},
"total_brl": {
"type": "number"
},
"judicial": {
"type": "boolean"
}
},
"required": [
"inscriptions",
"total_brl",
"judicial"
],
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"environmental_embargoes": {
"anyOf": [
{
"type": "object",
"properties": {
"active": {
"type": "number"
},
"total": {
"type": "number"
}
},
"required": [
"active",
"total"
],
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"international_sanctions": {
"anyOf": [
{
"type": "object",
"properties": {
"possible_matches": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"required": [
"possible_matches"
],
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"fiscal_regularity": {
"type": "object",
"properties": {
"tax_regime": {
"type": [
"string",
"null"
]
},
"federal_debt_on_record": {
"type": [
"boolean",
"null"
]
},
"likely_eligible_for_cnd": {
"type": [
"boolean",
"null"
]
},
"cnd_url": {
"type": "string"
}
},
"required": [
"tax_regime",
"federal_debt_on_record",
"likely_eligible_for_cnd",
"cnd_url"
],
"additionalProperties": {}
},
"economic_group": {
"anyOf": [
{
"type": "object",
"properties": {
"partners_checked": {
"type": "number"
},
"total": {
"type": "number"
},
"companies": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"required": [
"partners_checked",
"total",
"companies"
],
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "Other active companies sharing a partner, with their sanction/embargo flags (null = registry unavailable)."
},
"risk": {
"type": "object",
"properties": {
"level": {
"type": "string"
},
"score": {
"type": "number"
},
"red_flags": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"next_steps": {
"description": "Recommended actions, most severe first.",
"type": "array",
"items": {
"type": "object",
"properties": {
"en": {
"type": "string"
},
"pt": {
"type": "string"
}
},
"required": [
"en",
"pt"
],
"additionalProperties": false
}
}
},
"required": [
"level",
"score",
"red_flags"
],
"additionalProperties": false
},
"data_quality": {
"type": "array",
"items": {
"type": "object",
"properties": {
"section": {
"type": "string"
},
"reference_date": {
"type": [
"string",
"null"
]
},
"age_days": {
"type": [
"number",
"null"
]
},
"grade": {
"type": "string"
}
},
"required": [
"section",
"reference_date",
"age_days",
"grade"
],
"additionalProperties": false
},
"description": "Per-section data age: fresh, aging, stale, unavailable or unknown."
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"receipt": {
"type": "object",
"properties": {
"replay_token": {
"type": "string"
},
"replay_until": {
"type": "string"
}
},
"required": [
"replay_token",
"replay_until"
],
"additionalProperties": false,
"description": "Re-read this answer free for 10 minutes with br_replay."
},
"attestation": {
"type": "object",
"properties": {
"algorithm": {
"type": "string"
},
"key_id": {
"type": "string"
},
"sha256": {
"type": "string"
},
"signed_at": {
"type": "string"
},
"signature": {
"type": "string"
},
"verify_url": {
"type": "string"
}
},
"required": [
"algorithm",
"key_id",
"sha256",
"signed_at",
"signature",
"verify_url"
],
"additionalProperties": false,
"description": "Ed25519 signature of this answer; verify at verify_url or with the public key at /.well-known/kyb-attestation.json."
}
},
"required": [
"cnpj",
"summary",
"sources",
"data_freshness",
"generated_at",
"cached",
"company",
"sanctions",
"federal_debt",
"environmental_embargoes",
"international_sanctions",
"fiscal_regularity",
"economic_group",
"risk",
"data_quality",
"warnings"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢br_company_dossier(cnpj)
One-call KYB due diligence, beyond a registry check: Receita Federal registration + ownership (no personal IDs) + economic group + sanctions (CEIS/CNEP/CEPIM/leniency/forced labour) + PGFN debt and fiscal regularity + IBAMA embargoes + court cases (DJEN) + federal contracts + BNDES + OFAC/UN/EU screening + gazettes + 0-100 risk score with explained red flags + per-section data quality, sources[]. Signed answer (Ed25519 attestation), verifiable at /v1/verify.
输入模式
{
"type": "object",
"properties": {
"cnpj": {
"type": "string",
"minLength": 14,
"maxLength": 18,
"description": "Brazilian CNPJ, 14 characters, with or without punctuation (e.g. 00.000.000/0001-91)."
}
},
"required": [
"cnpj"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"cnpj": {
"type": "string",
"description": "Normalized 14-character CNPJ."
},
"summary": {
"type": "object",
"properties": {
"en": {
"type": "string"
},
"pt": {
"type": "string"
}
},
"required": [
"en",
"pt"
],
"additionalProperties": false,
"description": "Short summary in English and Portuguese."
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"url": {
"type": "string"
},
"fetched_at": {
"type": "string"
}
},
"required": [
"name",
"url",
"fetched_at"
],
"additionalProperties": {}
},
"description": "Source URL and fetch time of each fact."
},
"data_freshness": {
"type": "string"
},
"generated_at": {
"type": "string"
},
"cached": {
"type": "boolean"
},
"company": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"partners": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"sanctions": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"federal_contracts": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"federal_debt": {
"anyOf": [
{
"type": "object",
"properties": {
"inscriptions": {
"type": "number"
},
"total_brl": {
"type": "number"
},
"judicial": {
"type": "boolean"
}
},
"required": [
"inscriptions",
"total_brl",
"judicial"
],
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "PGFN active federal debt (null = dataset unavailable)."
},
"environmental_embargoes": {
"anyOf": [
{
"type": "object",
"properties": {
"active": {
"type": "number"
},
"total": {
"type": "number"
}
},
"required": [
"active",
"total"
],
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "IBAMA embargo terms."
},
"bndes_financing": {
"anyOf": [
{
"type": "object",
"properties": {
"contracts": {
"type": "number"
},
"total_contracted_brl": {
"type": "number"
}
},
"required": [
"contracts",
"total_contracted_brl"
],
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"international_sanctions": {
"anyOf": [
{
"type": "object",
"properties": {
"possible_matches": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"required": [
"possible_matches"
],
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "OFAC/UN/EU name-only matches; informational, never scored."
},
"gazette_mentions": {
"anyOf": [
{
"type": "object",
"properties": {
"total": {
"type": "number"
},
"recent": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"required": [
"total",
"recent"
],
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Querido Diário mentions in municipal official gazettes."
},
"fiscal_regularity": {
"type": "object",
"properties": {
"tax_regime": {
"type": [
"string",
"null"
]
},
"federal_debt_on_record": {
"type": [
"boolean",
"null"
]
},
"likely_eligible_for_cnd": {
"type": [
"boolean",
"null"
]
},
"cnd_url": {
"type": "string"
}
},
"required": [
"tax_regime",
"federal_debt_on_record",
"likely_eligible_for_cnd",
"cnd_url"
],
"additionalProperties": {}
},
"economic_group": {
"anyOf": [
{
"type": "object",
"properties": {
"partners_checked": {
"type": "number"
},
"total": {
"type": "number"
},
"companies": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"required": [
"partners_checked",
"total",
"companies"
],
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "Other active companies sharing a partner, with their sanction/embargo flags (null = registry unavailable)."
},
"risk": {
"type": "object",
"properties": {
"level": {
"type": "string"
},
"score": {
"type": "number"
},
"red_flags": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"next_steps": {
"description": "Recommended actions, most severe first.",
"type": "array",
"items": {
"type": "object",
"properties": {
"en": {
"type": "string"
},
"pt": {
"type": "string"
}
},
"required": [
"en",
"pt"
],
"additionalProperties": false
}
}
},
"required": [
"level",
"score",
"red_flags"
],
"additionalProperties": false
},
"data_quality": {
"type": "array",
"items": {
"type": "object",
"properties": {
"section": {
"type": "string"
},
"reference_date": {
"type": [
"string",
"null"
]
},
"age_days": {
"type": [
"number",
"null"
]
},
"grade": {
"type": "string"
}
},
"required": [
"section",
"reference_date",
"age_days",
"grade"
],
"additionalProperties": false
},
"description": "Per-section data age: fresh, aging, stale, unavailable or unknown."
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"receipt": {
"type": "object",
"properties": {
"replay_token": {
"type": "string"
},
"replay_until": {
"type": "string"
}
},
"required": [
"replay_token",
"replay_until"
],
"additionalProperties": false,
"description": "Re-read this answer free for 10 minutes with br_replay."
},
"attestation": {
"type": "object",
"properties": {
"algorithm": {
"type": "string"
},
"key_id": {
"type": "string"
},
"sha256": {
"type": "string"
},
"signed_at": {
"type": "string"
},
"signature": {
"type": "string"
},
"verify_url": {
"type": "string"
}
},
"required": [
"algorithm",
"key_id",
"sha256",
"signed_at",
"signature",
"verify_url"
],
"additionalProperties": false,
"description": "Ed25519 signature of this answer; verify at verify_url or with the public key at /.well-known/kyb-attestation.json."
}
},
"required": [
"cnpj",
"summary",
"sources",
"data_freshness",
"generated_at",
"cached",
"company",
"partners",
"sanctions",
"federal_contracts",
"federal_debt",
"environmental_embargoes",
"bndes_financing",
"international_sanctions",
"gazette_mentions",
"fiscal_regularity",
"economic_group",
"risk",
"data_quality",
"warnings"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢br_batch_sanctions(cnpjs)
Up to 10 CNPJs in one paid call (one payment, 25% off): br_sanctions_screen for each. Per-item errors are reported inline in results[]; the call fails (and is not charged) only when no item succeeds. Signed answer (Ed25519 attestation), verifiable at /v1/verify.
输入模式
{
"type": "object",
"properties": {
"cnpjs": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"minLength": 14,
"maxLength": 18,
"description": "Brazilian CNPJ, 14 characters, with or without punctuation (e.g. 00.000.000/0001-91)."
},
"description": "1 to 10 CNPJs."
}
},
"required": [
"cnpjs"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"count": {
"type": "number"
},
"succeeded": {
"type": "number"
},
"failed": {
"type": "number"
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cnpj_input": {
"type": "string"
},
"ok": {
"type": "boolean"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"additionalProperties": false
}
},
"required": [
"cnpj_input",
"ok"
],
"additionalProperties": false
}
},
"summary": {
"type": "object",
"properties": {
"en": {
"type": "string"
},
"pt": {
"type": "string"
}
},
"required": [
"en",
"pt"
],
"additionalProperties": false,
"description": "Short summary in English and Portuguese."
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"url": {
"type": "string"
},
"fetched_at": {
"type": "string"
}
},
"required": [
"name",
"url",
"fetched_at"
],
"additionalProperties": {}
}
},
"data_freshness": {
"type": "string"
},
"generated_at": {
"type": "string"
},
"cached": {
"type": "boolean"
},
"receipt": {
"type": "object",
"properties": {
"replay_token": {
"type": "string"
},
"replay_until": {
"type": "string"
}
},
"required": [
"replay_token",
"replay_until"
],
"additionalProperties": false,
"description": "Re-read this answer free for 10 minutes with br_replay."
}
},
"required": [
"count",
"succeeded",
"failed",
"results",
"summary",
"sources",
"data_freshness",
"generated_at",
"cached"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢br_batch_dossier(cnpjs)
Up to 10 CNPJs in one paid call (one payment, a third off): br_company_dossier for each. Per-item errors are reported inline in results[]; the call fails (and is not charged) only when no item succeeds. Signed answer (Ed25519 attestation), verifiable at /v1/verify.
输入模式
{
"type": "object",
"properties": {
"cnpjs": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"minLength": 14,
"maxLength": 18,
"description": "Brazilian CNPJ, 14 characters, with or without punctuation (e.g. 00.000.000/0001-91)."
},
"description": "1 to 10 CNPJs."
}
},
"required": [
"cnpjs"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"count": {
"type": "number"
},
"succeeded": {
"type": "number"
},
"failed": {
"type": "number"
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cnpj_input": {
"type": "string"
},
"ok": {
"type": "boolean"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"additionalProperties": false
}
},
"required": [
"cnpj_input",
"ok"
],
"additionalProperties": false
}
},
"summary": {
"type": "object",
"properties": {
"en": {
"type": "string"
},
"pt": {
"type": "string"
}
},
"required": [
"en",
"pt"
],
"additionalProperties": false,
"description": "Short summary in English and Portuguese."
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"url": {
"type": "string"
},
"fetched_at": {
"type": "string"
}
},
"required": [
"name",
"url",
"fetched_at"
],
"additionalProperties": {}
}
},
"data_freshness": {
"type": "string"
},
"generated_at": {
"type": "string"
},
"cached": {
"type": "boolean"
},
"receipt": {
"type": "object",
"properties": {
"replay_token": {
"type": "string"
},
"replay_until": {
"type": "string"
}
},
"required": [
"replay_token",
"replay_until"
],
"additionalProperties": false,
"description": "Re-read this answer free for 10 minutes with br_replay."
}
},
"required": [
"count",
"succeeded",
"failed",
"results",
"summary",
"sources",
"data_freshness",
"generated_at",
"cached"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢br_company_list(cnae, state, city, opened_after, opened_before, ...)
Prospecting list: one page of 100 ACTIVE Brazilian establishments matching a filter (CNAE code or prefix, state/UF, city, opening date range, headquarters only), with CNPJ, legal and trade name, city/state, main activity and opening date. Stable paging by CNPJ; total and next_page included. Source: Receita Federal monthly registry; MEI owners' CPFs masked. Signed answer (Ed25519 attestation), verifiable at /v1/verify.
输入模式
{
"type": "object",
"properties": {
"cnae": {
"description": "CNAE code or prefix: '6201-5/00', '6201500', '6201' (class) or '62' (division).",
"type": "string",
"maxLength": 12
},
"state": {
"description": "UF, e.g. 'SP'.",
"type": "string",
"minLength": 2,
"maxLength": 2
},
"city": {
"description": "Municipality name (accents and case ignored).",
"type": "string",
"maxLength": 80
},
"opened_after": {
"description": "Opened on or after (YYYY-MM-DD).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"opened_before": {
"description": "Opened on or before (YYYY-MM-DD).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"hq_only": {
"description": "Only headquarters (one row per company).",
"type": "boolean"
},
"page": {
"description": "Page of 100, default 1.",
"type": "integer",
"minimum": 1,
"maximum": 1000
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"filters": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"page": {
"type": "number"
},
"page_size": {
"type": "number"
},
"total": {
"type": "number"
},
"total_pages": {
"type": "number"
},
"next_page": {
"type": [
"number",
"null"
]
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cnpj": {
"type": "string"
},
"cnpj_formatted": {
"type": "string"
},
"legal_name": {
"type": "string"
},
"trade_name": {
"type": [
"string",
"null"
]
},
"registration_status": {
"type": "string"
},
"is_headquarters": {
"type": "boolean"
},
"city": {
"type": [
"string",
"null"
]
},
"state": {
"type": [
"string",
"null"
]
}
},
"required": [
"cnpj",
"cnpj_formatted",
"legal_name",
"trade_name",
"registration_status",
"is_headquarters",
"city",
"state"
],
"additionalProperties": {}
}
},
"reference_month": {
"type": "string"
},
"summary": {
"type": "object",
"properties": {
"en": {
"type": "string"
},
"pt": {
"type": "string"
}
},
"required": [
"en",
"pt"
],
"additionalProperties": false,
"description": "Short summary in English and Portuguese."
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"url": {
"type": "string"
},
"fetched_at": {
"type": "string"
}
},
"required": [
"name",
"url",
"fetched_at"
],
"additionalProperties": {}
}
},
"data_freshness": {
"type": "string"
},
"generated_at": {
"type": "string"
},
"cached": {
"type": "boolean"
},
"receipt": {
"type": "object",
"properties": {
"replay_token": {
"type": "string"
},
"replay_until": {
"type": "string"
}
},
"required": [
"replay_token",
"replay_until"
],
"additionalProperties": false,
"description": "Re-read this answer free for 10 minutes with br_replay."
},
"attestation": {
"type": "object",
"properties": {
"algorithm": {
"type": "string"
},
"key_id": {
"type": "string"
},
"sha256": {
"type": "string"
},
"signed_at": {
"type": "string"
},
"signature": {
"type": "string"
},
"verify_url": {
"type": "string"
}
},
"required": [
"algorithm",
"key_id",
"sha256",
"signed_at",
"signature",
"verify_url"
],
"additionalProperties": false,
"description": "Ed25519 signature of this answer; verify at verify_url or with the public key at /.well-known/kyb-attestation.json."
}
},
"required": [
"filters",
"page",
"page_size",
"total",
"total_pages",
"next_page",
"results",
"reference_month",
"summary",
"sources",
"data_freshness",
"generated_at",
"cached"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}社区
证据
最近观测
已验证未记录版本11 个工具
已验证未记录版本11 个工具