Affonso - Affiliate Marketing Software
by @zilvestro
Manage affiliate marketing programs via the Affonso CLI — create affiliates, track referrals, handle commissions, process payouts, and configure program sett...
clawhub install affonso📖 About This Skill
name: affonso description: "Manage affiliate marketing programs via the Affonso CLI — create affiliates, track referrals, handle commissions, process payouts, and configure program settings. Use when the user asks about affiliate management, referral tracking, commission handling, or payout processing." version: 1.0.0 homepage: "https://affonso.io" metadata: openclaw: requires: env: - AFFONSO_API_KEY bins: - affonso install: - package: "@affonso/cli" manager: node
Affonso CLI Skill
Manage affiliate marketing programs from the command line.
Authentication
Use the AFFONSO_API_KEY environment variable. Verify with:
affonso whoami --json
affonso login — it requires a browser and won't work in headless environments.Rules
--json on every command — without it, the CLI outputs ANSI tables that can't be parsed.--starting-after, --ending-before); all other resources use page-based (--page, --limit).Commands
| Command | Description |
|---------|-------------|
| affiliates | List, get, create, update, delete affiliates |
| referrals | List, get, create, update, delete referrals (cursor-based pagination) |
| commissions | List, get, create, update, delete commissions |
| payouts | List, get, update payouts (no create/delete) |
| coupons | List, get, create, delete coupons (no update) |
| clicks | Create click events with UTM and sub-tracking |
| embed-tokens | Create embed tokens for partner portals |
| program | Get/update program settings + 8 sub-resources |
| marketplace | Browse/search public programs (no auth required) |
| config | Get/set CLI config (api-key, base-url) |
| whoami | Show authentication status |
For full command details and options, see references/COMMAND_REFERENCE.md. For program sub-resources (payment-terms, tracking, restrictions, fraud-rules, portal, notifications, groups, creatives), see references/PROGRAM_SETTINGS_GUIDE.md.
Quick Start
1. Verify auth: affonso whoami --json
2. List resources: affonso affiliates list --json --limit 5
3. Take action: approve, create, update, or configure as needed
For multi-step workflow recipes, see references/WORKFLOWS.md.
💡 Examples
1. Verify auth: affonso whoami --json
2. List resources: affonso affiliates list --json --limit 5
3. Take action: approve, create, update, or configure as needed
For multi-step workflow recipes, see references/WORKFLOWS.md.
🔒 Constraints
--json on every command — without it, the CLI outputs ANSI tables that can't be parsed.--starting-after, --ending-before); all other resources use page-based (--page, --limit).