@superagnt/dub-links 2.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md ADDED
@@ -0,0 +1,79 @@
1
+ # Dub integration for OpenClaw — superagnt plugin
2
+
3
+ Connect your Dub workspace to superagnt to programmatically manage short links, track conversions, and retrieve link attribution analytics. Create branded short links, track click-to-sale attribution, and read real-time analytics through a unified API.
4
+
5
+ ## Install
6
+
7
+ ```bash
8
+ openclaw plugins install @superagnt/dub-links
9
+ ```
10
+
11
+ This package is the official **OpenClaw** plugin for the **Dub** integration via [superagnt](https://superagnt.com). Pair it with the [documentation](https://superagnt.com) and your superagnt API key.
12
+
13
+ ## Live MCP mode (recommended)
14
+
15
+ Set a workspace MCP token and the plugin upgrades itself at load: it fetches
16
+ the live tool list from the scoped MCP endpoint and proxies calls through it —
17
+ the tool surface then grows with `agnt_tools_enable`, no plugin update needed.
18
+
19
+ ```bash
20
+ export SUPERAGNT_MCP_TOKEN=... # from the MCP server card in the dashboard
21
+ ```
22
+
23
+ Without the token the plugin uses its built-in toolset with your
24
+ `SUPERAGNT_API_KEY` — no behavior change from previous versions.
25
+
26
+ ## Overview
27
+
28
+ OpenClaw plugin for Dub — manage short links, conversion events, customers, tags, folders, and domains with your superagnt API key.
29
+
30
+ ### Highlights
31
+
32
+ - Short link management — create, update, upsert, and delete links at scale
33
+ - Conversion tracking — record server-side lead and sale events tied to a click ID
34
+ - Real-time analytics — query clicks, leads, sales, and revenue by any dimension
35
+ - Events stream — paginate raw click, lead, and sale events for the workspace
36
+ - Tags & folders — organize links and apply role-based access control
37
+ - Custom domains — manage branded domains used for short links
38
+ - Customers — read and update customers tied to conversion events
39
+
40
+ ### Example use cases
41
+
42
+ - Programmatically generate millions of branded short links from your CRM
43
+ - Track sign-ups and purchases as conversions on referral and marketing links
44
+ - Build dashboards showing link clicks, leads, and revenue by campaign
45
+ - Sync customers and conversion events into your data warehouse
46
+ - Automate UTM tagging and A/B test rotation for outbound campaigns
47
+ - Power affiliate and partner programs with attributed short links
48
+
49
+ ## Prerequisites
50
+
51
+ 1. An **superagnt API key** — create and manage keys in the [superagnt dashboard](https://app.superagnt.com/dashboard).
52
+ 2. A connected **Dub** account — configure in the [integrations dashboard](https://app.superagnt.com/dashboard/connections).
53
+
54
+ ## Authentication
55
+
56
+ Set `SUPERAGNT_API_KEY` in your environment, or complete browser login when the gateway prompts you.
57
+
58
+ ## API coverage
59
+
60
+ | | |
61
+ | --- | --- |
62
+ | **Integration** | `dub` |
63
+ | **REST base** | `https://api.superagnt.com/v1/connections/dub` |
64
+ | **OpenAPI operations** | 41 |
65
+ | **OpenClaw tools** | 41 |
66
+
67
+ ## Documentation
68
+
69
+ - [Documentation](https://superagnt.com) — getting started and concepts
70
+ - [Connection guide (Dub)](https://superagnt.com/connections/dub) — setup and endpoints
71
+ - [Dashboard](https://app.superagnt.com/dashboard) — API keys and usage
72
+
73
+ ## Related
74
+
75
+ - **Skill (curl-oriented):** `clawhub install dub-links` on [ClawHub](https://clawhub.ai/superagnt/skills/dub-links)
76
+
77
+ ## License
78
+
79
+ MIT