Sur cette page

Omnillink pour les agents IA

Un modèle de langage lit mal le HTML brut : menus, scripts et bandeaux noient le texte. /content lui donne la partie lisible de la page.

Du Markdown en une requête

Terminal
curl "https://omnillink.kayzen-lyon.com/api/v1/content?url=https%3A%2F%2Fexample.com%2Fblog%2Flaunch&format=markdown"
  • format=json (défaut) renvoie title, excerpt, text, markdown, wordCount, readingTimeMinutes, ainsi que les liens et les images du contenu.
  • format=markdown et format=text renvoient le texte seul, prêt à insérer dans un prompt.
  • citations=true remplace les liens par des renvois numérotés, avec la liste des adresses à la fin.
  • mainContent=false garde toute la page au lieu du seul contenu principal ; include et exclude acceptent des sélecteurs CSS.

Maîtriser la taille

Le texte et le Markdown sont coupés à 500 000 caractères ; le champ truncated le signale. wordCount vous permet d’estimer le coût d’un appel avant d’envoyer le texte à un modèle.

En faire un outil

Le document OpenAPI décrit chaque point d’accès avec ses paramètres : la plupart des cadres d’agents savent en tirer une définition d’outil.

Terminal
curl "https://omnillink.kayzen-lyon.com/api/v1/openapi.json"

Serveur MCP

Le Model Context Protocol permet à un agent d’appeler Omnillink comme une série d’outils. Deux façons de s’y brancher : un point d’accès hébergé par l’instance, et un serveur local lancé par votre client.

Point d’accès hébergé

POST /mcp parle le transport HTTP sans état : un message JSON-RPC 2.0 par requête, une réponse JSON, sans session. Méthodes : initialize, ping, tools/list et tools/call. Un appel d’outil compte pour une requête du quota ; x-api-key est prise en compte.

Terminal
curl -X POST "https://omnillink.kayzen-lyon.com/mcp" \
  -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Serveur local (stdio)

Le paquet @omnillink/mcp, dans packages/mcp, est un serveur MCP sur stdio, lancé par votre client. Il demande Node.js 20 ou plus récent.

OutilSert àRenvoie
omnillink_contentSert àLire un article ou une page de documentationRenvoieMarkdown, en plusieurs parties si le texte est long
omnillink_metaSert àIdentifier un lien : titre, description, image, fluxRenvoieJSON
omnillink_extractSert àRelever des valeurs précises avec des sélecteurs CSSRenvoieJSON
omnillink_screenshotSert àVoir une pageRenvoieUne image
omnillink_pdfSert àConserver une page comme fichierRenvoieLe chemin du PDF enregistré
Claude Code
claude mcp add \
  --env OMNILLINK_URL=https://links.example.com \
  --env OMNILLINK_API_KEY=your-key \
  omnillink -- npx -y @omnillink/mcp
Claude Desktop, Cursor
{
  "mcpServers": {
    "omnillink": {
      "command": "npx",
      "args": [
        "-y",
        "@omnillink/mcp"
      ],
      "env": {
        "OMNILLINK_URL": "https://links.example.com",
        "OMNILLINK_API_KEY": "your-key"
      }
    }
  }
}
  • Claude Desktop : Réglages, Développeur, Modifier la configuration (claude_desktop_config.json).
  • Cursor : ~/.cursor/mcp.json pour tous les projets, ou .cursor/mcp.json pour un seul.
  • OMNILLINK_URL désigne votre instance ; sans elle, le serveur utilise l’instance de démonstration. OMNILLINK_API_KEY exige OMNILLINK_URL : le serveur refuse d’envoyer une clé à l’instance par défaut.
  • Depuis une copie du dépôt, remplacez npx -y @omnillink/mcp par node /chemin/absolu/vers/packages/mcp/dist/bin.js. La publication du paquet sur le registre npm n’est pas confirmée à ce jour.

Fichiers llms.txt

Ce site publie /llms.txt, un sommaire de la documentation, et /llms-full.txt, qui en contient le texte complet en un seul fichier.

Le contenu extrait vient d’un site tiers. Traitez-le comme une donnée non fiable : il peut contenir des instructions destinées à détourner un agent.

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é.