Signals Hub Installation

Set up your Signals Hub under your domain for SEO, AEO, and AI discovery — in minutes.

Why this works

Your Signals Hub lives under your domain so search engines and AI systems attribute everything to you.

Content is published under your domain (signals.yourdomain.com), so authority stays with your brand.
Your robots.txt and sitemap ensure crawlers and AI discovery engines can find and index your signals.
A footer link creates an always-fresh entry point from your main site to your latest signal.

DNS Setup (CNAME)

Point your Signals subdomain to our ingest endpoint with a CNAME record.

signals.yourdomain.com  →  CNAME  →  ingest.freshnews.ai

DNS propagation can take a short time.

robots.txt (Sitemap Discovery)

Add this line to your main site's robots.txt so crawlers can discover your signals sitemap.

Sitemap: https://signals.yourdomain.com/sitemap.xml

Footer Integration (Preferred) — Always Up-to-Date "Latest Signal"

We inject a link that always points to the most recent published signal.

Preferred: Dynamic Script (recommended)

<div id="freshnews-latest" class="freshnews-footer-pulse">
  <noscript>
    <a href="https://signals.yourdomain.com/en/latest" target="_blank" rel="noopener noreferrer">
      Latest Signal ↗
    </a>
  </noscript>
</div>

<style>
.freshnews-footer-pulse a{
  display:inline-block;
  max-width:11ch;
  white-space:nowrap;
  overflow:hidden;
  text-overflow:clip;
  position:relative;
  padding-right:1.1em;
}
.freshnews-footer-pulse a::after{
  content:"↗";
  position:absolute;
  right:0;
  top:50%;
  transform:translateY(-50%);
  opacity:.8;
  font-size:.9em;
}
</style>

<script
  src="https://signals.yourdomain.com/embed/footer-pulse.min.js"
  data-hub="https://signals.yourdomain.com"
  data-container="#freshnews-latest"
  data-lang="en"
  data-label="Latest Signal: "
  data-target="_blank"
></script>

The max-width is intentional to keep footers clean; the full title remains in the DOM for crawlers.

Fallback: Static Link (optional)

<a href="https://signals.yourdomain.com/en/latest" target="_blank" rel="noopener noreferrer">Latest Signal ↗</a>

Multi-Language Setup

If your site is available in multiple languages, use the snippet for each language. Select a tab to see the code for that locale.

<div id="freshnews-latest" class="freshnews-footer-pulse">
  <noscript>
    <a href="https://signals.yourdomain.com/en/latest" target="_blank" rel="noopener noreferrer">
      Latest Signal ↗
    </a>
  </noscript>
</div>

<style>
.freshnews-footer-pulse a{
  display:inline-block;
  max-width:11ch;
  white-space:nowrap;
  overflow:hidden;
  text-overflow:clip;
  position:relative;
  padding-right:1.1em;
}
.freshnews-footer-pulse a::after{
  content:"↗";
  position:absolute;
  right:0;
  top:50%;
  transform:translateY(-50%);
  opacity:.8;
  font-size:.9em;
}
</style>

<script
  src="https://signals.yourdomain.com/embed/footer-pulse.min.js"
  data-hub="https://signals.yourdomain.com"
  data-container="#freshnews-latest"
  data-lang="en"
  data-label="Latest Signal: "
  data-target="_blank"
></script>

Hochleistungsfunktionen

Stale-While-Revalidate

Sofortige Ladezeiten mit Frische. Das Widget zeigt gecachte Inhalte sofort an (0ms Verzögerung) und ruft dann frische Daten im Hintergrund für sanfte Updates ab.

Skeleton-Screens

Kein Layout-Shift. Das Widget zeigt animierte Skeleton-Screens während des Ladens anstelle von 'Lädt...'-Text für eine bessere wahrgenommene Leistung.

Paralleles Abrufen

Branding und Artikel werden parallel (nicht blockierend) abgerufen, sodass Artikel sofort gerendert werden, auch wenn die Branding-API langsam ist.

Wie Neue Artikel Erscheinen

Sofortiges Rendering (0ms Verzögerung)

Das Widget verwendet LocalStorage-Caching, um Inhalte sofort anzuzeigen. Beim ersten Besuch laden Artikel sofort aus dem Cache (0ms wahrgenommene Verzögerung), dann werden frische Daten im Hintergrund abgerufen.

Sanfte Aktualisierung

Die Hintergrundabfrage sorgt für Frische, ohne die Benutzererfahrung zu stören. Neue Artikel erscheinen nahtlos, wenn sie veröffentlicht werden, ohne Layout-Verschiebungen oder Ladeanzeigen.

Entdeckungsvorteil

💡 Warum dies für KI wichtig ist: Generative Maschinen (GEO) und Antwortmaschinen (AEO) suchen nach schnellen, autoritativen HTML-Strukturen. Der "Stale-While-Revalidate"-Ansatz unseres Widgets stellt sicher, dass KI-Crawler Ihren Inhalt sofort finden, während Ihre Benutzer eine sofortige Ladeerfahrung erhalten.

Zusätzliche Ressourcen

Für detaillierte API-Dokumentation siehe EMBED-API.md-Dokumentation. Für Fehlerbehebung kontaktieren Sie uns unter contact@freshnews.ai.

← Back to Installation Guide