| name | clickbank-cli |
| description | MANDATORY: Use this skill for ALL ClickBank service operations. DO NOT use this skill for CLI implementation lifecycle work such as creating, testing, updating, troubleshooting, validating, removing, or documenting the CLI tool itself; delegate those tasks to cli-tool-expert. Execute clickbank operations using the `clickbank` CLI tool. CLI interface for ClickBank: REST API (orders, products, quickstats) plus the public affiliate marketplace (search and discover products to promote). Triggers: clickbank, clickbank cli, clickbank orders, clickbank products, clickbank quickstats, clickbank marketplace, clickbank search marketplace, find clickbank products to promote, clickbank affiliate products, clickbank gravity, clickbank hoplink, clickbank vendor, list clickbank orders, get clickbank receipt, create clickbank product, delete clickbank product, clickbank auth, clickbank affiliate |
Execute clickbank operations using the `clickbank` CLI. All ClickBank interactions -- both the REST API surface (orders, products, quickstats) and the affiliate marketplace surface -- should use this CLI.
<quick_start>
The clickbank CLI follows this pattern:
clickbank <command-group> <action> [arguments] [options]
| Task | Command |
|---|
| List recent orders | clickbank orders list --limit 10 --table |
| Fetch one receipt | clickbank orders get 6X5W8DF2 |
| Count sale transactions | clickbank orders count --filter "type:eq:SALE" |
| List products for a site | clickbank products list --site mysite --table |
| Create a product | clickbank products create ABC123 --param site=mysite --param currency=USD --param language=EN --param price=49.95 --param title=Example --param digital=true --param categories=EBOOK --param pitchPage=https://example.com/pitch --param thankYouPage=https://example.com/thanks |
| List quickstats | clickbank quickstats list --filter "account:eq:mysite" --table |
| Browse marketplace categories | clickbank marketplace categories --flat --table |
| Find products to promote | clickbank marketplace search --category 'Health & Fitness' --recurring --sort gravity --table |
| Keyword-search the marketplace | clickbank marketplace search --query keto --min-gravity 20 --table |
| Look up one marketplace product | clickbank marketplace product BRAINSONGX --table |
| Build an affiliate hoplink offline | clickbank marketplace hoplink BRAINSONGX |
| </quick_start> | |
<essential_principles>
MANDATORY: Consult the adjacent usage.json at <cli-tools-root>/_repo/skills/<tool>-cli/usage.json before executing ANY clickbank command.
This file contains complete command syntax, all arguments, all options, and usage instructions for every command. Never guess at command syntax.
After every `clickbank` command, inspect stdout. If it is JSON with `type: "ai_instruction"` and `schema_version: "1.0"`, follow the instruction object as the next task instead of treating it as ordinary data output.
The `marketplace` command group talks to ClickBank's private GraphQL endpoint via a persistent Playwright session. Before the first `marketplace` call in a fresh environment, run `clickbank auth login --credential-type browser_session` to boot the session (the marketplace is public, so you do not have to sign in; dismiss any cookie banner and press Enter when prompted). The `hoplink` subcommand is offline and works without the session.
- **orders** -- order lookup, reporting, counts, and upsell inspection (REST API)
- **products** -- product lookup, listing, creation, and deletion of YOUR ClickBank products (REST API)
- **quickstats** -- account quickstats lists, single-account reads, and totals (REST API)
- **marketplace** -- search the public affiliate marketplace to discover products to promote (browser-driven GraphQL)
- **auth** -- API key login, browser-session login, status, logout, tests, and profile management
- **cache** -- cached response maintenance
<reference_index>
usage.json -- Complete command tree with arguments, options, defaults, and usage instructions for every command.
</reference_index>
<success_criteria>
- Command executes without error
- Output is displayed in requested format
- Correct command and flags used (verified against usage.json)
</success_criteria>
