@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 +79 -0
- package/index.js +1971 -0
- package/openclaw.plugin.json +16 -0
- package/package.json +49 -0
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
|