Introduction

URL metadata for the things you build.

Linkoi turns a URL or supplied HTML into structured metadata. Use the TypeScript library in your server, or deploy the Hono-based Cloudflare Worker for an HTTP endpoint with caching.

Developer preview

Version 0.1.1 is available on npm. Install @linkoi/core to use the extraction library, or add @linkoi/worker for Cloudflare deployment.

import { resolve } from '@linkoi/core'

const page = await resolve('https://example.com')
console.log(page.title, page.description, page.image)

Choose a package#

Package	Purpose
`@linkoi/core`	Fetch, extract, and normalise metadata.
`@linkoi/worker`	HTTP API, KV caching, background refresh, and optional bearer authentication.

What you get#

Title, description, image, logo, publisher, author, date, language, and URL. Missing fields are null. The source field is fast for all new extractions.

What it does not do#

Linkoi does not render JavaScript, take screenshots, crawl sites, generate PDFs, return playable embeds, or extract article bodies. It reads metadata from the HTML a server returns.

Core is validated on Node.js 22 and Bun. The Worker targets Cloudflare. Other runtimes are not yet claimed as supported.