Brazil CEP Geocoordinates, IBGE Code & Logistics Auditor (MCP Server + n8n Ready + REST API)

Batch geocodes and validates Brazilian 8-digit postal codes (CEPs) via BrasilAPI v2 & ViaCEP fallback. Extracts Latitude/Longitude, 7-digit IBGE city code (for NF-e/CT-e), state UF, neighborhood, and Last-Mile Delivery Scores (0-100).

Engineered by @b2b-quant-apis for scheduled Machine-to-Machine (n8n / Make.com) pipelines, Autonomous AI Agents (Claude Desktop, Cursor IDE, LangChain, CrewAI), and Enterprise Compliance & RevOps stacks.

---

Why Choose b2b-quant-apis/brazil-cep-geocoordinates-logistics-auditor?

1. Zero-Proxy & Zero-External-Key Architecture: Connects directly to official primary registries and public regulatory endpoints with deterministic input sanitization and automatic retry/backoff.
2. Quantitative Risk & Opportunity Scoring (0–100): Every output record includes a normalized quantitative score and an executive Markdown Dossier ready for RAG vector databases, Slack/Teams alerts, or CRM enrichment.
3. Native Model Context Protocol (MCP) Server: Connect directly to Claude Desktop, Cursor, Windsurf, or any MCP client in 1 click without deploying local infrastructure.
4. Predictable Pay-Per-Event Pricing: You only pay $0.01 USD per successfully processed record (cep-geo-audited). Zero monthly subscription fees.

---

Transparent Pay-Per-Event (PPE) Pricing

Billing Event Name	Event Title	Price per Event (USD)	Categories
cep-geo-audited	Brazil CEP Geocoordinates & IBGE City Code Audited	$0.01 USD	AI, ECOMMERCE, AUTOMATION

Negative Profit Protection: Failed queries, empty responses, or invalid inputs return cleanly without triggering event charges.

---

Input Parameters

Parameter	Type	Required	Default	Description
ceps	string	Yes	"01310100,20040002,30140071"	Comma-separated Brazilian postal codes (e.g., '01310100, 20040002, 30140071').
maxResults	integer	Optional	10	Maximum number of CEP records to return (1 to 100).

Example Input JSON

{
  "ceps": "01310100,20040002,30140071",
  "maxResults": 5
}

---

Output Dataset Schema

Each run pushes structured JSON items to the default Apify Dataset with the following fields:

Field Name	Type	Description
cep	string	CEP (8 Digits) — Standardized 8-digit Brazilian postal code.
stateUf	string	State UF — Two-letter Brazilian state code.
cityName	string	City / Municipality — Official municipality name.
neighborhood	string	Neighborhood / Bairro — District or neighborhood.
street	string	Street / Logradouro — Street address.
ibgeCityCode	string	IBGE 7-Digit City Code — Official 7-digit IBGE municipality code for NF-e/CT-e.
latitude	number	Latitude — WGS84 Latitude coordinate.
longitude	number	Longitude — WGS84 Longitude coordinate.
logisticsReadinessScore	integer	Logistics & NF-e Readiness Score (0-100) — Quantitative score for last-mile routing and tax invoice completeness (0-100).
markdownLogisticsDossier	string	Markdown Logistics & NF-e Dossier — Executive report for e-commerce, TMS/WMS, and ERP tax engines.

Example Output JSON

[
  {
    "cep": "Sample CEP (8 Digits)",
    "stateUf": "Sample State UF",
    "cityName": "Sample City / Municipality",
    "neighborhood": "Sample Neighborhood / Bairro",
    "street": "Sample Street / Logradouro",
    "ibgeCityCode": "Sample IBGE 7-Digit City Code",
    "latitude": 1500.5,
    "longitude": 1500.5,
    "logisticsReadinessScore": 92,
    "markdownLogisticsDossier": "Sample Markdown Logistics & NF-e Dossier"
  }
]

---

1-Click MCP Server Integration (Claude Desktop & Cursor IDE)

Add b2b-quant-apis/brazil-cep-geocoordinates-logistics-auditor as an AI Agent tool in Claude Desktop (claude_desktop_config.json) or Cursor IDE (.cursor/mcp.json):

{
  "mcpServers": {
    "brazil-cep-geocoordinates-logistics-auditor": {
      "command": "npx",
      "args": [
        "-y",
        "@apify/actors-mcp-server",
        "--actors",
        "b2b-quant-apis/brazil-cep-geocoordinates-logistics-auditor"
      ],
      "env": {
        "APIFY_TOKEN": "<YOUR_APIFY_API_TOKEN>"
      }
    }
  }
}

• Hosted Streamable HTTP MCP URL: https://mcp.apify.com/?actors=b2b-quant-apis/brazil-cep-geocoordinates-logistics-auditor

---

Automated Daily n8n Workflow Template

Download the pre-built, sanitized n8n workflow template with a daily Schedule Trigger (07:00 AM), HTTP Request node, and CRM/Slack Webhook Router:

• Direct Download (.n8n.json): brazil-cep-geocoordinates-logistics-auditor.n8n.json
• Enterprise Multi-Actor Super-Pipelines: GitHub Repository jesleytassili-glitch/b2b-quant-mcp-n8n-suite

---

Direct Stateless REST API Call (cURL Synchronous JSON)

Call this Actor synchronously as a standard HTTP POST micro-API and receive the JSON dataset array directly in the HTTP response:

curl -X POST "https://api.apify.com/v2/acts/b2b-quant-apis~brazil-cep-geocoordinates-logistics-auditor/run-sync-get-dataset-items" \
  -H "Authorization: Bearer <YOUR_APIFY_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"ceps": "01310100,20040002,30140071", "maxResults": 5}'

---

Frequently Asked Questions (FAQ)

1. Do I need to configure residential proxies or third-party API keys?

No. b2b-quant-apis/brazil-cep-geocoordinates-logistics-auditor runs out-of-the-box with zero external API keys and zero paid proxy requirements.

2. Can I chain this Actor with other B2B compliance and lead enrichment tools?

Yes. Explore the full 25-Actor B2B Quant & Regulatory Suite at apify.com/b2b-quant-apis or import our 5 Multi-Actor Waterfall Pipelines from GitHub (jesleytassili-glitch/b2b-quant-mcp-n8n-suite).