← Back to Skills Marketplace
Brazilian CEP using the ViaCEP API
by
guilherme-funchal
· GitHub ↗
· v1.0.0
· MIT-0
92
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install cep-lookup
Description
Looks up address data for a Brazilian CEP using the ViaCEP API.
README (SKILL.md)
CEP Lookup
Looks up the full address for a Brazilian postal code (CEP) using the public ViaCEP API. No authentication required.
Triggers
Use this skill when the user mentions a CEP in any of these formats:
cep 01001-000CEP 20040020details for CEP 30140-110
Output
The skill returns:
- Street (logradouro)
- Neighborhood (bairro)
- City (localidade)
- State (UF)
- Complement, if available (complemento)
Error handling
- Invalid CEP format → usage instruction
- CEP not found in ViaCEP database → informative message
- Network failure → generic error message
Usage Guidance
This skill appears to do exactly what it says: it needs node/npm and the axios npm dependency to make outgoing HTTPS requests to the public ViaCEP API. Before installing, note: (1) installation will run npm install which downloads packages from the public registry; review package.json if you want to vet dependencies. (2) When invoked the skill will send the CEP (postal code) to viacep.com.br — if CEPs you send are considered private in your context, avoid sharing them. (3) The SKILL.md metadata has a small mismatch (it lists axios as a binary), but that is harmless. If you want extra assurance, run the included tests in mock mode (node test.js --mock) to verify local behavior without network calls.
Capability Analysis
Type: OpenClaw Skill
Name: cep-lookup
Version: 1.0.0
The skill is a legitimate tool for looking up Brazilian postal codes (CEP) using the public ViaCEP API. The code in index.js and test.js is straightforward, well-documented, and contains no signs of data exfiltration, malicious execution, or prompt injection.
Capability Assessment
Purpose & Capability
Name/description match the implementation: index.js calls the ViaCEP public API and returns address fields. Declared runtime (node + npm) and the dependency on axios are reasonable for an HTTP-based lookup.
Instruction Scope
SKILL.md limits behavior to CEP lookups, describes triggers and outputs, and does not instruct reading unrelated files or environment variables. The runtime code only reads the incoming message text and performs an HTTP GET to viacep.com.br.
Install Mechanism
This is effectively an instruction-only skill but includes code and package.json; installation is via npm (axios dependency). The SKILL.md 'install' block suggests installing axios via an npm installer entry and lists a 'bins' field for axios (axios is a library, not a CLI binary) — this is a minor metadata inconsistency but not a security concern. No downloads from untrusted URLs or archive extraction are present.
Credentials
No environment variables, credentials, or config paths are requested. The code does not access process.env or other secrets. The test runner monkeypatches module loading in local test mode only and does not introduce secret access.
Persistence & Privilege
Skill does not request always:true and does not modify other skills or system-wide configuration. It uses normal autonomous invocation defaults; this is expected for a user-invocable lookup skill.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install cep-lookup - After installation, invoke the skill by name or use
/cep-lookup - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of cep-lookup skill.
- Fetches Brazilian address data by CEP using the ViaCEP API.
- Returns street, neighborhood, city, state, and complement when available.
- Handles invalid CEP formats, not found errors, and network issues with clear messages.
- Requires Node.js, npm, and the axios library for HTTP requests.
Metadata
Frequently Asked Questions
What is Brazilian CEP using the ViaCEP API?
Looks up address data for a Brazilian CEP using the ViaCEP API. It is an AI Agent Skill for Claude Code / OpenClaw, with 92 downloads so far.
How do I install Brazilian CEP using the ViaCEP API?
Run "/install cep-lookup" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Brazilian CEP using the ViaCEP API free?
Yes, Brazilian CEP using the ViaCEP API is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Brazilian CEP using the ViaCEP API support?
Brazilian CEP using the ViaCEP API is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Brazilian CEP using the ViaCEP API?
It is built and maintained by guilherme-funchal (@guilherme-funchal); the current version is v1.0.0.
More Skills