CampaignLint – Bulk UTM Link Builder & Campaign URL Audit Kit

Description

Review campaign links before sharing them

CampaignLint is an original offline bulk UTM link builder for small agencies, technical marketers and campaign operators who work with CSV files. Generate static tagged URLs while keeping an explicit record of rows that need correction or review.

Features

• Process up to 10,000 CSV rows with source, medium and campaign required.
• Optional campaign ID, source platform, term and content.
• Encode UTM values while preserving destination query tokens and fragments.
• Block missing values, unsupported schemes, URL credentials, malformed percent escapes, unresolved macros and existing UTM conflicts.
• Flag naming issues, case-only variants, exact duplicate output URLs, HTTP destinations and existing click IDs.
• Explicit replacement option removes all existing utm_* parameters before adding new tags.
• Export CSV links, JSON audit and text review report. Refuse existing output folders to protect prior work.

Included files

Python source, 15 automated tests, blank CSV template, clean and issue-filled sample batches with expected outputs, editable naming-policy worksheet, three-page PDF quickstart, PDF generator source, README, research notes and license.

Requirements and limits

Requires Python 3.10+ and basic command-line familiarity. The link builder uses only the Python standard library: no external package, account, API key or internet requirement. Python is not bundled. This is not an EXE, graphical application or formula-based spreadsheet. Optional PDF regeneration requires reportlab and Liberation fonts. Runtime tests were performed on Linux; native Windows and macOS execution were not tested.

READY means local syntax checks passed, not that a destination or analytics setup works. No live click tracking, GA4 connection, redirect checks, consent checks, channel classification, short links or dynamic ad-platform macros. Names are preserved, not silently lowercased. Review warnings and test destinations separately. Do not include personal information or secrets in UTM values.

License

One purchaser or business may run and modify the tool for unlimited internal and direct-client campaigns and deliver generated links and reports to clients. Redistribution, resale and competing hosted-service use are prohibited. Full terms included. No revenue or attribution outcome is guaranteed.