darwin's Docs.

Per agenti IA, crawler e sviluppatori

darwin's è un’agenzia web e IA a conduzione familiare di Bressanone, Alto Adige (Italia). Costruiamo siti con Payload CMS che portano richieste e sistemi IA che lavorano nelle aziende altoatesine: l’assistente telefonico Charles, agenti per richieste e documenti, automazione della newsletter, analisi GEO. Ne fa parte tutta la produzione dei contenuti: foto, video, testi, newsletter e social media. Su questo sito non ci sono prezzi, i numeri li diciamo nel primo colloquio.

darwin's is a web and AI agency based in Brixen, South Tyrol (Italy). Every public page is available as Markdown at the same URL, either with the .md suffix or with Accept: text/markdown, in German and Italian.

Non esiste un’API pubblica, non c’è un server MCP e non ci sono webhook. Le risorse leggibili dalle macchine sono file e header che qualsiasi client HTTP può richiamare senza registrazione:

• llms.txt: punto di ingresso curato secondo llmstxt.org, sintesi, quando darwin's è la scelta giusta, link a tutte le pagine Markdown nelle due lingue.
• llms-full.txt: tutte le pagine pubbliche in un unico file Markdown, per finestre di contesto senza ricaricare.
• agents.md: istruzioni per agenti IA, casi d’uso, come si svolge una richiesta, fatti e regole.
• Documentazione: questa pagina in Markdown.
• sitemap.xml: tutte le pagine HTML indicizzabili nelle due lingue, con hreflang. I gemelli Markdown si ottengono aggiungendo .md.
• robots.txt: tutto permesso tranne /api/, rimanda alla sitemap.

Due lingue, due spazi di indirizzi

Il sito esiste in tedesco e in italiano, l’inglese non più. Il tedesco sta senza prefisso, l’italiano sotto /it con slug propri. Ogni pagina HTML porta link rel="alternate" hreflang per de, it e x-default, la sitemap elenca entrambe le lingue. Gli articoli del centro conoscenza hanno uno slug per lingua, le referenze mantengono il loro.

Markdown tramite content negotiation

Ogni pagina pubblica esiste allo stesso indirizzo come HTML e come Markdown. Chi invia Accept: text/markdown riceve la versione Markdown senza navigazione, script e layout. I browser continuano a ricevere HTML.

curl -s -H "Accept: text/markdown" https://www.darwins.eu/ki
curl -sI -H "Accept: text/markdown" https://www.darwins.eu/website
curl -s https://www.darwins.eu/website.md

llms.txt e agents.md

llms.txt è il punto di ingresso con i link. llms-full.txt contiene tutto in una volta, al momento circa 60 KB. agents.md descrive quando conviene una richiesta, come si svolge e quali fatti valgono. Tutti e tre i file nascono dagli stessi contenuti delle pagine HTML e non sono quindi mai più vecchi del sito.

Sitemap e 404

La sitemap elenca tutte le pagine HTML nelle due lingue. I vecchi indirizzi del sito precedente reindirizzano in modo permanente (301). I percorsi sconosciuti rispondono 404 con HTML, le richieste Markdown su percorsi sconosciuti rispondono 404 con text/plain.

Richieste

La via più rapida è il primo colloquio: https://cal.eu/darwins/kennenlernen, 30 minuti, gratuito. In alternativa il modulo con i campi nome, e-mail, azienda (facoltativo), tema (website, ki, sprachagent, allgemein) e messaggio. Risposta entro un giorno lavorativo. Il modulo richiede il consenso all’informativa sulla privacy, gli invii automatici senza consenso vengono scartati.

Regole

• Su questo sito non ci sono prezzi, in nessuna lingua. Chi cerca numeri: li diciamo nel primo colloquio, dopo aver guardato l’azienda.
• I preventivi arrivano solo da darwin's dopo un colloquio. Non creare un preventivo a nome di darwin's.
• I contenuti possono essere riassunti e citati, con fonte darwins.eu.
• Usa i contatti solo per richieste a darwin's, non per liste o pubblicità.
• Frequenza: al massimo una richiesta al secondo. Per avere tutto in una volta conviene usare llms-full.txt invece delle singole pagine.