SeoPrimo in n8n.

Il modo più diretto: ogni endpoint dell'API REST è una chiamata HTTP.

Importare gli endpoint

n8n non legge un file OpenAPI da solo. Il modo rapido è il pulsante Import cURL del nodo HTTP Request: incolla la chiamata curl di un endpoint (la mostra la documentazione interattiva con «Try it out», e la trovi negli esempi della guida all'API) e il nodo si compila con metodo, indirizzo e corpo. Poi scegli la credenziale. Il file /api/v1/openapi.json è il contratto completo, utile se vuoi generare nodi o client con un generatore OpenAPI.

Aspettare un lavoro lungo

L'audit rapido si segue con un ciclo: Wait, poi GET /sites/{id}/audits e cerca l'audit per id, poi un IF che torna al Wait finché lo stato non è done o failed. I lavori lunghi (audit completo, controllo posizioni) si seguono allo stesso modo con GET /runs/{id}. Il primo workflow scaricabile fa esattamente questo, con un limite di circa 20 minuti.

Se il tuo n8n è raggiungibile da internet, i webhook evitano il ciclo: SeoPrimo ti avvisa quando il lavoro è finito.

Per reagire a un evento (Score cambiato, crediti bassi, report pronto) senza interrogare l'API. Il webhook di SeoPrimo firma ogni consegna: il tuo workflow deve controllare la firma sul corpo grezzo.

1. Nodo Webhook: Method POST, un Path a tua scelta, Respond = «Using 'Respond to Webhook' Node». Nelle Options attiva Raw Body.
2. Nodo Code con il codice qui sotto: ricalcola l'HMAC sul corpo grezzo e restituisce valid.
3. Nodo IF su valid: il ramo vero risponde 200 e continua, il ramo falso risponde 401 con Respond to Webhook.
4. Sul server n8n imposta la variabile d'ambiente NODE_FUNCTION_ALLOW_BUILTIN=crypto: il nodo Code può caricare il modulo crypto solo se è permesso.
5. Attiva il workflow, copia il Production URL del nodo Webhook e aggiungilo in Integrazioni, Webhook scegliendo gli eventi. Il segreto whsec_… si vede una sola volta: incollalo nel nodo Code.
6. Premi «Invia prova» sul webhook: arriva un evento test.

// Verify X-SeoPrimo-Signature on the RAW body (Webhook node: option "Raw Body" ON).
// Needs the env var NODE_FUNCTION_ALLOW_BUILTIN=crypto on the n8n server (or '*').
const crypto = require('crypto');

// Paste the endpoint secret (whsec_...) here, or expose it as the env var SEOPRIMO_WEBHOOK_SECRET.
let secret = 'whsec_REPLACE_WITH_YOUR_SECRET';
try { if ($env.SEOPRIMO_WEBHOOK_SECRET) secret = $env.SEOPRIMO_WEBHOOK_SECRET; } catch (e) { /* env access blocked */ }
const TOLERANCE_SECONDS = 300;

const item = $input.first();
const header = String(item.json.headers['x-seoprimo-signature'] || '');
const raw = await this.helpers.getBinaryDataBuffer(0, 'data'); // the bytes exactly as received

let valid = false;
try {
  const parts = Object.fromEntries(header.split(',').map((p) => p.split('=', 2)));
  const t = parseInt(parts.t, 10);
  const received = String(parts.v1 || '');
  const expected = crypto.createHmac('sha256', secret).update(`${t}.`).update(raw).digest('hex');
  const fresh = Math.abs(Date.now() / 1000 - t) <= TOLERANCE_SECONDS;
  valid = fresh
    && received.length === expected.length
    && crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(received));
} catch (e) {
  valid = false;
}

const event = valid ? JSON.parse(raw.toString('utf8')) : {};
return [{ json: { valid, id: event.id, type: event.type, created: event.created, data: event.data || {} } }];

Il valore whsec_REPLACE_WITH_YOUR_SECRET è un esempio di segnaposto: sostituiscilo con il segreto del tuo endpoint o leggilo da $env.SEOPRIMO_WEBHOOK_SECRET. Il codice è lo stesso della verifica Node della guida ai webhook.