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
curl "https://omnillink.kayzen-lyon.com/api/v1/content?url=https%3A%2F%2Fexample.com%2Fblog%2Flaunch&format=markdown"
format=json(défaut) renvoietitle,excerpt,text,markdown,wordCount,readingTimeMinutes, ainsi que les liens et les images du contenu.format=markdownetformat=textrenvoient le texte seul, prêt à insérer dans un prompt.citations=trueremplace les liens par des renvois numérotés, avec la liste des adresses à la fin.mainContent=falsegarde toute la page au lieu du seul contenu principal ;includeetexcludeacceptent 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.
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.
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.
| Outil | Sert à | Renvoie |
|---|---|---|
omnillink_content | Sert àLire un article ou une page de documentation | RenvoieMarkdown, en plusieurs parties si le texte est long |
omnillink_meta | Sert àIdentifier un lien : titre, description, image, flux | RenvoieJSON |
omnillink_extract | Sert àRelever des valeurs précises avec des sélecteurs CSS | RenvoieJSON |
omnillink_screenshot | Sert àVoir une page | RenvoieUne image |
omnillink_pdf | Sert àConserver une page comme fichier | RenvoieLe chemin du PDF enregistré |
claude mcp add \
--env OMNILLINK_URL=https://links.example.com \
--env OMNILLINK_API_KEY=your-key \
omnillink -- npx -y @omnillink/mcp
{
"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.jsonpour tous les projets, ou.cursor/mcp.jsonpour un seul. OMNILLINK_URLdésigne votre instance ; sans elle, le serveur utilise l’instance de démonstration.OMNILLINK_API_KEYexigeOMNILLINK_URL: le serveur refuse d’envoyer une clé à l’instance par défaut.- Depuis une copie du dépôt, remplacez
npx -y @omnillink/mcpparnode /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.