← 返回 Skills 市场
mcclawd

Vatgentic

作者 mcclawd · GitHub ↗ · v1.0.0 · MIT-0
linuxdarwinwin32 ⚠ suspicious
91
总下载
0
收藏
0
当前安装
5
版本数
在 OpenClaw 中安装
/install vatgentic
功能描述
Instant EU VAT validation with Lightning Bitcoin. 10 sats per lookup. No subscriptions.
安全使用建议
This skill generally does what it says (request a VAT check and return a Lightning invoice), but there are several inconsistencies and transparency gaps you should address before using it: - Do not provide auto-pay credentials (LNBOT_API_TOKEN / LNBOT_WALLET_ID) unless you fully trust the author and the endpoint. Auto-pay can move real funds. - The scripts require VATGENTIC_API_URL but the registry metadata did not declare it; SKILL.md suggests an unfamiliar host (https://fair-earwig.pikapod.net). Verify the canonical service URL (official vatgentic domain) and change VATGENTIC_API_URL to a known/trusted endpoint before using. - README mentions reading ~/.openclaw/secrets/lnbot-api.json and other workspace files, but the shipped scripts do not actually read that file. Confirm which files the skill will read in your environment and search the code for any hidden file reads before trusting it. - If you want to use auto-pay, inspect scripts (vatgentic-validate.py / vatgentic-request.py) yourself or run them in a sandbox to confirm they only send the VAT number and invoice/payment info to the configured API and do not exfiltrate other data. - Prefer manual payment (do not set auto-pay) during initial testing and run a few lookups with minimal amounts to confirm behavior and responses. Monitor network activity to ensure requests go to the expected host. - Ask the publisher for clarifications: authoritative homepage/docs, reason for the fair-earwig.pikapod.net host, and an updated SKILL.md/metadata that declares required env vars and file access. Given the mismatches (undeclared required env var, unknown endpoint, and documentation/code drift), treat this skill as suspicious until the above clarifications are provided or you confirm behavior in a sandbox.
功能分析
Type: OpenClaw Skill Name: vatgentic Version: 1.0.0 The VatGentic skill bundle provides a utility for EU VAT validation using Lightning Network (Bitcoin) micro-payments. The Python scripts (vatgentic-request.py, vatgentic-status.py, and vatgentic-validate.py) facilitate a workflow where a user requests a VAT check, receives a Lightning invoice, and polls for the result once paid. While the scripts handle sensitive environment variables like LNBOT_API_TOKEN for automated payments, this functionality is transparently documented and directly supports the stated purpose of the tool. No evidence of data exfiltration, unauthorized execution, or malicious prompt injection was found.
能力标签
cryptorequires-walletcan-make-purchasesrequires-sensitive-credentials
能力评估
Purpose & Capability
Name/description match the code: the Python scripts request a VAT lookup from a service URL and return Lightning invoices. Required binaries (python3, curl, jq) are plausible for the examples, though the Python scripts themselves use the requests library (curl/jq are used in SKILL.md examples). However, the package/registry metadata does not declare the VATGENTIC_API_URL environment variable that the scripts require at runtime — a metadata/instruction mismatch that can cause runtime failures and hides the actual external endpoint the skill will contact.
Instruction Scope
SKILL.md and scripts instruct the agent to POST VAT numbers and poll status at whatever VATGENTIC_API_URL is set. The Quick Start suggests VATGENTIC_API_URL='https://fair-earwig.pikapod.net' (a third-party host unrelated to the claimed vatgentic.com/docs), which is an unknown external endpoint — this is a material behavioral detail users must know. README also documents access to local workspace files and a secrets path (~/.openclaw/secrets/lnbot-api.json) but the included scripts do not actually read that path; that discrepancy suggests the documentation and code are out of sync. The scripts will send VAT numbers (and potentially invoice/payment requests) to the configured remote service — there are no instructions to read unrelated local files, but the skill does support optional auto-payment using provided ln.bot credentials.
Install Mechanism
No install spec — instruction-only with included Python scripts. Nothing is downloaded or extracted during install. This is lower-risk from an install-supply perspective, but included scripts are present on disk and will execute when used.
Credentials
The skill requires a service URL (VATGENTIC_API_URL) and optionally ln.bot credentials (LNBOT_API_TOKEN, LNBOT_WALLET_ID) for auto-pay. Those credentials are proportional to the advertised auto-pay feature. However: (1) the registry metadata did not declare VATGENTIC_API_URL as required, (2) the SKILL.md examples hard-code an unfamiliar host (fair-earwig.pikapod.net), and (3) README lists additional env vars and a local secret path which are not consistently used by the scripts. Missing/incorrect env metadata and undocumented endpoint choices reduce transparency and increase risk if users supply keys without understanding destination or behavior.
Persistence & Privilege
always is false and the skill does not request permanent platform privileges or modify other skills. However, because the skill supports automatic payments when LNBOT credentials are provided and agent invocation is allowed (default), an agent could perform real Lightning payments if given credentials and invoked autonomously. Combine that with the unknown external endpoint and you should be cautious about granting auto-pay credentials or enabling autonomous invocation for this skill.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install vatgentic
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /vatgentic 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial release of VatGentic – lightning-fast EU VAT validation with Bitcoin Lightning payments. - Validate EU VAT numbers instantly for just 10 sats per lookup. - No subscriptions or sign-ups; pay-per-use via the Lightning Network. - Returns validity, company name, address, and VAT number details. - Easy integration with API endpoints and Python code samples provided. - Works with all 27 EU member countries. - Requires Lightning Bitcoin, curl, jq, and Python 3.
v0.3.0
**Command-line interface overhaul and backend configuration update** - Introduced a new Python CLI entry point (`__main__.py`) for streamlined usage: `python3 -m vatgentic ...` - Added modular CLI scripts (`cli_request.py`) to support subcommands: `request`, `status`, and `validate` - Updated configuration: backend API endpoint now set via `VATGENTIC_API_URL` (was `VATGENTIC_N8N_URL`) - Simplified and focused documentation for faster setup and backend ownership clarity - Previous manual scripts (`vatgentic-request.py`, etc.) are now replaced/deprecated by unified CLI commands
v0.2.0
- Added comprehensive documentation in SKILL.md covering setup, usage, API, and troubleshooting. - Emphasized Lightning Network pay-per-use VAT validation; no signup or API keys required. - Provided clear installation and configuration steps for n8n integration and ln.bot wallet setup. - Documented example scripts and Python code for agent automation. - Included pricing information and privacy notes for transparency.
v0.1.1
vatgentic 0.1.1 - Clarified documentation to distinguish between user and instance owner setup steps. - Emphasized that end users require no configuration; all setup (n8n workflow, VAT API) is handled by the instance owner. - Cleaned up installation and configuration instructions for better clarity. - Small rewordings and reorganization for usability in README and SKILL.md.
v0.1.0
Initial release—introduces Lightning Network-powered, pay-per-use VAT validation for EU companies. - Validate EU VAT numbers instantly and retrieve company details (name, address, validity). - Simple pay-per-use model (10 sats/validation), no signup or API keys needed. - Designed for integration by AI agents, developers, and automation workflows. - Works with ln.bot wallet for Lightning payments and n8n for workflow automation. - Includes scripts and API endpoints for request initiation, payment status, and result retrieval.
元数据
Slug vatgentic
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 5
常见问题

Vatgentic 是什么?

Instant EU VAT validation with Lightning Bitcoin. 10 sats per lookup. No subscriptions. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 91 次。

如何安装 Vatgentic?

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

Vatgentic 是免费的吗?

是的,Vatgentic 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Vatgentic 支持哪些平台?

Vatgentic 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(linux, darwin, win32)。

谁开发了 Vatgentic?

由 mcclawd(@mcclawd)开发并维护,当前版本 v1.0.0。

💬 留言讨论