Come collegare Semrush a Claude via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Semrush, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Semrush + Claude

Dai alla tua AI i dati SEO di Semrush: panoramica del dominio e storico, keyword organiche e a pagamento, concorrenti, keyword gap, volume, difficoltà e idee di keyword, posizionamenti e backlink degli URL, con il costo in API unit di ogni report.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

SEMRUSH_API_KEY

Step 1 — Ottieni le credenziali

1. L'accesso all'API richiede un abbonamento Semrush SEO Business più un pacchetto di API unit, da acquistare in Subscription info → API units (https://www.semrush.com/accounts/subscription-info/api-units/). Un nuovo piano Business parte con zero unit.
2. Apri https://www.semrush.com/accounts/api-keys/active e copia una API key v3 attiva.
3. Incollala in SEMRUSH_API_KEY e installa il connettore. La chiave viene salvata cifrata, il connettore la aggiunge a ogni richiesta e la invia solo a semrush.com.
4. Inizia con semrush_get_api_units: è gratuito e mostra quante API unit restano alla chiave.

Addebitato sulle tue API unit Semrush: ogni report consuma API unit del tuo account Semrush, in base alle righe restituite. Costa 10 unit a riga per la panoramica del dominio e il suo storico, le keyword organiche, le pagine posizionate, le keyword di un URL e la top 100 di Google di una keyword (10 per keyword nella panoramica in batch); 20 a riga per le keyword a pagamento e le idee a corrispondenza generica; 40 a riga per i concorrenti organici, le keyword correlate, le keyword a domanda, i backlink e i domini di riferimento (40 a richiesta per la panoramica dei backlink); 50 a keyword per la Keyword Difficulty; e 80 a riga per il Keyword Gap. I dati storici con display_date costano cinque volte tanto. I report restituiscono 10 righe, a meno che tu non ne chieda di più, e l'AI alza il limite solo quando serve davvero. Meno colonne danno una risposta più breve, ma non abbassano il prezzo. Quando le unit non bastano, Semrush restituisce solo le righe già pagate.

Attenzione al report delle keyword su tutti i paesi: semrush_keyword_overview_all_databases restituisce una riga per paese e non si può limitare: circa 140 righe, fino a 1.400 unit. Per un solo mercato, semrush_keyword_overview costa 10.

Cosa fa: la Domain Overview e il suo storico mensile, in un paese o in tutti; Organic Research e Advertising Research (le keyword per cui un dominio si posiziona o su cui compra annunci Google Ads); i concorrenti organici e le pagine che si posizionano; il Keyword Gap tra un massimo di cinque domini (keyword in comune, mancanti, uniche e non sfruttate); volume, CPC, concorrenza, intento, trend e Keyword Difficulty di una keyword o di un massimo di 100 alla volta; keyword correlate, a corrispondenza generica e a domanda; la top 100 di Google registrata da Semrush per una keyword; le keyword di un singolo URL; e Backlink Analytics con Authority Score, backlink e domini di riferimento. Tutti i tool sono in sola lettura.

Database e filtri: database è un codice paese di due lettere (us, uk, de, it, fr, es e altri). I database mobile (mobile-us) ed estesi (us-ext) esistono solo per i report di dominio. Filtri come "volume superiore a 1.000" o "posizioni da 1 a 10" vengono inviati nella sintassi di filtro di Semrush, codificati dal connettore.

Come leggere le risposte: Semrush risponde in CSV separato da punto e virgola, con una riga di intestazione e i suoi codici di colonna (Ph keyword, Po posizione, Nq volume di ricerca, Cp CPC in USD, Kd Keyword Difficulty, In intento e così via). L'AI interpreta i codici per te.

Errori comuni: ERROR 50 :: NOTHING FOUND significa che Semrush non ha dati per questo dominio, questa keyword o questo database; controlla l'ortografia e il database invece di riprovare. ERROR 120, 122 o 402: la API key è sbagliata; copiala di nuovo. ERROR 130 :: API DISABLED: l'abbonamento non include l'accesso all'API. ERROR 132: API unit esaurite (i report sui backlink lo restituiscono anche per una chiave che Semrush non conosce). ERROR 133: il piano non include questo database. ERROR 429: troppe richieste contemporaneamente; aspetta un momento.

Il connettore non copre Projects, Position Tracking e Site Audit, la Trends API (traffico), le API Local e Listing Management, né i report su sottodomini e sottocartelle.

Step 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Aggiungi il connettore in Claude

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Percorso consigliato: funziona su claude.ai web senza toccare alcun file di configurazione.

1. In Claude apri Customize → Connectors.
2. Clicca + e poi Add custom connector.
3. Inserisci un nome, ad esempio Semrush, e l'URL del server MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, poi clicca Add.
4. Clicca Connect e accedi ad AnythingMCP (OAuth) per consentire l'accesso.

Tutti i tool sotto compaiono nella tua chat: inizia a scrivere prompt.

Tool disponibili

Esempi di prompt

• "Dammi la panoramica del dominio Semrush di example.it nel database italiano e come è cambiato il suo traffico organico mese per mese quest'anno."
• "Fai un keyword gap tra example.it, concorrente-a.it e concorrente-b.it nel database italiano: per quali keyword loro sono in top 10 e noi no? 20 righe."
• "Trova le keyword a domanda intorno a 'pompa di calore' con più di 500 ricerche al mese, poi controlla la loro keyword difficulty."
• "Mostrami la panoramica dei backlink e l'Authority Score di concorrente-a.it e i suoi 20 domini di riferimento più forti."
• "Quante API unit Semrush ci restano?"

FAQ

Funziona con Claude Code come con Claude Desktop? Sì, punta entrambi a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Prossimi passi

• Landing del connettore
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Meta Muse