kyb-brasil
Brazilian KYB beyond registry checks: CGU sanctions, forced labour, PGFN, IBAMA, signed risk score
使うべきか
品質と安全性
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `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
}コミュニティ
エビデンス