← 返回 Skills 市场
runawaydevil

Cnpj Lookup

作者 runawaydevil · GitHub ↗ · v1.0.0
cross-platform ✓ 安全检测通过
317
总下载
1
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install cnpj-lookup
功能描述
Consulta CNPJ via APIs públicas brasileiras (BrasilAPI, CNPJ.ws, OpenCNPJ) com fallback automático, cache e rate limit. Ativar quando o usuário pedir consult...
使用说明 (SKILL.md)

CNPJ Lookup 🔍

Consulta empresas brasileiras via CNPJ usando APIs públicas com fallback automático.

Início Rápido

"Consultar CNPJ 12.345.678/0001-95"
"Pesquisar empresa pelo CNPJ 19131243000197"
"Me diga razão social, situação cadastral, CNAE principal, endereço e QSA"
"Detalhe do CNPJ 19131243000197 em JSON"

Workflows

Workflow 1: Consulta Simples (Resumo)

O usuário pede apenas informações básicas:

  • Razão social
  • Nome fantasia
  • Situação cadastral
  • Endereço resumido

Prompt típico: "consultar cnpj 19131243000197"

Workflow 2: Consulta Completa (Detalhes + QSA)

O usuário pede informações detalhadas incluindo:

  • CNAE principal e secundários
  • Quadro de Sócios e Administradores (QSA)
  • Contato (email, telefone)
  • Capital social

Prompt típico: "consulta completa do CNPJ 19131243000197" ou "detalhes QSA"

Workflow 3: Exportar JSON

O usuário quer dados estruturados para integração:

  • Retorna JSON com schema normalizado
  • Inclui metadados (fonte, cache, timestamp)

Prompt típico: "cnpj 19131243000197 json" ou "exportar dados CNPJ"

Como Funciona

  1. Validação: CNPJ é sanitizado (só dígitos) e verifica dígitos verificadores
  2. Cache: Consulta anterior retorna dados em cache (TTL: 24h)
  3. Fallback em cascata:
    • BrasilAPI → CNPJ.ws → OpenCNPJ
  4. Rate Limit: Respeita limites de cada provider (30/2/30 req/min)
  5. Normalização: Output padronizado independente do provider

Execução via Script

# Consulta completa (já vem com detalhes por padrão: QSA, CNAEs, etc)
python3 scripts/cnpj_lookup.py 19131243000197

# Consulta com JSON
python3 scripts/cnpj_lookup.py 19131243000197 --json

# Forçar provider específico
python3 scripts/cnpj_lookup.py 19131243000197 --provider brasilapi

# Ignorar cache
python3 scripts/cnpj_lookup.py 19131243000197 --no-cache

# TTL customizado (em segundos)
python3 scripts/cnpj_lookup.py 19131243000197 --ttl 3600

# Consulta simples (apenas基本信息)
python3 scripts/cnpj_lookup.py 19131243000197 --detailed False

Referências

  • Provedores - Endpoints, limites e comportamento de rate limit
  • Campos - Schema normalizado e divergências entre provedores

Aviso

Dados para consulta/enriquecimento; não substitui documento oficial.

安全使用建议
This skill appears internally consistent and matches its description: it makes outbound HTTP requests to public Brazilian CNPJ APIs and caches responses in a local .cache directory. It does not request credentials or perform unexpected actions. Consider: (1) cached data is written to disk under the skill folder — if you run in a shared environment, verify you are comfortable with those files; (2) the skill makes network calls to third-party public APIs (which is required for its function) — if you must restrict network access, block or review those endpoints first; (3) the TTL can be changed with the CNPJ_LOOKUP_TTL_SECONDS environment variable if you wish to control caching. If you want higher assurance, inspect the full scripts/cnpj_lookup.py file (it uses only Python standard library modules).
功能分析
Type: OpenClaw Skill Name: cnpj-lookup Version: 1.0.0 The OpenClaw AgentSkills skill bundle for CNPJ lookup is benign. The `scripts/cnpj_lookup.py` script correctly implements its stated purpose of querying public CNPJ APIs, handling caching, rate limiting, and data normalization. There is no evidence of data exfiltration, malicious execution (e.g., `os.system`, `eval` on untrusted input), persistence mechanisms, or obfuscation. The `SKILL.md` and `README.md` files contain only legitimate instructions for the agent and user, with no attempts at prompt injection to manipulate the agent into unauthorized actions. The use of `urllib.request` and `json.loads` for network communication and data parsing is standard and secure within this context.
能力评估
✓ Purpose & Capability
Name and description match the contained code and SKILL.md: the script queries BrasilAPI, CNPJ.ws, and OpenCNPJ with fallback, normalization, caching and simple rate limiting. No unrelated services, binaries, or credentials are requested.
✓ Instruction Scope
SKILL.md instructs the agent to validate CNPJ, use cache, call public provider endpoints, apply fallback and rate limiting, and return normalized JSON or markdown. The instructions do not ask the agent to read unrelated files, exfiltrate data, or contact endpoints outside the documented providers.
✓ Install Mechanism
There is no install spec (instruction-only + included Python script). The bundled Python script uses only standard library modules (urllib, json, pathlib, etc.), so no third-party install or remote code download is required.
✓ Credentials
The skill does not require credentials or configuration paths. It optionally reads one environment variable (CNPJ_LOOKUP_TTL_SECONDS) to override cache TTL; this is proportional to caching behavior and not sensitive. No SECRET/TOKEN/PASSWORD env vars are requested.
ℹ Persistence & Privilege
The script writes cache files under a local .cache directory inside the skill base path; this is expected for caching but means it will create files on disk. always is false and the skill does not modify other skills or global agent settings.
如何使用
  1. 确保已安装 OpenClaw（本地或 Docker 部署）
  2. 在对话框中输入安装命令：/install cnpj-lookup
  3. 安装完成后，直接呼叫该 Skill 的名称或使用 /cnpj-lookup 触发
  4. 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
- Primeira versão estável do cnpj-lookup para consulta de empresas brasileiras via CNPJ. - Integração automática com BrasilAPI, CNPJ.ws e OpenCNPJ com fallback inteligente, cache e rate limit. - Suporte a três workflows: consulta simples, consulta completa (com QSA, CNAE, etc.) e exportação em JSON. - Utilização de cache com TTL configurável e validação automática do CNPJ. - Outputs normalizados para fácil integração e resultados consistentes.
元数据
Slug cnpj-lookup
版本 1.0.0
许可证 —
累计安装 0
当前安装数 0
历史版本数 1
常见问题

Cnpj Lookup 是什么？

Consulta CNPJ via APIs públicas brasileiras (BrasilAPI, CNPJ.ws, OpenCNPJ) com fallback automático, cache e rate limit. Ativar quando o usuário pedir consult... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 317 次。

如何安装 Cnpj Lookup？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install cnpj-lookup」即可一键安装，无需额外配置。

Cnpj Lookup 是免费的吗？

是的，Cnpj Lookup 完全免费（开源免费），可自由下载、安装和使用。

Cnpj Lookup 支持哪些平台？

Cnpj Lookup 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Cnpj Lookup？

由 runawaydevil（@runawaydevil）开发并维护，当前版本 v1.0.0。

推荐 Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463556 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259610 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200551 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191226 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190235 · by oswalpalash

💬 留言讨论