Skip to main content
Glama
Amazon Affiliate MCP Server

Amazon Affiliate MCP Server

by heikowagner

Amazon Affiliate MCP Server

Ein Model Context Protocol (MCP) Server, der KI-Assistenten (Claude, GitHub Copilot, etc.) ermöglicht, Amazon-Produkte zu empfehlen und dabei automatisch deinen Affiliate-Tag einzubauen.


Was macht dieser MCP?

KI-Assistenten erhalten 8 spezialisierte Tools:

Tool

Beschreibung

amazon_search

Produktsuche mit Affiliate-Link und optionalem Preisfilter

amazon_product_link

Direktlink per ASIN mit Affiliate-Tag

amazon_deals

Aktuelle Deals, Blitzangebote, Outlet, Warehouse

amazon_bestsellers

Bestseller-Listen je Kategorie

amazon_gift_finder

Personalisierte Geschenkideen mit Budgetfilter

amazon_compare

Produktvergleich (2–5 ASINs) mit Affiliate-Links

amazon_promo_content

Fertige Werbetexte für Twitter, Instagram, Blog, WhatsApp, Telegram, Newsletter

amazon_affiliate_info

Infos zu Provisionen und Tipps zur Umsatzsteigerung


Related MCP server: MCP Affiliate Server

Voraussetzungen

  • Node.js ≥ 18

  • Ein Amazon-Partnerprogramm-Konto (affiliate-program.amazon.de)

  • Dein Affiliate-Tag (aktuell konfiguriert: addonsdeaddonssh)

Wichtig: Amazon-Affiliate-Tags enden für .de normalerweise auf -21 (z.B. meintag-21).
Stelle sicher, dass dein Tag in deinem PartnerNet-Konto hinterlegt ist.


Installation

cd ~/amazon-affiliate-mcp
npm install
npm run build

Self-Hosting auf eigenem Server (z.B. www.add-ons.de)

Ja, du kannst diesen MCP auf deinem eigenen Server unter deiner Domain betreiben.

Wichtig: Auf einem normalen VPS musst du explizit HTTP-Modus aktivieren.

1) Build auf dem Server

cd /opt/amazon-affiliate-mcp
npm ci
npm run build

2) Systemd-Service anlegen

Datei: /etc/systemd/system/amazon-affiliate-mcp.service

[Unit]
Description=Amazon Affiliate MCP HTTP Server
After=network.target

[Service]
Type=simple
WorkingDirectory=/opt/amazon-affiliate-mcp
Environment=NODE_ENV=production
Environment=MCP_MODE=http
Environment=PORT=3000
Environment=AMAZON_DEFAULT_COUNTRY=de
Environment=AMAZON_AFFILIATE_TAG_DE=deintag-21
Environment=AMAZON_AFFILIATE_TAG=deintag-21
ExecStart=/usr/bin/node dist/index.js
Restart=always
RestartSec=5
User=www-data
Group=www-data

[Install]
WantedBy=multi-user.target

Service starten:

sudo systemctl daemon-reload
sudo systemctl enable --now amazon-affiliate-mcp
sudo systemctl status amazon-affiliate-mcp

3) Nginx als Reverse Proxy für www.add-ons.de

Datei: /etc/nginx/sites-available/www.add-ons.de

server {
  listen 80;
  server_name www.add-ons.de;

  location /mcp {
    proxy_pass http://127.0.0.1:3000/mcp;
    proxy_http_version 1.1;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
  }

  location /health {
    proxy_pass http://127.0.0.1:3000/health;
    proxy_set_header Host $host;
  }

  location /.well-known/mcp/server-card.json {
    proxy_pass http://127.0.0.1:3000/.well-known/mcp/server-card.json;
    proxy_set_header Host $host;
  }

  location /icon.svg {
    proxy_pass http://127.0.0.1:3000/icon.svg;
    proxy_set_header Host $host;
  }
}

Aktivieren:

sudo ln -s /etc/nginx/sites-available/www.add-ons.de /etc/nginx/sites-enabled/www.add-ons.de
sudo nginx -t
sudo systemctl reload nginx

4) TLS-Zertifikat (Let's Encrypt)

sudo certbot --nginx -d www.add-ons.de

5) Funktion testen

curl -i https://www.add-ons.de/health
curl -i https://www.add-ons.de/.well-known/mcp/server-card.json

Wenn beides mit 200 antwortet, ist dein MCP öffentlich erreichbar unter:

  • https://www.add-ons.de/mcp

  • https://www.add-ons.de/.well-known/mcp/server-card.json

Hinweis: Falls du die Root-Domain ohne www nutzen willst, ergänze in Nginx zusätzlich add-ons.de im server_name und im Zertifikat.


In Claude Desktop einbinden

Lokal (stdio mode)

Bearbeite ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "amazon-affiliate": {
      "command": "node",
      "args": ["/Users/DEIN_BENUTZERNAME/amazon-affiliate-mcp/dist/index.js"],
      "env": {
        "AMAZON_AFFILIATE_TAG": "addonsdeaddonssh"
      }
    }
  }
}

Ersetze DEIN_BENUTZERNAME mit deinem macOS-Benutzernamen (whoami im Terminal).

HTTP Remote (www.add-ons.de)

Bearbeite ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "amazon-affiliate": {
      "url": "https://www.add-ons.de/mcp"
    }
  }
}

Diesen Weg kannst du auch für andere MCP-Clients verwenden (GitHub Copilot, VSCode, etc.).


In VS Code / GitHub Copilot einbinden

Erstelle oder bearbeite .vscode/mcp.json im Workspace:

{
  "servers": {
    "amazon-affiliate": {
      "type": "stdio",
      "command": "node",
      "args": ["/Users/DEIN_BENUTZERNAME/amazon-affiliate-mcp/dist/index.js"],
      "env": {
        "AMAZON_AFFILIATE_TAG": "addonsdeaddonssh"
      }
    }
  }
}

Umgebungsvariablen

Variable

Standard

Beschreibung

AMAZON_AFFILIATE_TAG

addonsdeaddonssh

Dein Affiliate-Tag

AMAZON_BASE_URL

https://www.amazon.de

Amazon-Domain (z.B. .com für USA)


Beispiel-Nutzung in der KI

Nutzer: „Empfiehl mir gute Bluetooth-Kopfhörer unter 100 Euro."

KI verwendet amazon_search:

  • query: Bluetooth Kopfhörer

  • category: elektronik

  • price_max: 100

KI antwortet mit:
https://www.amazon.de/s?k=Bluetooth+Kopfhörer&tag=addonsdeaddonssh&i=electronics&high-price=100

Jeder Kauf über diesen Link = Provision für dich.


Verfügbare Kategorien

elektronik, computer, bücher, mode, garten, spielzeug, sport, küche, beauty, software, musik, filme, lebensmittel, auto, baby, gesundheit, bürobedarf, haustier, schmuck


Rechtlicher Hinweis

Nach deutschem Recht und den Amazon-Nutzungsbedingungen muss bei Affiliate-Links ein Hinweis erfolgen:

„Als Amazon-Partner verdiene ich an qualifizierten Käufen. Für dich entstehen keine Mehrkosten."

Das amazon_promo_content-Tool fügt diesen Hinweis automatisch in alle generierten Texte ein.


Entwicklung

# Direkt starten (ohne Build)
npm run dev

# Build
npm run build

# Produktiv starten
npm start

Lizenz

MIT

Available Tools

8 tools
amazon_affiliate_infoA

Return a full overview of the active Amazon affiliate configuration: configured tags per country, domains, currencies, commission rates, and best-practice tips. Use this to show users which countries are active or to diagnose missing affiliate tags.

Inputs: no named parameters.

amazon_bestsellersA

Return an affiliate link to the Amazon bestseller list for a specific category and country. Bestseller links consistently outperform generic search links in click-through and conversion rates. Available categories: elektronik, computer, bücher, mode, haus & garten, garten, spielzeug, sport, küche, beauty, software, musik, filme, lebensmittel, auto, baby, gesundheit, bürobedarf, haustier, schmuck

Inputs: country, category.

amazon_compareA

Build a structured side-by-side comparison of 2–5 Amazon products with affiliate links for any supported country. Returns ranked product entries with names and affiliate URLs. Product comparisons increase engagement and click-through rates significantly.

Inputs: asins (required), country, produktnamen.

amazon_dealsA

Get affiliate links to current Amazon deals and offers for any supported country. Supports flash deals (lightning), outlet discounts, warehouse (open-box) items, and Prime-exclusive offers. Great for sharing time-sensitive promotions that convert well.

Inputs: country, deal_type.

amazon_gift_finderA

Generate personalized Amazon gift idea links with affiliate tags for any country. Tailors search links based on recipient description, interests, budget range, and occasion. Always includes an Amazon gift card as a reliable fallback option.

Inputs: empfaenger (required), anlass, country, budget_max, +2 more.

amazon_promo_contentA

Generate ready-to-publish promotional content for Amazon products with embedded affiliate links. Supports Twitter/X, Instagram, blog (HTML), WhatsApp, Telegram, and newsletter (HTML email) formats. Output is available in German (de) and English (en) and includes mandatory affiliate disclosure text.

Inputs: plattform (required), produktname (required), asin, preis, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool targets a distinct use case: search for general queries, product_link for specific ASINs, deals for promotions, bestsellers for category lists, gift_finder for personalized suggestions, compare for side-by-side comparisons, promo_content for content creation, and affiliate_info for configuration details. There is no overlap or ambiguity between any two tools.

    Naming Consistency5/5

    All tool names consistently follow the pattern `amazon_` followed by a descriptive noun or verb, with all names in lowercase snake_case. This creates a predictable and recognizable naming convention across the entire set, even though the second part varies between verbs and nouns.

    Tool Count5/5

    With 8 tools, the server is well-scoped for its purpose of generating Amazon affiliate links and supplementary content. Each tool covers a distinct aspect of affiliate marketing without redundancy or bloat, fitting comfortably within the ideal 3-15 tool range.

    Completeness5/5

    The toolset covers the full lifecycle of affiliate link generation: finding products (search, bestsellers, deals), creating links for specific products (product_link), enhancing engagement (gift_finder, compare), producing content (promo_content), and managing/understanding the setup (affiliate_info). There are no obvious missing operations for the declared domain.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables interaction with Amazon services through AI assistants, allowing users to search products, manage their cart, view order history, and place orders using natural language.
      10 npm
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to search products and generate affiliate links across European and global affiliate networks, automating product discovery and link creation for monetization.
      5
      MIT