← 返回 Skills 市场
Emissor de Nota Fiscal Paulistana
作者
Blackcoffee111
· GitHub ↗
· v1.0.0
· MIT-0
363
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install nota-fiscal-paulistana
功能描述
Faturamento NFS-e SP (Emissão e Cancelamento de Notas Fiscais em São Paulo)
安全使用建议
This package appears to implement the advertised São Paulo NFS-e flows, but review these points before installing or using it with real certificates: 1) The code expects a municipal certificate (.p12) and the NFSE_CERT_PASSWORD env var, but the skill metadata does not declare those — expect to provide a certificate file and a password. 2) SKILL.md instructs the agent to create/modify files (config.json, .env, tomadores.json, contador_rps.txt). If you don't want the agent writing files, do not allow the automated wizard; instead configure files manually. 3) The README advises putting the certificate password into a plaintext .env file — store secrets securely (restrict file permissions, or use a secrets manager) and remove the .env from backups/version control. 4) The SKILL.md references env.example which is not included; verify the setup steps and supply your own .env if needed. 5) The scripts create temp PEM files and write debug/response XML to disk — audit those files for sensitive content and ensure temporary files are removed and access-restricted. 6) Verify dependencies (requests, lxml, signxml, cryptography, python-dotenv) are installed in a controlled environment. Recommended safe steps: test in an isolated environment with a revoked/test certificate; inspect the code yourself (or with a developer) before adding a production certificate; restrict file permissions on the certificate and .env; and avoid letting the agent perform automatic writes if you prefer manual control. If you want, provide me with specific lines or behaviors to inspect further (e.g., confirm absence of external, unexpected network endpoints or detect any code paths that upload files to non-official hosts).
功能分析
Type: OpenClaw Skill
Name: nota-fiscal-paulistana
Version: 1.0.0
The skill bundle is a legitimate tool designed for managing São Paulo municipal service invoices (NFS-e). It contains Python scripts (emitir_nfse.py, baixar_notas.py, etc.) that interact with the official government API (nfews.prefeitura.sp.gov.br) using standard SOAP and XMLDSig protocols. The SKILL.md instructions implement a user-friendly 'Wizard' for initial setup, which correctly emphasizes security by directing the user to store sensitive certificate passwords in a local .env file rather than sharing them in the chat. No evidence of data exfiltration, malicious execution, or harmful prompt injection was found; the inclusion of ISSSaoPaulo.txt appears to be a non-executable reference to the ACBr open-source library.
能力评估
Purpose & Capability
The code and SKILL.md implement São Paulo NFS-e operations (issue, cancel, download) and call official prefeitura endpoints — this matches the name/description. However the registry metadata declares no required env vars or config paths while the code and docs clearly expect a certificate file (a .p12) and the NFSE_CERT_PASSWORD environment variable / .env file. Also SKILL.md references an env.example template that is not present in the file manifest. These mismatches are disproportionate to the stated metadata and may lead to unexpected behavior.
Instruction Scope
SKILL.md instructs the agent to read and write workspace files (config.json, tomadores.json, contador_rps.txt), create/rename a hidden .env, and autonomously populate config.json after an interactive wizard. Asking the agent to create hidden files and write configuration and to instruct the user how to paste secret passwords into .env is within the functional scope of setup, but grants the agent broad filesystem-write actions and handling of secrets — more scope than what the registry metadata declares and something users should explicitly consent to.
Install Mechanism
This is an instruction-and-code bundle with no install spec (lowest installation risk). The Python scripts require third-party libraries (requests, signxml, cryptography, lxml, python-dotenv) but the package makes no installation or dependency instructions in the registry metadata — the absence of an install spec is plausible but incomplete; the user must ensure the runtime has the required packages.
Credentials
The skill requests/uses sensitive artefacts: a municipal certificate file (.p12) and the NFSE_CERT_PASSWORD environment variable (read via dotenv and os.environ). Yet the registry metadata lists no required environment variables or config paths. Storing the password in a plaintext .env file (as instructed) is insecure unless file permissions are hardened. The number and sensitivity of required secrets are proportionate to the functionality, but the missing declarations and the plaintext .env guidance are concerning.
Persistence & Privilege
always is false and the skill is user-invocable; autonomous invocation is allowed and used by the SKILL.md (e.g., the wizard that writes config.json). The skill modifies files within its own workspace (normal) and creates temporary PEM files when making TLS client-authenticated requests (expected). This is acceptable for the purpose but the combination of autonomous file writes + secret handling + invoking other skills (e.g., the 'GOG' e-mail skill) increases the blast radius and should be considered by the user.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install nota-fiscal-paulistana - 安装完成后,直接呼叫该 Skill 的名称或使用
/nota-fiscal-paulistana触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Lançamento Oficial v1.0.0: Módulo completo de faturamento financeiro para a cidade de São Paulo. Inclui assistente de instalação (Auto-Wizard interativo), emissor, cancelamento autônomo via API e motor de paginação inteligente de relatórios contábeis para fechamento do mês.
元数据
常见问题
Emissor de Nota Fiscal Paulistana 是什么?
Faturamento NFS-e SP (Emissão e Cancelamento de Notas Fiscais em São Paulo). 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 363 次。
如何安装 Emissor de Nota Fiscal Paulistana?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install nota-fiscal-paulistana」即可一键安装,无需额外配置。
Emissor de Nota Fiscal Paulistana 是免费的吗?
是的,Emissor de Nota Fiscal Paulistana 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Emissor de Nota Fiscal Paulistana 支持哪些平台?
Emissor de Nota Fiscal Paulistana 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Emissor de Nota Fiscal Paulistana?
由 Blackcoffee111(@blackcoffee111)开发并维护,当前版本 v1.0.0。
推荐 Skills