MCP server
Coming soonAgents & 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
Metadata debugger
Paste a public URL to see your Trivue Score, Fix First issues, platform previews, and image checks - before the link goes live.
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.
Phased build. Core debugger first.
Public URLs only. Private and metadata hosts blocked.
Exact tags plus fallback resolution with source tracking.
Deterministic health score with a deduction breakdown.
Highest-impact issues ranked before the tag dump.
X, Facebook, LinkedIn, Discord, Slack - labeled simulated.
Reachability, type, dimensions, and crop hints.
Protocol + SSRF checks before fetch.
Extract, normalize, diagnose, score.
Prioritized issues and simulated previews.
HTTP API
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
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 -s -X POST \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com/page"}' \
https://your-trivue-host/api/inspect{
"message": "Inspection complete.",
"status": 200,
"data": {
"fetch": { "finalUrl": "https://example.com/page", "status": 200, … },
"trivueScore": { "score": 87, "category": { … }, … },
"diagnostics": [ … ],
"platformPreviews": [ … ],
"imageAnalysis": { … },
"durationMs": 1240
}
}{
"message": "Enter a valid http or https URL.",
"status": 400,
"data": { "code": "INVALID_INPUT" }
}INVALID_INPUT
HTTP 400Malformed JSON or missing url field.
INVALID_URL
HTTP 400URL failed client-side validation.
BLOCKED_HOST / BLOCKED_ADDRESS
HTTP 403SSRF protection blocked the target.
UNSUPPORTED_PROTOCOL
HTTP 400Only http and https are allowed.
TIMEOUT
HTTP 504Remote page did not respond in time.
RESPONSE_TOO_LARGE
HTTP 413Page or image exceeded size limits.
UNSUPPORTED_CONTENT_TYPE
HTTP 415Target is not an HTML page.
HTTP_ERROR / FETCH_FAILED
HTTP 502Remote server error or unreachable URL.
INTERNAL_ERROR
HTTP 500Unexpected server error.
Agent and editor integrations are on the roadmap - MCP server, VS Code extension, and Chrome extension.
Future plans
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.
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
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
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.