Affiliate Radar
by jeremstyke
README.md
<div align="center">
<img src="icon.png" width="96" alt="Affiliate Radar icon">
# Affiliate Radar
**Competitive intelligence for affiliate websites, right inside Claude.**
See which affiliate programs your competitors use, the products they push,
their Amazon tracking tags and every article they publish. Just ask.
[](LICENSE)
[](https://modelcontextprotocol.io)
[](https://www.python.org)
[**Website**](https://jeremstyke.github.io/affiliate-radar-mcp/) · [**Join the waitlist**](https://jeremstyke.github.io/affiliate-radar-mcp/?src=github) · [**Self-host**](#-self-hosting)
</div>
---
## Why Affiliate Radar?
SEO suites tell you about keywords. **Affiliate Radar tells you how your competitors actually make money.**
It is an [MCP](https://modelcontextprotocol.io) server: once connected to Claude, you ask questions in plain words and Claude calls the right tools for you.
> **You:** What is birdfeeder-reviews.com pushing right now?
>
> **Claude:** They published 6 new articles in the last 14 days, all about smart bird feeders.
> Programs: Amazon (91%), Awin (9%). Amazon tag: `birdfeed-21`. Top product: Bird Buddy Pro, in 5 of 6 articles.
## ✨ Features
| Tool | What it gives you |
|---|---|
| `site_overview` | Site size, publishing pace per month, CMS, affiliate programs, Amazon tags, most promoted products, average article length |
| `analyze_page` | Affiliate programs and links, Amazon tags and ASINs, headings, word count, tables, review schema, publish and update dates |
| `new_content` | Pages a competitor published or updated in the last N days, from its sitemaps |
| `compare_competitors` | Up to 6 competitors side by side |
| `track_competitor` / `check_changes` / `list_tracked` | Snapshot a competitor and see new, removed and updated pages since last check |
| `serp_top` | Google top results for a keyword *(DataForSEO)* |
| `ranked_keywords` | Keywords a competitor ranks for, with volume and estimated traffic *(DataForSEO)* |
**Detected affiliate networks:** Amazon (incl. amzn.to), Awin, CJ, Impact, Rakuten, Tradedoubler, Effiliation, Kwanko, TimeOne, Partnerize, ShareASale, Skimlinks, Sovrn, eBay Partner Network, AliExpress, ClickBank, Digistore24, Admitad, Booking, Geniuslink, and cloaked links like `/go/` or `/recommends/`.
**Blocked pages?** When a site blocks bots, Affiliate Radar falls back to the latest Wayback Machine copy, then to a scraping API if you configure one.
## 🚀 Use it in Claude
The hosted version is coming soon. [Join the waitlist](https://jeremstyke.github.io/affiliate-radar-mcp/?src=github) to get early access.
To use your own instance:
1. Deploy the server (see below) and note your URL: `https://<your-domain>/mcp/<MCP_SECRET>`
2. In Claude, open **Settings → Connectors → Add custom connector**
3. Paste the URL, choose **No authentication**, and save
4. Start a new chat and ask: *"Give me a site overview of competitor.com"*
## 🛠 Self-hosting
### Railway (recommended)
1. Fork this repository
2. Create a new Railway project from your fork
3. Add a volume mounted at `/data`
4. Set the environment variables below
5. Generate a domain
### Local
```bash
pip install -r requirements.txt
MCP_SECRET=change-me python server.py
# Connector URL: http://localhost:8000/mcp/change-me
```
To run it over stdio (Claude Desktop, Claude Code), set `MCP_TRANSPORT=stdio`.
### Environment variables
| Variable | Required | Description |
|---|---|---|
| `MCP_SECRET` | ✅ | Secret part of the connector URL, keep it private |
| `DATA_DIR` | | Folder for the SQLite database (tracked competitors, waitlist). Default: app folder |
| `DATAFORSEO_LOGIN` / `DATAFORSEO_PASSWORD` | | Enables `serp_top` and `ranked_keywords` |
| `SCRAPER_API_KEY` | | Fallback for blocked pages |
| `SCRAPER_PROVIDER` | | `scrapingbee` (default), `zenrows` or `scraperapi` |
| `PUBLIC_MODE` | | `1` exposes only the stateless tools at `/mcp`, without a secret (public free tier) |
| `PORT` | | HTTP port. Default: `8000` |
## 🧱 Stack
Python 3.13 · [MCP Python SDK](https://github.com/modelcontextprotocol/python-sdk) · httpx · selectolax · SQLite
## 🔒 Privacy Policy
The server receives only the tool arguments (domains, URLs, keywords), never your Claude conversation. Full policy: [jeremstyke.github.io/affiliate-radar-mcp/privacy.html](https://jeremstyke.github.io/affiliate-radar-mcp/privacy.html)
## ⚖️ Responsible use
Affiliate Radar only reads public pages and sitemaps, like a regular visitor. Respect the terms of service of the sites you analyze and keep request volumes reasonable.
## 📄 License
[MIT](LICENSE) © 2026 Jérémy Dacier-Jury
Not affiliated with Amazon, Anthropic or any affiliate network.
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues