Webアプリ・開発者向けAPI

Omnillink

入力はアドレス、出力はすぐに使えるデータ。自らの制限を明記し、すべてのレスポンスに計測値を添えるAPIです。

年
2026
技術スタック
TypeScript · Node.js · Fastify · Playwright · Redis · Tailwind · Vercel
  • API設計
  • バックエンド開発
  • アプリケーションセキュリティ
  • 開発者向けSDK・ツール
  • ドキュメント
  • 紹介サイト
https://omnillink.kayzen-lyon.com/
OmnillinkのWebサイトのトップページ――Webアプリ・開発者向けAPI、KAYZEN制作
/api/v1配下のルート。OpenAPI 3.1ドキュメントに記載
20
MCPでAIエージェントに公開している読み取り専用ツール
8
サイト上のCookieとアクセス解析ツール
0
ソフトウェアのライセンス。ご自身でホスティング
MIT
出発点

解決すべき課題。

背景

Omnillinkは、KAYZENがリヨンから提供しているAPIです。公開されているWebページのアドレスを送ると、そのメタデータ、スクリーンショット、PDFエクスポート、カスタム抽出したフィールド、またはMarkdown形式のコンテンツを返します。ソフトウェアはMITライセンスで配布されており、ご自身でホスティングして使います。サイトomnillink.kayzen-lyon.comはそのデモで、サンドボックスと、フランス語・英語のドキュメントを備えています。

制約

リンクのプレビューを表示する、ページをPDFで保存する、記事の本文をAIエージェントに渡す。どれも毎回同じ作業を必要とします。自分では管理していないページ、ときにはJavaScriptで組み立てられ、ときには保護されているページを、自分のネットワークをさらすことなく読み取る作業です。これを引き受けるホスティング型のAPIは呼び出しごとに課金し、読み取るアドレスもその事業者の目に触れます。必要だったのは、自分の環境にインストールでき、設定と制限が文書化されていて、内部ネットワークに到達するために悪用されることのないツールでした。

解決策

用途ごとにリクエストは1つ、そして読み取りの経路は無駄のないものにしました。ページはまず単純なHTTPリクエストで読み取り、結果が乏しい場合や、ページが空のアプリケーションシェルである場合にのみChromiumを起動します。どのアドレスも、接続の前にSSRF攻撃に対する検証を受けます。どのレスポンスも、何が起きたかを伝えます。所要時間、レンダリングモード、キャッシュの状態、リクエストID、残りのクォータです。サイトも同じルールに従っています。利用件数もお客様の声も掲載せず、APIの実際のレスポンスを見せています。

デザイン・アートディレクション

すべての判断に、理由がある。

  1. デモはトップページに

    訪問者はトップページでアドレスを入力し、キーも登録もなしで実際のリクエストを実行できます。開発者はAPIをそのレスポンスで判断します。所要時間、レンダリングモード、キャッシュの状態とともにすぐにレスポンスを見せれば、様子を知るためだけにアカウントを作る必要がなくなります。

  2. どの機能も実際の出力とともに紹介

    機能カードにイラストはありません。それぞれのカードが、テスト用ページで取得したAPIの実際のレスポンスを表示し、その機能のドキュメントと、設定済みのサンドボックスへ案内します。読み手は、コードを1行も書く前に、受け取ることになる正確なフォーマットを確認できます。

  3. 数字よりも証拠を

    この製品は公開されたばかりです。リクエスト件数やお客様の声を載せても、実態がありません。そのためサイトには掲載していません。代わりに、誰もが自分で確かめられるものを一覧にしたセクションがあります。公開しているセキュリティモデル、すべてのレスポンスに添えられる計測値、ライセンス、採用した制限です。

  4. コードを書いてくれるサンドボックス

    サンドボックスではすべてのパラメーターを操作でき、リクエストのコードを8つの言語で生成します。curl、JavaScript、TypeScript SDK、Python、PHP、Go、Ruby、Rustです。試してから最初の組み込みまでの道のりはコピー&ペーストだけになり、リファレンスを通読する必要はありません。

  5. KAYZENのデザインガイドライン、ライトテーマとダークテーマ

    見出しにはOutfit、本文にはPlus Jakarta Sans、色はネイビー、そして主要なアクションにはテラコッタ。サイトはkayzen-lyon.comのデザインガイドラインを踏襲し、このAPIがエージェンシーの製品だとわかるようにしています。ライトテーマ、ダークテーマ、システムのテーマは、表示オプションで選べます。

タイポグラフィ体系

見出し用書体

Outfit

本文用書体

Plus Jakarta Sans

kayzen-lyon.comの2つのフォントファミリーです。このAPIがエージェンシーの製品だとわかるようにしています。

エンジニアリング

その裏側にある技術。

  • TypeScript
  • Node.js
  • Fastify
  • Playwright
  • Redis
  • Tailwind
  • Vercel
  1. まずHTTP、ブラウザは必要なときだけ

    ページごとにChromiumを起動すると、時間もメモリもかかります。そこでページはまずHTTPリクエストで読み取って解析し、結果が乏しい場合、ページが空のアプリケーションシェルである場合、またはサイトがブロックページを返した場合にのみ、ブラウザが引き継ぎます。meta.sourceフィールドが、たどった経路を示します。

  2. 接続のたびにSSRF対策

    呼び出し元が指定したアドレスを訪問するAPIは、内部ネットワークに到達する手段として使われるおそれがあります。プライベートアドレス、ループバックアドレス、クラウドのメタデータ用アドレスは拒否され、DNS解決の結果は接続時に固定されます。ブラウザ内では、すべての通信が内部プロキシを経由して外に出ます。このプロキシは、リダイレクトも含めて接続のたびに検証をやり直します。

  3. 呼び出し元のコードは一切実行しない

    APIは、クライアントから送られたスクリプトを一切実行しません。キャプチャの前に行う操作は、パラメーターとCSSセレクターで記述します。クリックする、スクロールする、要素を待つ、といった操作です。機能が1つ少ないことになりますが、これは意図したものです。ブラウザ内で任意のコードを実行すれば、分離とSSRF対策に反してしまいます。

  4. 読み取るページにCookieも認証情報も送らない

    呼び出し元が設定できるヘッダーは、Accept-Language、User-Agent、Refererの3つだけです。CookieとAuthorizationは除外しています。レスポンスはアドレスごとにキャッシュされ、全員に配信されるからです。ある呼び出し元のセッションで取得したページが、次の呼び出し元に配信されてしまいます。

  5. キャッシュ、重複排除、ホスト単位のサーキットブレーカー

    結果はメモリまたはRedisにキャッシュされ、同時に届いた同一のリクエストは1回の処理しか起動しません。サーキットブレーカーは、ネットワークの失敗が何度か続いたホストへの接続をやめます。そのため、遅いページやアクセスの集中するページが、利用可能なブラウザを独占することはありません。

  6. 検証コードから生成するOpenAPIリファレンス

    OpenAPI 3.1ドキュメントのパラメーターは、ルートの検証スキーマから導き出しています。公開しているリファレンスは、サーバーが実際に受け付ける内容を記述しています。失敗にはそれぞれ、EINVALIDURLからETIMEOUTまでの安定したコードと、対応するHTTPステータスが付きます。クライアント側のコードは、メッセージを解析しなくても失敗を処理できます。

  7. AIエージェント向けのMCPエンドポイント

    読み取り専用の8つのツールを、POST /mcpで公開しています。これらはRESTのルートと同じサービスを通るため、同じチェックを受けます。ページのコンテンツを含む結果は、必ず警告から始まります。このテキストはWebから来たものであり、評価すべきデータであって、従うべき指示ではない、という警告です。

  8. 1つの関数がAPIとサイトの両方を配信

    Vercel上では、サイトをビルドしたうえでAPIのバンドルに組み込んでいます。1つの関数がすべてに応答します。リクエストの時間予算は既定で55秒で、関数の最大実行時間(60秒)をわずかに下回ります。プラットフォームに中断されるのではなく、API自身が読み取れるエラーで応答できるようにするためです。

SEO対策

検索で見つけてもらうための仕組み。

  1. 16ページ、それぞれフランス語と英語で

    サイトマップには32のアドレスが記載されています。トップページ、サンドボックス、APIリファレンス、10本のガイド、サービスの稼働状況、アクセシビリティ、法的表示で、2つの言語をhreflangタグで結んでいます。開発者が探すのは的を絞った答えです。そのため、1つのページのセクションにまとめるのではなく、テーマごとに専用のページを設けています。

  2. アシスタント向けのllms.txtファイル

    サイトは/llms.txtと/llms-full.txtを公開しています。前者はドキュメントの一覧で、ページごとに1行の要約が付き、後者はその全文を収めています。こうして、このAPIについて尋ねられたコーディングアシスタントは、パラメーターを推測するのではなく、最新のドキュメントを読むことができます。

  3. 構造化データ、そしてAPIはクロールの対象外

    トップページは、発行者、API(WebAPIタイプ)、ソフトウェア、そのよくある質問をJSON-LDで宣言しています。robots.txtファイルは/api/をクロールの対象から外しています。APIのレスポンスは他のサイトに関するデータであり、Omnillinkの名前でインデックスされるべきページではないからです。

  4. Cookieもアクセス解析もなし

    サイトはCookieを一切保存せず、アクセス解析ツールも読み込みません。テーマ、言語、アクセシビリティの設定はブラウザ内に残ります。そのため、ドキュメントを読む前に同意バナーを通過する必要がありません。

アクセシビリティ

誰もが使えるように。

2025年6月から、欧州アクセシビリティ法(European Accessibility Act)により、多くのオンラインサービスにデジタルアクセシビリティが義務づけられています。当社は後から対応するのではなく、設計段階から取り組んでいます。

  1. すべてのページにオプションパネル

    ボタンを押すと表示設定が開きます。文字サイズ、コントラスト強化、Atkinson Hyperlegibleフォント、行間、リンクの下線、アニメーションの軽減です。選んだ設定はブラウザに保存され、システムの設定に左右されず、すべてのページに適用されます。

  2. 確認したこと、確認していないこと

    アクセシビリティのページには、2026年11月18日に行った確認が一覧になっています。両方のテーマについて計算したコントラスト、自動操作のブラウザでのキーボード操作の確認、375ピクセル幅で横スクロールが発生しないこと。足りないものも明記しています。スクリーンリーダーでの試験は行っておらず、訓練を受けた人によるWCAGまたはRGAAの監査も行っていません。それを伝えることで、確認されていない適合性があるかのように思わせることを避けています。

サイト構成

納品したもの。

  • ホーム — ライブデモ、機能、仕組み、セルフホスト、よくある質問
  • サンドボックス — すべてのパラメーター、8つの言語で生成されるコード
  • APIリファレンス — ルート、パラメーター、エラー、クォータ、キャッシュ
  • ガイド — はじめに、セルフホスト、SDK、AIエージェント、レシピ、セキュリティ、制限
  • サービスの稼働状況
  • アクセシビリティ、法的表示、プライバシー
進め方

プロジェクトの流れ。

  1. 基本のAPI

    メタデータ、スクリーンショット、PDF、抽出、読みやすいコンテンツ。アドレスの検証、キャッシュ、Vercel上の単一の関数としてのデプロイ。

  2. 堅牢化

    リダイレクトも含め、ブラウザの接続を1つずつ検証する内部プロキシ。未知のパラメーターは拒否せずに無視。

  3. 開発者向けツール

    TypeScript SDK、コマンドライン、MCPサーバー、Reactコンポーネント、GitHubアクション、組み込みのサンプル。

  4. サイトと公開

    サンドボックス、ガイド、検索、英語版、ホスティングされたMCPエンドポイント、変更履歴。2026年11月に公開。

Q&A

よくいただくご質問。

ソフトウェアはMITライセンスで配布されています。利用、改変、セルフホストが可能で、ご自身のホスティング費用のほかにリクエストごとの費用はかかりません。サイトを動かしているインスタンスはデモであり、レート制限があります。

いいえ。APIは認証なしで応答します。任意のx-api-keyヘッダーを付けるとレート制限が引き上げられ、キーは各インスタンスの運用者が定義します。既定では、制限はキーなしで1ウィンドウあたり60リクエスト、キーありで600リクエストです。

httpまたはhttpsの公開ページです。プライベート、ローカル、内部のアドレスは、SSRF対策によって拒否されます。JavaScriptで組み立てられたページは、必要な場合にChromiumでレンダリングされます。サイトがブロックページで応答した場合、APIはそのページをコンテンツとして返すのではなく、エラーとして知らせます。

Node.js 22以降と、PlaywrightがインストールするChromiumです。Redisは任意です。Redisがない場合、キャッシュとクォータのカウンターは、インスタンスごとにメモリ上に置かれます。運用はホスティングする側の責任です。アップデート、Chromium、監視が含まれます。

同じ水準のこだわりを、あなたのサイトにも。

現在のサイトの無料診断、24時間以内のお見積もり、そして今お読みいただいたような書面での解説をお届けします。3回分割払い(手数料無料)に対応し、利用できる地域の補助金は契約前に確認します。

共有