by-smartlink.com

{
  "name": "create_marketing_link",
  "kind": "act",
  "impl": "imperative",
  "description": "Create a powerful, fully-configured Smart Link for marketing campaigns. Supports geo-targeting, device routing, UTM parameters, A/B testing, and bot protection.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "url": {
        "type": "string",
        "description": "Main destination URL. Required unless using A/B testing (abVariants)."
      },
      "title": {
        "type": "string",
        "description": "A descriptive name for this link (e.g., \"Back to School - Facebook Campaign\")"
      },
      "utmSource": {
        "type": "string",
        "description": "UTM source parameter (e.g., \"facebook\", \"google\", \"newsletter\")"
      },
      "utmMedium": {
        "type": "string",
        "description": "UTM medium parameter (e.g., \"cpc\", \"email\", \"social\")"
      },
      "utmCampaign": {
        "type": "string",
        "description": "UTM campaign name (e.g., \"back-to-school-2026\", \"summer-sale\")"
      },
      "geoRules": {
        "type": "array",
        "description": "Geo-targeting rules: route users from specific countries to different URLs.",
        "items": {
          "type": "object",
          "properties": {
            "countries": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "ISO 3166-1 alpha-2 country codes (e.g., [\"SA\", \"AE\"] for Saudi Arabia and UAE)"
            },
            "targetUrl": {
              "type": "string",
              "description": "The URL to redirect users from these countries to"
            }
          },
          "required": [
            "countries",
            "targetUrl"
          ]
        }
      },
      "deviceRules": {
        "type": "object",
        "description": "Device-based routing. Route mobile users to one URL and desktop users to another.",
        "properties": {
          "mobile": {
            "type": "string",
            "description": "URL for mobile device users"
          },
          "desktop": {
            "type": "string",
            "description": "URL for desktop users"
          },
          "tablet": {
            "type": "string",
            "description": "URL for tablet users"
          }
        }
      },
      "languageRules": {
        "type": "array",
        "description": "Language-based routing using browser language settings.",
        "items": {
          "type": "object",
          "properties": {
            "language": {
              "type": "string",
              "description": "ISO 639-1 language code (e.g., \"ar\", \"fr\", \"es\")"
            },
            "targetUrl": {
              "type": "string",
              "description": "URL to show users whose browser language matches"
            }
          }
        }
      },
      "abVariants": {
        "type": "array",
        "description": "A/B test variants. Provide 2+ URLs to split traffic and find the best-performing one.",
        "items": {
          "type": "object",
          "properties": {
            "url": {
              "type": "string",
              "description": "Destination URL for this variant"
            },
            "name": {
              "type": "string",
              "description": "Name for this variant (e.g., \"Version A - Red Button\")"
            },
            "weight": {
              "type": "number",
              "description": "Traffic percentage for this variant (e.g., 50 for 50%)"
            }
          },
          "required": [
            "url"
          ]
        }
      },
      "enableBotProtection": {
        "type": "boolean",
        "description": "Enable automatic bot detection to block scrapers and fake ad clicks. Recommended for paid ad campaigns."
      },
      "customAlias": {
        "type": "string",
        "description": "Custom short code (e.g., \"summer26\" → by-smartlink.com/summer26). Must be 3-50 alphanumeric characters."
      }
    }
  },
  "page": "/"
}

{
  "name": "get_link_analytics",
  "kind": "answer",
  "impl": "imperative",
  "description": "Get detailed analytics for a Smart Link: total clicks, bot clicks blocked, top countries, device breakdown, and A/B test results.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "shortCode": {
        "type": "string",
        "description": "The short code of the link (the part after by-smartlink.com/, e.g., \"abc123\")"
      }
    },
    "required": [
      "shortCode"
    ]
  },
  "page": "/"
}

{
  "name": "shorten_url",
  "kind": "act",
  "impl": "imperative",
  "description": "Instantly shorten any long URL to a compact Smart Link. No account required.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "url": {
        "type": "string",
        "description": "The full URL to shorten (must start with http:// or https://)"
      }
    },
    "required": [
      "url"
    ]
  },
  "page": "/"
}

{
  "name": "shorten_url",
  "kind": "act",
  "impl": "imperative",
  "description": "Shorten a long URL and create a bot-shielded Smart Link",
  "inputSchema": {
    "type": "object",
    "properties": {
      "url": {
        "type": "string",
        "description": "The long destination URL to shorten"
      },
      "customSlug": {
        "type": "string",
        "description": "Optional custom slug alias for the link"
      },
      "title": {
        "type": "string",
        "description": "Optional title for the tracking campaign"
      }
    },
    "required": [
      "url"
    ]
  },
  "page": "/"
}

{
  "name": "get_link_analytics",
  "kind": "answer",
  "impl": "imperative",
  "description": "Get real-time click analytics and bot blocking statistics for a Smart Link",
  "inputSchema": {
    "type": "object",
    "properties": {
      "shortCode": {
        "type": "string",
        "description": "The short code identifier of the link"
      }
    },
    "required": [
      "shortCode"
    ]
  },
  "page": "/"
}

{
  "name": "calculate_ad_savings",
  "kind": "act",
  "impl": "imperative",
  "description": "Calculate wasted ad spend saved from bot and datacenter traffic filtering",
  "inputSchema": {
    "type": "object",
    "properties": {
      "monthlyAdSpend": {
        "type": "number",
        "description": "Monthly paid ad spend in USD"
      },
      "botRate": {
        "type": "number",
        "description": "Estimated bot traffic percentage (default 0.34 for 34%)"
      }
    },
    "required": [
      "monthlyAdSpend"
    ]
  },
  "page": "/"
}

{
  "name": "check_url_reputation",
  "kind": "answer",
  "impl": "imperative",
  "description": "Analyze a URL for potential datacenter bot risks or affiliate redirection flags",
  "inputSchema": {
    "type": "object",
    "properties": {
      "url": {
        "type": "string",
        "description": "URL to inspect"
      }
    },
    "required": [
      "url"
    ]
  },
  "page": "/"
}

{
  "name": "shorten_url",
  "kind": "act",
  "impl": "declarative",
  "description": "Shorten any URL instantly using Smart Link",
  "inputSchema": {
    "type": "object",
    "properties": {
      "originalUrl": {
        "type": "string",
        "description": "Destination URL to shorten"
      }
    },
    "required": [
      "originalUrl"
    ]
  },
  "page": "/"
}

{
  "name": "create_marketing_link",
  "kind": "act",
  "impl": "declarative",
  "description": "Create a marketing tracking link with geo-targeting, UTM, bot protection, and A/B testing",
  "inputSchema": {
    "type": "object",
    "properties": {
      "url": {
        "type": "string",
        "description": "Main URL"
      },
      "title": {
        "type": "string",
        "description": "Campaign Title"
      },
      "utmSource": {
        "type": "string",
        "description": "utm_source"
      },
      "utmMedium": {
        "type": "string",
        "description": "utm_medium"
      },
      "utmCampaign": {
        "type": "string",
        "description": "utm_campaign"
      },
      "enableBotProtection": {
        "type": "boolean"
      }
    },
    "required": [
      "url"
    ]
  },
  "page": "/"
}

{
  "name": "get_link_analytics",
  "kind": "answer",
  "impl": "declarative",
  "description": "Get click stats and visitor analytics for a Smart Link shortcode",
  "inputSchema": {
    "type": "object",
    "properties": {
      "shortCode": {
        "type": "string",
        "description": "shortCode"
      }
    },
    "required": [
      "shortCode"
    ]
  },
  "page": "/"
}