LinkMinT

LinkMinT is an end-to-end affiliate intelligence platform for content creators.
It automatically detects product mentions in written or spoken content, resolves them to real products, and seamlessly injects affiliate links—without breaking the creator’s workflow.

The system is built as a multi-service architecture consisting of:

• A Chrome Extension for content authoring platforms
• An AI Service for product understanding and transcription
• An Affiliate Service for link generation, redirects, and markdown processing
• Redis for caching and performance optimization

---

Why LinkMinT?

Affiliate linking today is:

• Manual
• Error-prone
• Platform-specific
• Context-unaware

LinkMinT solves this by introducing affiliate links as a primitive of content creation, not an afterthought.

Creators write naturally.
LinkMinT handles product detection, resolution, and monetization.

---

Key Features

Chrome Extension

• Runs directly inside authoring platforms
• Detects product mentions in real-time
• Works with:
  • Medium drafts
  • DEV.to articles
  • Twitter/X composer
  • YouTube descriptions & transcripts
• Non-destructive edits with undo support

AI-Powered Product Intelligence

• Extracts product mentions from:
  • Plain text
  • Markdown
  • YouTube video transcripts
• Resolves ambiguous product names
• Maps products to unique identifiers (e.g., ASINs)
• Designed to be model-agnostic (LLMs can be swapped)

🔗 Affiliate Link Engine

• Generates platform-safe affiliate URLs
• Supports:
  • Custom affiliate tags
  • First occurrence vs all occurrences linking
• Centralized redirect handling
• Click tracking ready

Markdown-Aware Processing

• Injects links without breaking formatting
• Preserves:
  • Headings
  • Lists
  • Code blocks
  • Inline styles

Redis Caching

• Product resolution caching
• Session state for extension
• Reduced latency for repeated content scans

---

System Architecture

┌──────────────────┐
│ Chrome Extension │
│ (TS + Vite)      │
└───────┬──────────┘
│
▼
┌──────────────────┐
│ Affiliate Service│
│ (Go + Gin)       │
│ - Link creation  │
│ - Markdown edit  │
│ - Redirects      │
└───────┬──────────┘
│
▼
┌──────────────────┐
│ AI Service       │
│ (Python)         │
│ - Product NLP    │
│ - ASIN resolve   │
│ - Transcription  │
└───────┬──────────┘
│
▼
┌──────────────────┐
│ Redis            │
│ - Cache          │
│ - Sessions       │
└──────────────────┘

---

Tech Stack

Frontend (Chrome Extension)

• TypeScript
• Vite
• Tailwind CSS
• Chrome Extension APIs

Backend Services

• Affiliate Service
  • Go
  • Gin Web Framework
• AI Service
  • Python
  • Async-first architecture
  • LLM-compatible pipeline

Infrastructure

• Redis
• Docker & Docker Compose

---

Prerequisites

Ensure the following are installed:

• Node.js ≥ 18
• Go ≥ 1.21
• Python ≥ 3.10
• Docker & Docker Compose
• Google Chrome (Developer Mode enabled)

---

Installation & Setup

1. Clone Repository

git clone https://github.com/gupta-nu/LinkMinT.git
cd LinkMinT

---

2. Start Redis

docker-compose up -d

Redis runs on localhost:6379.

---

3. AI Service Setup

cd ai-service
pip install uv
uv sync
python -m app.main

Service runs on default configured port (typically 8000).

---

4. Affiliate Service Setup

cd ../affiliate-service
go mod tidy
go run main.go

Service runs on http://localhost:8080.

---

5. Chrome Extension Setup

cd ../chrome-extension
npm install
npm run build

Load extension:

1. Open chrome://extensions
2. Enable Developer Mode
3. Click Load unpacked
4. Select chrome-extension/dist

---

Configuration

Inside the Chrome Extension options panel:

Setting	Description
Backend Base URL	Affiliate service base URL
Affiliate Tag	Your affiliate identifier
Link Policy	First occurrence or all mentions
Auto-Apply	Optional automatic linking

---

Usage Guide

Medium

1. Open a draft
2. Floating LinkMinT panel appears
3. Click Scan Products
4. Review detected products
5. Click Apply Links
6. Undo anytime

---

DEV.to

1. Open new or edit article
2. Use LinkMinT panel
3. Inject affiliate links safely into Markdown

---

Twitter/X

1. Start composing a tweet
2. Product mentions detected inline
3. Short affiliate links suggested automatically

---

YouTube

1. Edit description or captions
2. AI service processes transcripts
3. Insert affiliate links contextually

---

API Reference

Affiliate Service

Create Custom Affiliate Link

POST /api/custom-affiliate/create

Inject Affiliate Links into Markdown

POST /api/markdown/affiliate

Redirect Handler

GET /:customerId/:productName

---

AI Service

Extract Products

POST /extract-products

Resolve Product Identifiers

POST /resolve-asins

---

Development Workflow

Chrome Extension (Dev Mode)

npm run dev

Affiliate Service (Live Reload)

go run main.go

AI Service

uv run python -m app.main

Security & Privacy

• No credentials stored in extension
• All processing via backend services
• Redis used only for cache/session data
• Designed for GDPR-friendly workflows

Contributing

1. Fork repository

2. Create branch

   git checkout -b feature/your-feature

3. Commit changes

4. Push and open PR

License

MIT License

Acknowledgments

• Inspired by modern creator tooling gaps
• Built for scale, extensibility, and creator-first UX