Backlink Outreach MCP Server
Integrates with Google Custom Search API to discover backlink prospects by searching the web for relevant pages.
Enables email sending and receiving via Hostinger's SMTP/IMAP services for automated outreach campaigns.
Provides performance and SEO scores for domains using Google PageSpeed Insights API, used for scoring prospects.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Backlink Outreach MCP Server
Server MCP per la discovery e outreach automatizzata di backlink per calcolatorigratis.com.
Stack: Python 3 + FastMCP + SQLite + httpx
Deploy: CT102 Proxmox (192.168.1.107:8010)
Tunnel: https://backlink.calcolatorigratis.com
Dashboard: https://backlink.calcolatorigratis.com/dashboard
Come ottenere le API Key
Il server utilizza 4 chiavi API esterne. Tutte hanno un free tier sufficiente per l'uso del progetto. Le chiavi si inseriscono direttamente dalla dashboard (sezione "Chiavi API" in fondo alla pagina) oppure nel file .env.
Le chiavi salvate dalla dashboard hanno priorita su quelle nel
.env.
1. Google Custom Search API Key + Engine ID (CX)
Permette di cercare su Google via API ufficiale (100 query/giorno gratis) invece dello scraping HTML.
Stato aprile 2026: La Custom Search JSON API ha due limitazioni importanti:
Chiusa ai nuovi clienti — se il tuo account Google Cloud non ha mai abilitato questa API, potresti ricevere errore 403. Gli account esistenti possono usarla fino al 1 gennaio 2027.
"Ricerca in tutto il Web" deprecata — l'opzione per cercare su tutto il web non e piu attivabile. Il motore di ricerca cerca SOLO nei siti/domini che aggiungi manualmente (max 50 domini).
Cosa significa in pratica: La CSE resta utile per cercare in un set di domini italiani noti (blog, directory, portali), ma non puo sostituire una ricerca web generica. Per la discovery generica, il server usa lo scraping HTML (20 query/giorno) oppure GSC/Ahrefs MCP.
Se non riesci ad attivarla, salta questa sezione. Il server funziona perfettamente senza.
Passo 1 — Crea un progetto Google Cloud
Vai su Google Cloud Console
Accedi con il tuo account Google
Clicca il menu a tendina dei progetti in alto
Clicca Nuovo progetto
Nome:
Backlink Outreach(o qualsiasi nome)Clicca Crea
Passo 2 — Abilita la Custom Search API
Nel progetto appena creato, vai su API e servizi > Libreria
URL diretto: https://console.cloud.google.com/apis/library
Cerca "Custom Search API"
Clicca sul risultato "Custom Search JSON API"
Clicca Abilita
Se ricevi errore 403 "PERMISSION_DENIED", il tuo account non ha accesso (API chiusa ai nuovi clienti). Salta questa sezione.
Passo 3 — Genera la API Key
Vai su API e servizi > Credenziali
URL diretto: https://console.cloud.google.com/apis/credentials
Clicca + Crea credenziali > Chiave API
Copia la chiave generata (formato:
AIzaSy...)(Consigliato) Clicca Limita chiave e seleziona solo "Custom Search JSON API"
Questa e la tua GOOGLE_CSE_API_KEY. Serve anche per Google PageSpeed Insights (il server la riusa automaticamente).
Passo 4 — Crea il Search Engine e ottieni il CX
Vai su Programmable Search Engine
Nome del motore di ricerca:
Backlink DiscoverySiti in cui eseguire ricerche: aggiungi i domini target per la discovery backlink. Esempi di pattern utili per il mercato italiano:
*.blogspot.com/* *.wordpress.com/* *.altervista.org/* *.medium.com/* *.substack.com/*Puoi aggiungere fino a 50 domini distinti. Aggiungi i portali, blog e directory italiane dove vuoi cercare prospect per backlink. Potrai modificarli in seguito.
Clicca Crea
Dopo la creazione, clicca Personalizza per aprire il pannello di configurazione
Nella pagina Impostazioni base, trova l'ID motore di ricerca (Search engine ID)
E una stringa tipo
a1b2c3d4e5f6g7h8i(17 caratteri alfanumerici)
Questo e il tuo GOOGLE_CSE_CX.
Nota: L'opzione "Ricerca in tutto il Web" nella sezione "Funzionalita dei risultati di ricerca" e deprecata e non puo piu essere attivata. Il motore cerchera solo nei domini che hai inserito. Per una ricerca web generica, usa il tool
search_google_prospectssenza CSE (scraping HTML) oppure i tool GSC/Ahrefs MCP.
Riepilogo
Chiave | Dove trovarla | Free tier |
| Google Cloud Console > Credenziali | 100 query/giorno |
| Programmable Search Engine > Panoramica | Incluso |
Riferimenti:
2. Hunter.io API Key
Permette di trovare email associate a un dominio (25 ricerche/mese gratis) e verificarle (50 verifiche/mese). Il server funziona anche senza questa chiave (usa solo lo scraping HTML per cercare email visibili nelle pagine).
Passo 1 — Registrati
Vai su Hunter.io
Clicca Sign up in alto a destra
Registrati con email e password, oppure con Google/LinkedIn
Conferma l'email di verifica
Passo 2 — Ottieni la API Key
Dopo il login, vai su API Keys
Oppure: clicca il tuo avatar > API nel menu
La chiave API e visibile nella pagina
Formato: stringa alfanumerica lunga ~40 caratteri
Copia la chiave
Questa e la tua HUNTER_API_KEY.
Passo 3 — Verifica il funzionamento (opzionale)
Puoi testare la chiave direttamente nel terminale:
curl "https://api.hunter.io/v2/account?api_key=LA_TUA_CHIAVE"Se funziona, vedrai il tuo piano e le ricerche rimanenti.
Free tier
Risorsa | Limite mensile |
Domain Search (ricerca email per dominio) | 25 ricerche |
Email Verifier (verifica deliverability) | 50 verifiche |
Email Finder (trova email per nome+dominio) | 25 ricerche |
Autenticazione
La chiave puo essere passata in 3 modi (il server usa il primo):
Parametro query:
?api_key=LA_TUA_CHIAVEHeader:
X-API-KEY: LA_TUA_CHIAVEHeader:
Authorization: Bearer LA_TUA_CHIAVE
Riferimenti:
3. Open PageRank API Key
Fornisce il PageRank (0-10) e il ranking globale dei domini. Usato per lo scoring automatico dei prospect. Il server funziona anche senza questa chiave (lo score resta manuale).
Passo 1 — Registrati
Vai su Open PageRank Signup
Inserisci nome, email e password
Clicca Sign Up
Conferma l'email di verifica
Passo 2 — Ottieni la API Key
Dopo il login, vai su Open PageRank Dashboard
La API key e visibile nella dashboard principale
Formato: stringa alfanumerica ~40 caratteri
Copia la chiave
Questa e la tua OPENPAGERANK_API_KEY.
Passo 3 — Verifica il funzionamento (opzionale)
curl -H "API-OPR: LA_TUA_CHIAVE" "https://openpagerank.com/api/v1.0/getPageRank?domains[]=google.com"Se funziona, vedrai il PageRank di google.com (dovrebbe essere ~10).
Free tier
Risorsa | Limite |
Richieste API | 10.000/ora |
Domini per richiesta (batch) | fino a 100 |
Costo | Gratuito, nessun piano a pagamento richiesto |
Autenticazione
La chiave va passata nell'header HTTP:
API-OPR: LA_TUA_CHIAVERiferimenti:
Related MCP server: LinkedIn Profile Data Mining
Inserire le chiavi
Metodo 1 — Dashboard (consigliato)
Apri la dashboard: https://backlink.calcolatorigratis.com/dashboard
Scorri fino alla sezione "Chiavi API" in fondo
Per ogni chiave:
Incolla il valore nel campo di testo
Clicca Salva
Clicca Test per verificare che funzioni
Le chiavi salvate dalla dashboard sono attive immediatamente (nessun restart necessario)
Metodo 2 — File .env
Modifica il file .env nella cartella del progetto:
GOOGLE_CSE_API_KEY=AIzaSy...
GOOGLE_CSE_CX=a1b2c3d4e5f6g7h8i
HUNTER_API_KEY=abc123...
OPENPAGERANK_API_KEY=xyz789...Dopo la modifica, rideploya con bash deploy.sh per applicare le modifiche.
Le chiavi inserite dalla dashboard hanno priorita su quelle nel
.env.
Riepilogo tempi di registrazione
API | Tempo | Difficolta | Note |
Open PageRank | ~2 minuti | Facile | Solo email + password |
Hunter.io | ~2 minuti | Facile | Solo email + password |
Google CSE | ~5 minuti | Media | Richiede progetto Google Cloud |
API gratuite aggiuntive (nessuna chiave richiesta)
Il server usa anche queste API che non richiedono registrazione:
API | Cosa fa | Limite |
Ranking dominio top-1M | Illimitato | |
Eta dominio (prima archiviazione) | ~15 req/min | |
WHOIS dominio (registrazione, scadenza) | ~100 req/ora | |
Score performance/SEO | 25.000/giorno |
Struttura file
backlink_server.py — Server ASGI + dashboard + API endpoints
backlink_tools.py — 20 tool MCP
database.py — SQLite schema + helpers
google_search.py — Google CSE API + scraping fallback
domain_metrics.py — Open PageRank + Tranco + Wayback + RDAP
email_discovery.py — Hunter.io email finder
tech_detection.py — CMS detection + PageSpeed Insights
email_client.py — SMTP/IMAP (Hostinger)
deploy.sh — Deploy automatico su CT102
.env — Configurazione produzioneTool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
LinkedIn + cold email outreach: find leads, launch personalized campaigns, manage replies.
Find perfect leads and run outreach campaigns on Linkedin, email, Instagram and more.
Find B2B leads, check every email, write and send campaigns and sort replies from your own AI.
Link-building outreach agent: find posts where you fit, approve pitches, read replies, track links.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables automated Gmail lead nurturing campaigns with intelligent follow-ups, response tracking, and 24/7 operation. Supports CSV-based contact management, template personalization, and real-time monitoring for enterprise-scale email outreach.2MIT
- AlicenseNot gradedqualityDmaintenanceEnables comprehensive LinkedIn profile search, data extraction, and contact enrichment using Google Search, Apollo.io, and AI-powered analysis. Includes automated data mining workflows with database storage and CSV export capabilities.3ISC
- AlicenseAqualityDmaintenanceEnables business analysis, compatibility checking, and marketing campaign creation using the B2Brilliant API. Tools allow discovering and refining business information from URLs and generating personalized outreach campaigns.76 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables autonomous B2B lead generation by discovering companies, scraping websites for contacts, decoding obfuscated emails, generating email permutations, and verifying email deliverability via MX and SMTP checks.2MIT