mcpField
G
gen-paylink-govilo

gen-paylink-govilo

github.com/hau823823Other13.0k installsUpdated 37w ago
Repository

About gen-paylink-govilo

gen-paylink-govilo is a skill that uses a CLI to package files and create Govilo paid unlock links. It is for publishing digital products with USDC pricing and returns an unlock URL.

Key features

  1. 01Package files, folders, or ZIPs
  2. 02Set product title and USDC price
  3. 03Upload packages to Govilo
  4. 04Return a paid unlock URL
  5. 05Accept an optional description

Use cases

  1. 01Sell a collection of files
  2. 02Turn a folder into a paid download
  3. 03Publish a ZIP with a USDC price

Install

Copy the command and run it in a terminal.

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

After installing, type/gen-paylink-goviloin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with 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

Details

From the project README

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?
  2. price — How much to charge (in USDC)?
  3. 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.

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

ParamRequiredSourceDescription
--inputYesCLI (repeatable)ZIP, folder, or file paths
--titleYesCLIProduct title
--priceYesCLIPrice in USDC
--addressNoCLI > SELLER_ADDRESS envSeller EVM wallet
--descriptionNoCLIProduct description

Workflow

  1. Validate config (API Key + seller address)
  2. Package inputs → ZIP (if not already ZIP)
  3. POST /api/v1/bot/uploads/presign → get upload_url + session_id
  4. PUT upload_url → upload ZIP to R2
  5. 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:

VariableRequiredDescription
GOVILO_API_KEYYesBot API key from govilo.xyz
SELLER_ADDRESSYes*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.

Comments

Markdown supported