Url Shortener: Effortless Link Shortening & Real-Time Click Analytics

Turn long links into tiny URLs effortlessly. Track & analyze clicks in real-time. Boost your click-throughs today!" )

Visit Repository

✨ Developer Tools

4.5(40 reviews)

60 saves

28 comments

Users create an average of 52 projects per month with this tool

About Url Shortener

What is Url Shortener: Effortless Link Shortening & Real-Time Click Analytics?

This advanced tool simplifies URL management by providing seamless shortening via the CleanURI API, while offering actionable insights through real-time click tracking. Designed for developers and marketers alike, it bridges convenience and analytics to optimize link distribution and performance monitoring.

Key Features of Url Shortener: Effortless Link Shortening & Real-Time Click Analytics

Instant URL compression powered by CleanURI’s robust API
Seamless integration with agent systems via FastMCP protocol
Comprehensive error handling and validation for reliability
Flexible deployment options through CLI or Docker containers
Real-time analytics dashboard for tracking engagement metrics

Url Shortener Features

How to Use Url Shortener: Effortless Link Shortening & Real-Time Click Analytics

Install dependencies: Python 3.10+, httpx, and FastMCP
Deploy via Smithery CLI or manual setup with uv/dokcer
Configure in Claude Desktop using provided JSON configurations
Invoke the tool programmatically or through API endpoints

For full flexibility, choose between lightweight CLI execution or scalable Docker deployments.

Use Cases of Url Shortener: Effortless Link Shortening & Real-Time Click Analytics

Maximize efficiency in:

Social media campaigns with trackable shortened links
A/B testing different URL variants for engagement analysis
Automated marketing workflows requiring link manipulation
Enterprise systems needing API-driven URL management
Custom analytics dashboards for marketing attribution

Url Shortener FAQ

FAQ from Url Shortener: Effortless Link Shortening & Real-Time Click Analytics

Q: Can I customize shortened URLs?
A: While the API handles compression, custom slugs can be implemented through extended configurations.
Q: What platforms are supported?
A: Works cross-platform with Python 3.10+, Docker, and Claude Desktop integrations.
Q: How secure is the data?
A: Implements strict validation and error handling, with optional TLS encryption for API calls.
Q: Can I export analytics data?
A: Real-time metrics are accessible programmatically through the API endpoints.

Content

URL Shortener MCP Tool

This project provides a simple URL shortening tool using the CleanURI API and is designed to run as a FastMCP server tool.

✨ Features

Shortens any given URL using the CleanURI API.
Exposes the functionality as a tool via FastMCP.
Includes proper error handling and response validation.
Designed to run via stdio transport for integration with agent or tool-based systems.

🚀 Usage

1. Requirements

Python 3.10+
httpx
fastmcp

2. Installation

Installing via Smithery

To install URL Shortener Tool for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @Talismanic/cleanuri-url-shortener-mcp --client claude

Manual Installation

uv add httpx 'mcp[cli]'

or for Docker based installation:

3. Running

uv run main.py

or for dockers:

docker build -t url-shortener .

4. Adding in Claude Desktop

With the uv

{
  "mcpServers": {
    "url-shortener": {
      "command": "/Users/{userName}/.local/bin/uv",
      "args": [
        "--directory",
        "{patht_to_repo}/cleanuri-url-shortener-mcp",
        "run",
        "main.py"
      ]
    }
  }
}

With Docker

{
  "mcpServers": {
    "url-shortener": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--init",
        "-e",
        "DOCKER_CONTAINER=true",
        "url-shortener"
      ]
    }
  }
}