metacog

a tiny metadata retriever with metascraper

Usage

1. Launch server.
2. Request to server with site URL in url parameter.

Behavior

$ curl https://your-metacog-server/?url=https://github.com

returns

{
  "audio": null,
  "author": null,
  "date": "2026-01-01T00:00:00.000Z",
  "description": "Join the world’s most widely adopted, AI-powered developer platform where millions of developers, businesses, and the largest open source community build software that advances humanity.",
  "feed": null,
  "iframe": null,
  "image": "https://images.ctfassets.net/8aevphvgewt8/4pe4eOtUJ0ARpZRE4fNekf/f52b1f9c52f059a33170229883731ed0/GH-Homepage-Universe-img.png",
  "lang": "en",
  "logo": "https://github.com/fluidicon.png",
  "publisher": "GitHub",
  "title": "GitHub · Change is constant. GitHub keeps you ahead.",
  "url": "https://github.com/",
  "video": null
}

Run locally

• Requirements
  • Node.js 24.x
  • npm@11

$ npm i
$ npm run dev

Run locally with compose

• Requirements
  • Docker Desktop or equivalent

$ docker compose up

Use container image

See Container registry

Build Docker image

$ docker build .

Configuration

environment variables:

• PORT
  • Port to expose app
  • if undefined, 3000
• REDIS_URL
  • Redis/Valkey host for caching
  • if undefined, memory cache is used
• REDIS_TIMEOUT
  • Redis command timeout
  • in millisecond
• ALLOWED_ORIGIN
  • Allowed origins for CORS
  • Write in space-delimited regular expressions
  • Access-Control-Allow-Origin
  • set blank for Access-Control-Allow-Origin: *
• CACHE_TTL
  • Cache retention period for fetched data
  • in seconds
  • if undefined, 24hour
• CACHE_CHECK
  • Effective only with memory cache
  • Cache expiration check interval
  • in seconds
• EXPOSE_VERSION
  • Whether to expose the /version endpoint
  • Set to any non-empty value to enable the endpoint
  • if undefined or empty, endpoint is disabled

Deploy to Render

Render Blueprints (IaC) – Render Docs

1. Set up your account
2. Edit render.yaml
3. Commit & push
4. Apply it in Render dashboard

Deploy to Fly.io

1. Set up your account & app & cli
2. $ flyctl redis create (if you use Redis)
3. $ cp sample.fly.toml fly.toml
4. Enter your app name in fly.toml
5. $ npm run deploy