Govilo To Go
Turn any file into a paid unlock link — one command to package, upload, and collect crypto payments. The last mile of automation: from creation to monetization.
Before Running
Always ask the user for these values before executing the CLI — never guess or use placeholders:
- 1. title — What is the product name?
- price — How much to charge (in USDC)?
- description — Short description of the product (optional, but always ask)
CLI Command
Requires uv. See references/setup-guide.md for install instructions.
Run from this skill's base directory. Use a dedicated env file containing only GOVILO_API_KEY (and optionally SELLER_ADDRESS). Never point --env-file at a project .env that contains unrelated secrets.
CODEBLOCK0
If no .env.govilo exists, create one before running:
CODEBLOCK1
INLINECODE5 accepts ZIP file, folder, or individual files (repeatable). Non-ZIP inputs are auto-packaged.
All output is JSON {"ok": true/false, ...} with exit code 1 on failure.
Parameters
| Param | Required | Source | Description |
|---|
| INLINECODE7 | Yes | CLI (repeatable) | ZIP, folder, or file paths |
| INLINECODE8 |
Yes | CLI | Product title |
|
--price | Yes | CLI | Price in USDC |
|
--address | No | CLI >
SELLER_ADDRESS env | Seller EVM wallet |
|
--description | No | CLI | Product description |
Workflow
- 1. Validate config (API Key + seller address)
- Package inputs → ZIP (if not already ZIP)
- INLINECODE13 → get uploadurl + sessionid
- INLINECODE14 → upload ZIP to R2
- INLINECODE15 → get unlock_url
File Limits
- - Max ZIP size: 20 MB
- Max files in ZIP: 20
Setup
Two values are required:
| Variable | Required | Description |
|---|
| INLINECODE16 | Yes | Bot API key from [govilo.xyz][] |
| INLINECODE17 |
Yes* | EVM wallet address on
Base chain |
[govilo.xyz]: https://govilo.xyz/
*SELLER_ADDRESS can also be passed via --address CLI parameter.
See references/setup-guide.md for step-by-step registration and wallet setup instructions.
API Reference
See references/bot-api-quick-ref.md for Bot API endpoints and error codes.
Govilo To Go
将任意文件转换为付费解锁链接——一个命令即可完成打包、上传和收取加密货币付款。自动化的最后一公里：从创作到变现。
运行前
在执行CLI之前，务必向用户询问以下值——切勿猜测或使用占位符：
- 1. title — 产品名称是什么？
- price — 收费金额（以USDC计）？
- description — 产品简短描述（可选，但务必询问）
CLI命令
需要 uv。安装说明请参见 references/setup-guide.md。
从本技能的基础目录运行。使用一个专用的环境文件，仅包含 GOVILOAPIKEY（以及可选的 SELLER_ADDRESS）。切勿将 --env-file 指向包含无关密钥的项目 .env 文件。
bash
cd <技能基础目录>
uv run --env-file <路径>/.env.govilo create-link \
--input <路径> \
--title 产品名称 \
--price 5.00 \
--address 0x... \
--description 可选描述
如果 .env.govilo 不存在，请在运行前创建：
dotenv
GOVILOAPIKEY=sklivexxx
SELLER_ADDRESS=0x...
--input 接受ZIP文件、文件夹或单个文件（可重复）。非ZIP输入将自动打包。
所有输出均为JSON格式 {ok: true/false, ...}，失败时退出码为1。
参数
| 参数 | 必填 | 来源 | 描述 |
|---|
| --input | 是 | CLI（可重复） | ZIP、文件夹或文件路径 |
| --title |
是 | CLI | 产品标题 |
| --price | 是 | CLI | USDC价格 |
| --address | 否 | CLI > SELLER_ADDRESS 环境变量 | 卖家EVM钱包地址 |
| --description | 否 | CLI | 产品描述 |
工作流程
- 1. 验证配置（API密钥 + 卖家地址）
- 打包输入 → ZIP（如果尚未是ZIP格式）
- POST /api/v1/bot/uploads/presign → 获取 uploadurl + sessionid
- PUT uploadurl → 将ZIP上传至R2
- POST /api/v1/bot/items → 获取 unlockurl
文件限制
- - 最大ZIP大小：20 MB
- ZIP内最大文件数：20
设置
需要两个值：
| 变量 | 必填 | 描述 |
|---|
| GOVILOAPIKEY | 是 | 来自 [govilo.xyz][] 的机器人API密钥 |
| SELLER_ADDRESS |
是* |
Base链上的EVM钱包地址 |
[govilo.xyz]: https://govilo.xyz/
*SELLER_ADDRESS 也可以通过 --address CLI参数传递。
注册和钱包设置的分步说明请参见 references/setup-guide.md。
API参考
机器人API端点和错误码请参见 references/bot-api-quick-ref.md。
