Metadata debugger

Inspect before you share

Paste a public URL to see your Trivue Score, Fix First issues, platform previews, and image checks - before the link goes live.

Only public http and https URLs are supported.

Score & fixes

Deterministic health score with prioritized issues.

Platform previews

Simulated X, Facebook, LinkedIn, Discord, Slack, and more.

Image analysis

Reachability, dimensions, and crop simulations.

What you get

Phased build. Core debugger first.

SSRF-safe fetch

Public URLs only. Private and metadata hosts blocked.

Raw + normalized

Exact tags plus fallback resolution with source tracking.

Trivue Score

Deterministic health score with a deduction breakdown.

Fix First

Highest-impact issues ranked before the tag dump.

Platform sims

X, Facebook, LinkedIn, Discord, Slack - labeled simulated.

Image checks

Reachability, type, dimensions, and crop hints.

Workflow

1

Validate

Protocol + SSRF checks before fetch.

2

Inspect

Extract, normalize, diagnose, score.

3

Fix

Prioritized issues and simulated previews.

HTTP API

Inspect any public URL

The same pipeline that powers the web UI is available as a JSON API. Send a public http or https URL and receive score, diagnostics, platform previews, and image analysis.

Endpoint

POST /api/inspect

Accept
application/json
Body
{ "url": "https://…" }

Response envelope

All responses use the same shape: message, status, and data.

  • fetch

    Requested vs final URL, HTTP status, content type, HTML length.

  • rawMetadata

    Standard, Open Graph, and Twitter tags as extracted from HTML.

  • normalizedMetadata

    Resolved title, description, image, and fallbacks with source tracking.

  • diagnostics

    Findings grouped by severity with suggested fixes.

  • trivueScore

    Score (0–100), category, and deduction breakdown.

  • platformPreviews

    Simulated previews for X, Facebook, LinkedIn, and others.

  • platformCompatibility

    Per-platform compatibility summary and warnings.

  • imageAnalysis

    Live social image fetch - dimensions, format, reachability.

  • durationMs

    End-to-end processing time in milliseconds.

curl
curl -s -X POST \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/page"}' \
  https://your-trivue-host/api/inspect
Success (200)
{
  "message": "Inspection complete.",
  "status": 200,
  "data": {
    "fetch": { "finalUrl": "https://example.com/page", "status": 200, … },
    "trivueScore": { "score": 87, "category": { … }, … },
    "diagnostics": [ … ],
    "platformPreviews": [ … ],
    "imageAnalysis": { … },
    "durationMs": 1240
  }
}
Error (4xx / 5xx)
{
  "message": "Enter a valid http or https URL.",
  "status": 400,
  "data": { "code": "INVALID_INPUT" }
}

Error codes

  • INVALID_INPUT

    HTTP 400

    Malformed JSON or missing url field.

  • INVALID_URL

    HTTP 400

    URL failed client-side validation.

  • BLOCKED_HOST / BLOCKED_ADDRESS

    HTTP 403

    SSRF protection blocked the target.

  • UNSUPPORTED_PROTOCOL

    HTTP 400

    Only http and https are allowed.

  • TIMEOUT

    HTTP 504

    Remote page did not respond in time.

  • RESPONSE_TOO_LARGE

    HTTP 413

    Page or image exceeded size limits.

  • UNSUPPORTED_CONTENT_TYPE

    HTTP 415

    Target is not an HTML page.

  • HTTP_ERROR / FETCH_FAILED

    HTTP 502

    Remote server error or unreachable URL.

  • INTERNAL_ERROR

    HTTP 500

    Unexpected server error.

Agent and editor integrations are on the roadmap - MCP server, VS Code extension, and Chrome extension.

Future plans

Meet Trivue where you work

The web app and HTTP API are the foundation. Next up: agent tooling, editor integration, and in-browser inspection - all backed by the same inspection service.

MCP server

Coming soon

Agents & IDE tooling

Expose inspect_url to Cursor, Claude Desktop, and other MCP clients - same pipeline as POST /api/inspect, no duplicated fetch or scoring logic.

Planned

inspect_url · stdio · Phase 11

VS Code extension

Coming soon

Editor workflow

Inspect the current file or a pasted URL from the command palette. Preview score, Fix First issues, and tag diffs without leaving the editor.

Planned

Command palette · sidebar report · Phase 12

Chrome extension

Coming soon

Browser workflow

One-click inspect for the active tab. See simulated previews and image checks while you iterate on metadata in dev or staging.

Planned

Active tab · dev/staging URLs · Phase 13

Get early access to Trivue

Be first when URL inspection, scoring, and platform simulations ship.

Request access
TrivueMetadata debugger