An automated utility to fetch detailed Brazilian address information from a postal code using the ViaCEP API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install cep-lookup
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install cep-lookup using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Brazilian CEP Lookup?
The Brazilian CEP Lookup skill allows AI agents to interface with the ViaCEP API to fetch comprehensive address details based on an 8-digit Brazilian postal code. By integrating this into Openclaw Skills, developers can provide their agents with the ability to instantly resolve locations without requiring manual searches or API keys. It is designed to be lightweight, efficient, and highly reliable for any application targeting the Brazilian market.
Brazilian CEP Lookup Use Cases
- Automating address entry in registration forms
- Validating shipping destinations for e-commerce and logistics
- Regionalizing content or services based on user-provided postal codes
- Enriching lead data within CRM systems for better geographical segmentation
How Brazilian CEP Lookup Works
- The AI agent identifies a CEP mention within a conversation or command string.
- The skill cleans the input to ensure a valid 8-digit string is sent to the endpoint.
- It executes a secure HTTP request to the ViaCEP database using axios.
- The skill captures the JSON response, including fields for street, neighborhood, city, and state acronyms.
- The agent presents the structured address data to the end user or passes it to another workflow step.
Brazilian CEP Lookup Setup
Ensure you have Node.js and npm available in your environment. To install the required HTTP client dependency for this skill, run the following command:
npm install axios
No further configuration or API keys are required as the service uses a public, non-authenticated endpoint.
Brazilian CEP Lookup Data Schema & Taxonomy
The skill returns a structured response based on the following data mapping:
| Attribute | Brazilian Data Key | Description |
|---|---|---|
| Street | logradouro | The name of the thoroughfare or street |
| Neighborhood | bairro | The district or neighborhood name |
| City | localidade | The name of the municipality |
| State | uf | The two-letter state acronym |
| Complement | complemento | Additional address info like apartment or building numbers |
Brazilian CEP Lookup Advanced Features
- Intelligent input sanitization that handles both hyphenated and plain numeric formats
- High-speed data retrieval optimized for Openclaw Skills agents
- Robust error handling for invalid formats, missing codes, or network timeouts
- Zero-config deployment with no external authentication management required
SKILL.md
Loading
Related Openclaw Skills
Polymarket Weather Trader
An automated trading agent for Polymarket weather markets using NOAA forecasts and EV-based Kelly sizing.
Clawder: Production-Grade AI Coding Agent
Clawder is a high-performance AI coding agent skill that implements rigorous JT directives to ensure production-ready code through mandatory verification and autonomous swarming.
BimDown AI Architectural Modeling
A powerful bridge between AI agents and architectural modeling that enables reading and writing BIM data via Openclaw Skills.
Humanizer Academic English
A specialized academic editing skill designed to detect and remove AI-generated writing traces while preserving scholarly rigor and authorial voice.
BimDown
An AI-native bridge for reading and creating Building Information Models (BIM) through code-like CSV and SVG files.
CityBikes (Pipeworx)
A real-time data integration for global bike-sharing networks including Citi Bike, Velib, and Nextbike.
Featured*
