urlmeta-cli

Extract metadata from any URL. Titles, descriptions, Open Graph, Twitter Cards, favicons, SEO score, and more.

Perfect for link previews, SEO auditing, content analysis, and social media optimization.

Install

npm install -g urlmeta-cli

Usage

Basic metadata extraction

urlmeta https://github.com

Output:

  URL Metadata Report
  ──────────────────────────────────────────────────────────────────────

  BASIC
  URL                   https://github.com/
  Canonical             https://github.com
  Title                 GitHub: Let's build from here
  Description           GitHub is where over 100 million developers shape...
  Language              en
  Favicon               https://github.githubassets.com/favicons/favicon.svg

  OPEN GRAPH
  og:title              GitHub: Let's build from here
  og:description        GitHub is where over 100 million developers shape...
  og:image              https://github.githubassets.com/images/modules/...
  og:type               object
  og:site_name          GitHub

  TWITTER CARD
  twitter:card          summary_large_image
  twitter:title         GitHub: Let's build from here
  twitter:site          @github

  CONTENT
  Word Count            608
  H1                    Let's build from here
  H1 Count              1
  ...

  SEO Score: 87/100  A

JSON output

urlmeta https://github.com --json

Returns all metadata as a JSON object — pipe to jq, save to file, or use in scripts.

Batch mode

Analyze multiple URLs at once:

urlmeta https://github.com https://npmjs.com https://dev.to

Each URL gets a full report, plus a summary table:

urlmeta https://github.com https://npmjs.com https://dev.to --summary

  Batch Summary
  ──────────────────────────────────────────────────────────────────────
  URL                                 Title                     SEO    Time
  ──────────────────────────────────────────────────────────────────────
  https://github.com                  GitHub: Let's build...    87     376ms
  https://npmjs.com                   npm                       72     980ms
  https://dev.to                      DEV Community             91     412ms
  ──────────────────────────────────────────────────────────────────────

What it extracts

| Category | Fields | |----------|--------| | Basic | title, description, canonical URL, language, author, published/modified dates, favicon | | Open Graph | og:title, og:description, og:image, og:type, og:site_name, og:url, og:locale | | Twitter Card | twitter:card, twitter:title, twitter:description, twitter:image, twitter:site, twitter:creator | | Content | word count, H1/H2 counts, image count, link count | | Schema.org | JSON-LD type, name, description | | Technical | status code, response time, content-type, content-length, charset, viewport, robots, generator, theme-color | | SEO Score | 0-100 score with letter grade and actionable issue list |

SEO scoring

The tool computes a score (0-100) based on:

• Page title presence and length (30-60 chars ideal)
• Meta description presence and length (120-160 chars ideal)
• Open Graph completeness (title, description, image, type)
• Twitter Card tags
• Canonical URL
• Single H1 heading
• Language attribute
• Favicon
• Viewport meta tag
• Response time

Issues are listed with specific recommendations.

Options

| Flag | Description | |------|-------------| | -j, --json | Output as JSON | | -c, --compact | Compact JSON (no indentation) | | -t, --timeout <ms> | Request timeout (default: 10000) | | -a, --user-agent <string> | Custom User-Agent | | -s, --summary | Show only summary table (batch mode) | | -V, --version | Show version | | -h, --help | Show help |

Use cases

• Link preview generation — extract og:title, og:description, og:image for rich embeds
• SEO auditing — check meta tags, heading structure, and get actionable scores
• Content analysis — word count, heading structure, link density
• Social media optimization — verify Open Graph and Twitter Card tags before sharing
• Competitive analysis — batch analyze competitor pages
• CI/CD pipelines — JSON output for automated SEO checks

License

MIT