Do I have to use Next.js?

No. GitHub works with any blog built from Markdown or MDX files (Astro, Hugo, Jekyll, Gatsby…), and the webhook is a signed POST to any HTTPS URL, so it works with any stack, and with Zapier, Make or n8n. The Next.js route handler on the integrations page is just a ready-made example.

Can I pull articles instead of receiving them?

Yes. Create an API key on the Developers page and read articles (markdown, HTML, sources, FAQ) with the REST API v1.

How do I verify the webhook?

Check the X-Citable-Signature header (t=…,v1=…) with HMAC-SHA256 over “t.body” using the secret shown once when you connect, and reject timestamps older than 5 minutes. Your endpoint must answer within 10 seconds.

Will AI crawlers read my Next.js site?

If the pages are rendered on the server or statically, yes, unless robots or noindex block them. Citable’s weekly audit checks both from outside.

Can Citable promise AI will cite my site?

No, and nobody can. Citable measures every week how often each AI mentions and cites you, with a confidence range, publishes sourced articles for the gaps and shows when a published URL starts being cited.

Piattaforme · Next.js

Il tuo sito Next.js o personalizzato, citato dalla ricerca IA.

Su un sito personalizzato, tutto ciò che serve ai crawler dell'IA si trova nel tuo codice. Il controllo di Citable ti indica quale file modificare, misura se l'IA ti cita e invia articoli basati su fonti direttamente al tuo blog: come pull request con un file Markdown o MDX nel tuo repository, oppure tramite un webhook firmato o l'API REST.

Inizia la prova gratuita di 14 giorni Vedi i prezzi

Perché l'IA cita (o ignora) i siti Next.js

La maggior parte dei crawler AI non esegue JavaScript. Una pagina renderizzata lato server (o generata staticamente) fornisce loro il testo completo; una pagina che si carica nel browser fornisce solo un guscio vuoto. Con Next.js puoi scegliere pagina per pagina, quindi vale la pena controllare.

Quando il controllo rileva Next.js, comunica direttamente con chi scrive il codice: per ogni problema indica esattamente dove intervenire (app/robots.ts, i metadati della pagina, app/sitemap.ts...). La misurazione settimanale mostra quindi a quali domande l'IA risponde citando pagine altrui, e Citable redige gli articoli.

Cosa ostacola l'indicizzazione su Next.js

L'audit settimanale di Citable riconosce Next.js e, per ogni problema, ti fornisce i passaggi direttamente in Next.js.

Contenuto che appare solo con JavaScript

Se il testo arriva dopo un fetch lato client, il controllo rileva una shell JavaScript vuota o poco testo. Esegui il rendering sul server o genera le pagine in modo statico.

robots, sitemap e llms.txt nel codice

robots in app/robots.ts (o public/robots.txt), la sitemap in app/sitemap.ts e llms.txt in public/llms.txt. Il controllo ti fornisce le regole robots corrette nel caso in cui un crawler di ricerca AI risulti bloccato.

noindex impostato in modo troppo esteso

Il campo robots nei metadati di una pagina, o un header X-Robots-Tag in next.config, può nascondere le pagine che vuoi far citare. Rimuovilo solo su quelle specifiche pagine, mai in app/layout.tsx: le pagine di accesso, carrello o ricerca devono mantenere il loro.

Metadati, canonical e lingua

Titolo e descrizione nei metadati di ogni pagina, il canonical in alternates.canonical, la lingua in <html lang> in app/layout.tsx e un solo <h1> per pagina.

Controlla subito il tuo robots.txt per i crawler IA, gratuitamente

Connetti Next.js a Citable

Richiede pochi minuti. Ogni articolo arriva poi nel tuo CMS, come bozza o pubblicato autonomamente, a seconda di come imposti la pubblicazione.

1
Crea il tuo account Citable e aggiungi il tuo sito: sito web, concorrenti e domande degli acquirenti.
2
Apri Impostazioni → CMS per quel sito e scegli Next.js.
3
Installa l'app GitHub di Citable nel repository del tuo sito.
4
Controlla la cartella dei post e l'indirizzo del tuo blog: li rileviamo dai tuoi post esistenti.
5
Connetti. Ogni articolo arriva come una pull request.
6
Nella stessa scheda, scegli come pubblicare gli articoli: programmati con una finestra di approvazione o solo come Bozze.

Cosa ti serve

Un blog che legge file Markdown o MDX dal repository
L'app Citable di GitHub installata su quel repository (Integrazioni)

Cosa pubblica Citable su Next.js

Bozza o pubblicato

Una bozza è una pull request aperta: effettua il merge e sarà online. Con la pubblicazione automatica, Citable esegue il merge alla scadenza della finestra di approvazione (senza mai superare le protezioni del tuo branch). Hai un blog in un database? Usa il webhook firmato o l'API v1.

Annulla pubblicazione da Next.js

Se il tuo blog legge file Markdown o MDX dal repository, connetti GitHub: ogni articolo arriverà come pull request nella tua cartella dei post, con le chiavi frontmatter che già utilizzi; l'unione della pull request pubblicherà il contenuto (con la pubblicazione automatica, Citable effettua il merge allo scadere della finestra di approvazione, rispettando sempre le protezioni del tuo branch). Se il tuo blog legge da un database, il webhook invia titolo, slug, sommario, HTML e markdown, JSON-LD (Article e FAQPage), immagini con relativo alt text, fonti, lingua, tag e data, il tutto firmato con X-Citable-Signature. Invia “publicar: false” a meno che non sia attiva la pubblicazione automatica (che è attiva di default, con la sua finestra di approvazione); il tuo ricevitore decide come procedere e risponde con l'id (e l'URL se la pagina viene pubblicata).

Campi che compiliamo

Un file Markdown o MDX nella tua cartella dei post (content/blog, posts…)
Frontmatter con le chiavi che i tuoi post utilizzano già: titolo, descrizione, data, tag, immagine…
Corpo in Markdown, con le relative immagini collegate dallo storage di Citable

FAQ

Citable su Next.js: domande

Le domande che le persone pongono prima di iniziare. Se manca qualcosa, scrivici.

Scrivici

Devo usare Next.js?

No. GitHub funziona con qualsiasi blog creato da file Markdown o MDX (Astro, Hugo, Jekyll, Gatsby...), e il webhook è una richiesta POST firmata verso qualsiasi URL HTTPS, quindi è compatibile con qualsiasi stack e con Zapier, Make o n8n. Il route handler di Next.js nella pagina delle integrazioni è solo un esempio pronto all'uso.

Posso estrarre gli articoli invece di riceverli?

Sì. Crea una chiave API nella pagina Developers e leggi gli articoli (markdown, HTML, fonti, FAQ) con la REST API v1.

Come verifico il webhook?

Verifica l'header X-Citable-Signature (t=…,v1=…) con HMAC-SHA256 su “t.body” usando il segreto mostrato una sola volta al momento della connessione, e rifiuta i timestamp più vecchi di 5 minuti. Il tuo endpoint deve rispondere entro 10 secondi.

I crawler AI leggeranno il mio sito Next.js?

Se le pagine sono renderizzate lato server o staticamente, sì, a meno che non siano bloccate da robots o noindex. L'audit settimanale di Citable verifica entrambi dall'esterno.

Citable può garantire che l'AI citerà il mio sito?

No, e nessuno può farlo. Citable misura ogni settimana quanto spesso ogni IA ti menziona e ti cita, con un intervallo di confidenza, pubblica articoli basati su fonti per colmare le lacune e mostra quando un URL pubblicato inizia a essere citato.

Altre domande?Rispondiamo noi stessi, solitamente in giornata.

Scopri cosa dice l'IA di te prima di collegare qualsiasi cosa.

Inizia la prova gratuita di 14 giorni Ottieni il report gratuito