gen-paylink-govilo

Name: gen-paylink-govilo
Author: hau823823

Package files into paid unlock links on Govilo with a single command. Accepts ZIP files, folders, or individual files as input; non-ZIP inputs are automatically packaged into a ZIP (max 20 MB, 20 files per package) Handles the full Govilo Bot API workflow: presign upload URL, upload to R2 storage, and create monetized item with unlock link Requires GOVILO_API_KEY and SELLER_ADDRESS environment variables; seller address can also be passed via CLI parameter Returns JSON output with unlock URL on success; always prompt user for product title, price (USDC), and optional description before execution

INSTALLATION

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

Run in your project or agent environment. Adjust flags if your CLI version differs.

SKILL.md

$2a

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"

If no .env.govilo exists, create one before running:

GOVILO_API_KEY=sk_live_xxx

SELLER_ADDRESS=0x...

--input 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

--input

Yes

CLI (repeatable)

ZIP, folder, or file paths

--title

Yes

CLI

Product title

--price

Yes

CLI

Price in USDC

--address

CLI > SELLER_ADDRESS env

Seller EVM wallet

--description

CLI

Product description

Workflow

Validate config (API Key + seller address)

Package inputs → ZIP (if not already ZIP)

POST /api/v1/bot/uploads/presign → get upload_url + session_id

PUT upload_url → upload ZIP to R2

POST /api/v1/bot/items → get unlock_url

File Limits

Max ZIP size: 20 MB

Max files in ZIP: 20

Setup

Two values are required:

Variable

Required

Description

GOVILO_API_KEY

Yes

Bot API key from govilo.xyz

SELLER_ADDRESS

Yes*

EVM wallet address on Base chain

*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.