mcpField
G
gen-paylink-govilo

gen-paylink-govilo

github.com/hau823823其他13.0k 次安装37 周前更新
代码仓库

关于 gen-paylink-govilo

gen-paylink-govilo 是通过 CLI 打包文件并创建 Govilo 付费解锁链接的技能，适用于以 USDC 定价发布数字产品，并返回解锁 URL。

主要功能

  1. 01打包文件、文件夹或 ZIP
  2. 02设置产品名称和 USDC 价格
  3. 03向 Govilo 上传文件包
  4. 04生成付费解锁 URL
  5. 05可选添加产品描述

适用场景

  1. 01出售一组文件
  2. 02将文件夹制作为付费下载
  3. 03以 USDC 价格发布 ZIP

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/hau823823/gen-paylink-govilo --skill gen-paylink-govilo

安装后在 Claude Code 中输入/gen-paylink-govilo确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

pyproject.toml
references/
bot-api-quick-ref.md
setup-guide.md
scripts/
__init__.py
api_client.py
config.py
packager.py
workflow_create.py

详细介绍

Govilo To Go

将任意文件变成付费解锁链接——只需一条命令，即可打包、上传并收取加密货币付款。自动化的最后一公里：从创建到变现。

运行前

执行 CLI 前，务必向用户询问以下信息——切勿猜测或使用占位符：

  1. title — 产品名称是什么？
  2. price — 收取多少费用（以 USDC 计价）？
  3. description — 产品简介（可选，但务必询问）

CLI 命令

需要 uv。安装说明请参阅 references/setup-guide.md。

请在此技能的基础目录中运行。使用只包含 GOVILO_API_KEY（以及可选的 SELLER_ADDRESS）的专用环境文件。切勿将 --env-file 指向包含无关机密信息的项目 .env 文件。

cd <skill_base_directory>
uv run --env-file <path_to>/.env.govilo create-link \
  --input <path>         \
  --title "Product Name" \
  --price "5.00"         \
  --address "0x..."      \
  --description "optional"

如果不存在 .env.govilo，请在运行前创建：

GOVILO_API_KEY=sk_live_xxx
SELLER_ADDRESS=0x...

--input 接受 ZIP 文件、文件夹或单个文件（可重复指定）。非 ZIP 输入会自动打包。

所有输出均为 JSON {"ok": true/false, ...}；失败时退出码为 1。

参数

参数必填来源说明
--input是CLI（可重复指定）ZIP、文件夹或文件路径
--title是CLI产品名称
--price是CLI以 USDC 计价的价格
--address否CLI > SELLER_ADDRESS env卖家 EVM 钱包
--description否CLI产品简介

工作流

  1. 验证配置（API 密钥和卖家地址）
  2. 将输入打包为 ZIP（如果尚未是 ZIP）
  3. POST /api/v1/bot/uploads/presign → 获取 upload_url + session_id
  4. PUT upload_url → 将 ZIP 上传到 R2
  5. POST /api/v1/bot/items → 获取 unlock_url

文件限制

  • ZIP 最大大小：20 MB
  • ZIP 中文件数上限：20

设置

需要以下两个值：

变量必填说明
GOVILO_API_KEY是来自 govilo.xyz 的 Bot API 密钥
SELLER_ADDRESS是*Base chain 上的 EVM 钱包地址

*也可以通过 CLI 参数 --address 传入 SELLER_ADDRESS。

注册和钱包设置的分步说明请参阅 references/setup-guide.md。

API 参考

Bot API 端点和错误代码请参阅 references/bot-api-quick-ref.md。

评论

支持 Markdown