API pour la transformation web universelle

Une URL en entrée. Métadonnées, capture, PDF et contenu en sortie.

Omnillink est une API REST qui lit une page web à votre place : métadonnées normalisées, captures d’écran, export PDF, extraction sur mesure et texte lisible pour vos agents IA. Le code est ouvert, hébergez-la où vous voulez.

  • Licence MIT
  • Auto-hébergeable
  • Protection SSRF
  • OpenAPI 3.1

Voir le code sur GitHub

Une adresse, trois résultats

GET/api/v1/meta?url=example.com/blog/launch

Aperçu de lien

example.com

Launching the new editor

What changed in the editor, and how to migrate your documents.

Capture

Données

{
  "title": "Launching the new editor",
  "publisher": "Example Blog",
  "author": "Ada Example",
  "lang": "en",
  "date": "2025-03-04T09:00:00.000Z"
}

Réponses réelles de l’API, capturées sur une page de test.

Démo en direct

Essayez sur une vraie page

Aucune clé, aucune inscription. Chaque réponse affiche ce qui a été mesuré : durée, rendu, cache, identifiant et quota restant.

Requête

Exemples

Réponse

GET

Capacités

Chaque capacité, avec sa vraie sortie

Les miniatures sont des réponses réelles de l’API, capturées sur une page de test. Chaque carte mène à sa documentation et au bac à sable, déjà réglé.

Lire une page

  • example.com

    Launching the new editor

    What changed in the editor, and how to migrate your documents.

    Ada Example · Example Blog

    GET /meta

    Métadonnées et aperçu de lien

    Titre, description, image, auteur, date, JSON-LD et flux, fusionnés depuis Open Graph, Twitter Cards et le HTML.

  • # Launching the new editor
    
    Today we are releasing a **faster editor** with offline support. It took a year of work and a lot of [feedback](https://example.com/feedback).
    
    ## What changed
    
    - Instant search across documents
    - Offline mode with automatic sync
    - A new `export` command

    GET /content

    Contenu lisible

    Le texte principal en Markdown, sans menus ni publicités, avec le nombre de mots et les liens.

  • {
      "title": "Launching the new editor",
      "price": 49.9,
      "links": [
        "https://example.com/blog/launch",
        "https://example.com/pricing",
        "https://example.com/blog"
      ]
    }

    GET /extract

    Extraction sur mesure

    Vos champs, décrits par un sélecteur CSS, un attribut et un type. La réponse reprend vos noms.

  • {
      "headline": "Launching the new editor",
      "description": "What changed in the editor, and how to migrate your documents.",
      "author": "Ada Example",
      "publisher": "Example Blog",
      "datePublished": "2025-03-04T09:00:00.000Z"
    }

    GET /extract

    Modèles d’extraction

    Article, produit, recette, événement : des champs prêts à l’emploi, avec leur source.

  • PlanSeatsPrice (EUR)
    Solo19.90
    Team1049.90
    Company50199.00

    GET /tables

    Tableaux en JSON ou CSV

    Les tableaux HTML d’une page, lignes et en-têtes, prêts pour un tableur.

    • intHomeexample.com/blog/launch
    • intPricingexample.com/pricing
    • intBlogexample.com/blog

    GET /links

    Liens d’une page

    Tous les liens, internes et externes, avec leur texte et leurs attributs rel.

  • HTML rendu de la page de test
    text/plain · 2.3 kB

    GET /html

    HTML rendu

    Le HTML tel qu’un navigateur le voit après exécution des scripts, servi en texte brut.

  • type
    rich
    provider
    Example Blog
    title
    Launching the new editor
    size
    600 × 340

    GET /oembed

    Résolution oEmbed

    Le lecteur ou la carte qu’un site propose pour s’intégrer ailleurs, normalisé.

Capturer une page

  • GET /screenshot

    Capture d’écran

    Ordinateur ou mobile, page entière ou un seul élément, thème clair ou sombre, bandeaux masqués.

  • GET /animation

    Capture animée

    Un défilement de la page en image animée, sans encodeur vidéo.

  • PDF généré pour la page de test
    application/pdf · 28.5 kB

    GET /pdf

    Export PDF

    La page rendue avec sa feuille de style d’impression, en A4 ou Letter, portrait ou paysage.

    • 200https://example.com/blog/launch
    • EUNREACHABLEhttp://example.com:1/

    POST /meta/batch

    Métadonnées par lot

    Jusqu’à dix adresses en un appel. Chaque adresse a son propre résultat, réussi ou non.

Inspecter un site

    • highWordPress 6.5meta generator: WordPress 6.5
    • highVue.js 3.4.21asset: https://cdn.jsdelivr.net/npm/vue@3.4.21/dist/vue.global.prod.js
    • highjsDelivrasset: https://cdn.jsdelivr.net/npm/vue@3.4.21/dist/vue.global.prod.js

    GET /tech

    Technologies détectées

    CMS, bibliothèques et CDN reconnus, avec la version, le niveau de confiance et l’indice relevé.

  • TTFB
    7 ms
    FCP
    32 ms
    LCP
    32 ms
    CLS
    0
    requests
    1
    transfer
    2.7 kB

    GET /insights

    Mesures de page

    Poids par type, chronologie et indicateurs web, mesurés en laboratoire sur un chargement.

  • status
    200
    hops
    1
    time
    1 ms
    type
    text/html

    GET /check

    État d’un lien

    Statut, chaîne de redirections, durée et certificat d’une adresse.

  • robots.txt ✓
    5 URLs · 1 sitemap

    GET /sitemap

    Plan de site et robots.txt

    Les plans de site déclarés et leurs adresses, dans des limites fixes.

  • format
    png
    width
    1200 px
    height
    630 px
    size
    5.0 kB

    GET /favicon

    Icône d’un site

    La meilleure icône déclarée, avec ses dimensions et son poids réels.

  • format
    png
    width
    1200 px
    height
    630 px
    size
    5.0 kB

    GET /image

    Dimensions d’une image

    Format, largeur, hauteur et poids, lus dans l’en-tête du fichier.

  • #1f3b61 · #b7481f · #f3bd49 · #f2f5f7

    GET /palette

    Palette de couleurs

    Les couleurs dominantes d’une image, avec leur part de la surface.

Générer des ressources

  • GET /qr

    Code QR

    Le code QR d’une adresse, en SVG ou en PNG, aux couleurs de votre choix.

  • GET /og

    Image de partage

    Une image 1200 × 630 générée à partir d’un titre, d’un modèle et d’un thème.

Pour les agents IA

  • {
      "jsonrpc": "2.0",
      "id": 1,
      "method": "tools/call",
      "params": {
        "name": "omnillink_content"
      }
    }

    POST /mcp

    Point d’accès MCP

    Les fonctions de l’API exposées comme outils pour agents, sur POST /mcp.

  • {
      "format": "markdown",
      "citations": true,
      "wordCount": 115
    }

    GET /content

    Contenu lisible

    Le texte principal en Markdown, sans menus ni publicités, avec le nombre de mots et les liens.

Capturées le .

Ce qui se vérifie

Des preuves plutôt que des chiffres

Nous n’affichons ni volumes ni témoignages. Voici ce que vous pouvez contrôler vous-même.

  • Un modèle de sécurité publié

    La protection SSRF est décrite point par point, limites comprises. Les tests qui l’attaquent sont dans le dépôt, avec le reste de la suite.

    Lire la page Sécurité

  • Des mesures sur chaque réponse

    Durée, mode de rendu, état du cache, identifiant de requête et quota restant accompagnent chaque réponse. Le bac à sable les affiche tels quels.

    Ouvrir le bac à sable

  • Tout le produit est ouvert

    L’API, ce site, le SDK et l’outil en ligne de commande sont dans un seul dépôt, sous licence MIT. Rien n’est réservé à une offre payante.

    Voir le dépôt

  • Des limites choisies

    Omnillink n’exécute pas de code fourni par l’appelant : c’est un choix de sécurité. Ce qui précède une capture se décrit par des paramètres, pas par un script.

    Voir les limites et quotas

Fonctionnement

Comment ça marche

Trois étapes, une seule requête de votre côté.

  1. Étape 1

    Vous envoyez une URL

    Une requête GET avec l’adresse de la page et, si besoin, quelques options. Aucune clé n’est requise pour commencer.

  2. Étape 2

    Omnillink lit la page en sécurité

    L’adresse est validée contre les attaques SSRF, puis la page est lue en HTTP. Chromium ne prend le relais que si elle l’exige.

  3. Étape 3

    Vous recevez un résultat prêt à l’emploi

    Du JSON normalisé, une image ou un PDF. Le résultat est mis en cache pour les appels suivants.

HTTP d’abord, navigateur seulement si nécessaire

La page est d’abord lue par une simple requête HTTP. Chromium n’est lancé que si le résultat est pauvre ou si la page est une coquille d’application vide. Le champ meta.source vous dit quel chemin a été suivi.

  1. Lecture du cache
  2. Requête HTTP
  3. Extraction
  4. Rendu Chromium, si besoin
  5. Écriture en cache

Protection SSRF stricte

Les adresses privées, de bouclage et de métadonnées cloud sont refusées. En HTTP, la résolution DNS est épinglée à la connexion. Dans le navigateur, tout le trafic passe par un proxy interne qui contrôle chaque connexion, redirections comprises.

  • Cache et déduplication

    Les résultats sont mis en cache, en mémoire ou dans Redis. Des requêtes identiques reçues en même temps ne déclenchent qu’un seul traitement.

  • Un champ, directement dans une balise

    Avec embed=image.url, l’API redirige vers l’image de la page : la requête sert telle quelle de source à une balise img.

  • Erreurs stables

    Chaque échec porte un code stable, de EINVALIDURL à ETIMEOUT, et le statut HTTP qui lui correspond.

Intégration

Un cas d’usage, le code qui va avec

Choisissez un usage : le code minimal s’affiche à droite.

JavaScript
async function linkCard(url) {
  const params = new URLSearchParams({ url });
  const response = await fetch(`https://omnillink.kayzen-lyon.com/api/v1/meta?${params}`);
  const { status, data } = await response.json();
  if (status !== "success") return null;
  return { title: data.title, image: data.image?.url ?? null, site: data.publisher };
}

Le bac à sable génère le code de n’importe quelle requête en huit langages : curl, JavaScript, SDK TypeScript, Python, PHP, Go, Ruby et Rust.

Outils

Du terminal au composant

Ce qui existe aujourd’hui dans le dépôt, à construire depuis ses sources.

  • packages/sdk

    SDK TypeScript

    Un client typé, sans dépendance, pour le navigateur et Node.js.

    Lire le guide

  • packages/sdk

    Composant link-preview

    Un élément personnalisé qui affiche la carte d’aperçu d’une adresse.

    Lire le guide

  • packages/react

    Composant React

    <LinkPreview> et le hook useLinkMeta(), compatibles avec le rendu côté serveur.

    Lire le guide

  • packages/cli

    Ligne de commande

    La commande omnillink : métadonnées, captures, PDF, extraction et contenu depuis le terminal.

    Lire le guide

  • packages/mcp

    Serveur MCP

    Un serveur stdio pour Claude Code, Claude Desktop ou Cursor, et un point d’accès hébergé POST /mcp.

    Lire le guide

  • .github/actions

    Action GitHub

    L’aperçu d’une adresse, et sa capture si vous le demandez, dans le résumé d’un job.

    Lire le guide

Depuis le terminal

Quelques exemples tirés de l’aide de la commande. Elle lit aussi une liste d’adresses sur son entrée standard.

L’outil se construit depuis packages/cli. Il couvre aujourd’hui les commandes meta, shot, pdf, extract et content.

Terminal
omnillink meta https://github.com
omnillink meta https://github.com --json | jq .data.image.url
omnillink shot https://github.com -o github.png
cat urls.txt | omnillink meta --json --concurrency 8 > meta.ndjson
$ omnillink meta https://example.com/blog/launch
Launching the new editor
  https://example.com/blog/launch
  What changed in the editor, and how to migrate your documents.

  Publisher  Example Blog
  Author     Ada Example
  Date       2025-03-04
  Language   en
  Image      https://example.com/img/launch.png
  Favicon    https://example.com/img/launch.png
  Logo       https://example.com/img/launch.png
  Type       text/html
  http · 0 ms · cached

Sortie réelle de la commande, capturée sur la page de test.

Open source

Hébergez-la vous-même

Omnillink est distribué sous licence MIT. Il vous faut Node.js 22 ou plus récent ; Redis est facultatif.

  1. Récupérez le code

    Terminal
    git clone https://github.com/kayzen-lyon/linkforge.git
    cd linkforge
  2. Installez les dépendances et Chromium

    Terminal
    npm install
    npx playwright-core install chromium
  3. Créez votre configuration

    Terminal
    cp .env.example .env
  4. Démarrez l’API

    Terminal
    npm run dev

L’API écoute alors sur http://localhost:3000.

Une seule fonction suffit

Une fonction serverless peut servir à la fois l’API et ce site. La configuration pour Vercel est fournie dans le dépôt.

Redis quand vous en avez besoin

Sans Redis, le cache vit en mémoire, instance par instance. Ajoutez REDIS_URL pour le partager.

Tout se règle par l’environnement

Durées de cache, délais, concurrence du navigateur, limite de débit, ports autorisés : chaque réglage est une variable d’environnement.

Lire le guideVoir le dépôt sur GitHub

Votre instance, ou une API facturée à l’usage

Deux approches, chacune avec son coût. Voici la différence, sans enjoliver.

SujetVotre instance OmnillinkAPI hébergée facturée à l’usage
Coût par requêteVotre instance OmnillinkAucun. Vous payez votre hébergement.API hébergée facturée à l’usageFacturé à l’appel ou par palier.
Adresses luesVotre instance OmnillinkElles restent sur votre infrastructure.API hébergée facturée à l’usageElles transitent par un tiers.
Débits, délais, cacheVotre instance OmnillinkVous les réglez par variables d’environnement.API hébergée facturée à l’usageFixés par l’offre souscrite.
ExploitationVotre instance OmnillinkÀ votre charge : mises à jour, Chromium, supervision.API hébergée facturée à l’usageAssurée par le fournisseur.
CodeVotre instance OmnillinkOuvert et modifiable, licence MIT.API hébergée facturée à l’usageVariable selon le fournisseur.

FAQ

Questions fréquentes

Omnillink est-il gratuit ?

Le logiciel est libre, publié sous licence MIT : vous pouvez l’utiliser, le modifier et l’héberger vous-même. L’instance qui sert ce site est une démonstration, avec une limite de débit.

Faut-il une clé d’API ?

Non. L’API répond sans authentification. L’en-tête facultatif x-api-key relève la limite de débit ; les clés sont définies par l’exploitant de chaque instance.

Quelles pages Omnillink peut-il lire ?

Les pages publiques en http ou https. Les adresses privées, locales ou internes sont refusées par la protection SSRF. Les pages construites en JavaScript sont rendues dans Chromium quand c’est nécessaire.

Les résultats sont-ils à jour ?

Chaque résultat est mis en cache, une heure par défaut. Le paramètre ttl change cette durée pour une requête, et force=true relit la page immédiatement.

Puis-je utiliser une capture directement dans une balise image ?

Oui. /screenshot renvoie l’image elle-même, donc son adresse fonctionne dans un attribut src. Avec embed, /meta redirige de la même façon vers l’image ou l’icône d’une page.

Que faut-il pour l’héberger ?

Node.js 22 ou plus récent, et Chromium, installé par Playwright. Redis est facultatif. La configuration pour un déploiement en fonction serverless sur Vercel est incluse dans le dépôt.

Ce site me suit-il ?

Non. Il ne dépose aucun cookie et ne charge aucun outil de mesure d’audience. Vos préférences de thème, de langue et d’accessibilité restent dans votre navigateur. Le détail figure dans les mentions légales.

Essayez Omnillink sur vos propres liens

La démo tourne sur cette instance. Le code est sur GitHub si vous préférez l’héberger vous-même.

Raccourcis clavier

CtrlKou/
Ouvrir la recherche et les commandes
?
Afficher cette aide
←→
Passer d’un onglet à l’autre
Ctrl↵
Lancer la requête dans le bac à sable
Esc
Fermer un panneau ou un menu

Les raccourcis à une seule touche se désactivent dans les options d’accessibilité.