marketing
Tapfiliate CLI for Headless Automation
Use the Tapfiliate CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.
5 functions 4 read 1 write API key auth
Tapfiliate CLI for Headless Automation
Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.
Use headless automation when another tool needs a stable local command surface. The Tapfiliate CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# Tapfiliate CLI for Headless Automation
kosmokrator integrations:configure tapfiliate --set api_key="$TAPFILIATE_API_KEY" --enable --read allow --write ask --json
kosmo integrations:call tapfiliate.tapfiliate_list_affiliates '{"limit":1,"page":1}' --json Discovery Before Execution
Agents and scripts can inspect Tapfiliate docs and schemas before choosing a function.
kosmo integrations:docs tapfiliate --json
kosmo integrations:docs tapfiliate.tapfiliate_list_affiliates --json
kosmo integrations:schema tapfiliate.tapfiliate_list_affiliates --json
kosmo integrations:search "Tapfiliate" --json
kosmo integrations:list --json Useful Tapfiliate CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
tapfiliate.tapfiliate_list_affiliates | Read | limit, page | List affiliates in your Tapfiliate account. Returns paginated results with affiliate IDs, emails, names, and status. |
tapfiliate.tapfiliate_get_affiliate | Read | id | Get detailed information about a specific affiliate by their ID. Includes email, name, status, and metadata. |
tapfiliate.tapfiliate_list_conversions | Read | affiliate_id, campaign_id, external_id, status, from_date, to_date, limit, page | List conversions in your Tapfiliate account. Supports filtering by affiliate, campaign, date range, and status. Results are paginated. |
tapfiliate.tapfiliate_create_conversion | Write | affiliate_id, amount, external_id, campaign_id, commission_type, commission_amount, meta_data | Create a new conversion in Tapfiliate. Associates a revenue amount with an affiliate using a unique external ID (e.g., order ID or transaction reference). |
tapfiliate.tapfiliate_get_current_user | Read | none | Get the currently authenticated Tapfiliate user profile. Useful for verifying API credentials and checking account details. |
Automation Notes
- Use
--jsonfor machine-readable output. - Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
- Configure read/write policy before unattended runs; use
--forceonly for trusted automation. - Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.