dub-links-api

What This Skill Does

The dub-links-api skill enables OpenClaw to interact directly with the Dub.co Links API. It serves as a comprehensive toolkit for managing short links programmatically. With this skill, the agent can create new short links, update existing URLs, retrieve link metadata by ID or domain/key pairs, list paginated collections of links, and perform upsert operations to ensure data consistency. It also supports analytical tasks such as counting links based on specific filters like tags, domains, or search terms. By leveraging this integration, users can automate their link management workflows—such as generating branded tracking links, cleaning up outdated redirects, or auditing existing link infrastructure—all through natural language commands within the OpenClaw environment.

Installation

To install this skill, use the OpenClaw CLI tool in your terminal: clawhub install openclaw/skills/skills/ferminrp/dub-links-api

Once installed, ensure you have your Dub.co API key ready. You can generate one from the Dub.co Tokens documentation. Set your key as an environment variable in your shell configuration: export DUB_API_KEY="your_api_key_here"

Use Cases

• Marketing Automation: Automatically generate short links for new blog posts or landing pages using custom domains.
• Bulk Link Management: Update target URLs or archive old links across a large portfolio of short links.
• Data Analysis: Count active campaigns filtered by specific tags to track production metrics.
• Link Validation: Use the info endpoint to verify that a custom short link is correctly pointing to the intended destination before sharing it.

Example Prompts

1. "Create a new short link for https://example.com/long-article and return the short URL."
2. "List the first 20 links in my workspace sorted by creation date descending."
3. "How many total links do I have tagged with 'marketing-campaign'?"

Tips & Limitations

This skill is strictly limited to the /links namespace of the Dub.co API. It does not provide access to analytics, workspaces, or workspace-wide settings. Ensure your API key has appropriate permissions for the links you wish to manage. When performing updates or deletions, verify the linkId or externalId carefully to avoid accidental modifications. For better performance with large workspaces, always utilize the pagination parameters (page and pageSize) when listing links to avoid memory overhead and latency.