io.github.MarvinRey7879/framefetch
v1.9.1Any social-video URL → transcript, metadata, frames, OCR, summary, search, Q&A. MCP server + x402.
Endpoint health
online- Last checked
- 11/20/2026, 4:18:05 AM
- Latency
- 360 ms
- Consecutive failures
- 0
- Endpoint reachable: pass
- Protocol valid: pass
- MCP handshake valid: pass
Machine-readable profile
mcp-server · schema v1 · callable
mcp-server:io.github.MarvinRey7879%2Fframefetch
Connect this server
Generated config contains no credentials. Keep any required secrets in your client's local environment.
{
"mcpServers": {
"io.github.MarvinRey7879/framefetch": {
"url": "https://framefetch.net/mcp"
}
}
}Indexed tools
Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.
4 shown · authentication unknown
framefetch_account
Check this account's credit balance/usage. Read-only — never charges; works at zero balance (unlike framefetch_extract). Purpose: check balance before expensive framefetch_extract calls — at session start, periodically, or after a 402. When NOT to use: before every single framefetch_extract call in a tight loop. Returns: balance_micros, spend_7d_micros, calls_7d — micro-USD (1,000,000 = $1). Low balance: top up via x402 (USDC) at POST /v1/topup, or card at POST /v1/checkout.
Schema valid · SHA-256 ce54785a34d8…
View input schema
{ "type": "object", "properties": {} }framefetch_extract
Extract data from ONE public social-video URL (YouTube incl. Shorts, TikTok, Instagram Reels): metadata/insights/transcript/frames/digest/comments/etc — see `fields`. When NOT to use: non-video pages, private/login-walled content, or bulk crawling (one URL per call). Returns one JSON object with only the requested fields + a `cost` block (micro-USD); shapes: https://framefetch.net/docs. Cost scales with what you request (frames/transcript cost more than metadata). No key? POST /v1/keys {email} -> instant key (~100 free calls); or x402 (USDC), no account. Example: {"url":"https://www.youtube.com/watch?v=...","fields":["metadata","transcript"]}.
Schema valid · SHA-256 7ddad2d9eace…
View input schema
{ "type": "object", "properties": { "url": { "type": "string", "description": "Public video URL from a supported platform." }, "fields": { "type": "array", "items": { "type": "string", "enum": [ "metadata", "insights", "transcript", "frames", "text_overlay", "digest", "audio_digest", "structured", "comments", "comment_sentiment", "delta" ] }, "description": "Which data to return; default [\"metadata\"]. Pulls: digest→transcript; audio_digest→digest→transcript; structured→transcript; comment_sentiment→comments. digest/audio_digest/structured/comment_sentiment: degrade to a warning, never charged, on failure. digest: gist+topics via LLM. audio_digest: mp3 of digest (signed URL, 24h); voice via `voice`; +`translate` for other-language audio. structured: chapters/entities/products_shown/claims/key_moments via vision LLM. comments: up to comments_cap; YouTube only (else warning; see GET /v1/platforms). comment_sentiment: aggregated audience sentiment (positive_pct/neutral_pct/negative_pct/summary/top_themes); needs >=5 comments; same YouTube-only limit. text_overlay: OCR per frame; requires \"frames\"; skipped above 200 frames. delta: velocity vs the previous fetch; first call seeds the baseline. Docs: https://framefetch.net/docs." }, "frames": { "type": "object", "description": "Frame-sampling spec; required when \"frames\" or \"text_overlay\" is requested.", "properties": { "mode": { "type": "string", "enum": [ "all", "every_n", "fps", "range" ] }, "n": { "type": "number", "description": "every_n: take every Nth source frame" }, "fps": { "type": "number", "description": "fps/range: frames per second (max 60)" }, "from": { "type": "number", "description": "range: start second" }, "to": { "type": "number", "description": "range: end second" }, "format": { "type": "string", "enum": [ "jpg", "png", "webp" ] }, "width": { "type": "number", "description": "downscale width in px (16–7680)" } }, "required": [ "mode" ] }, "translate": { "type": "string", "description": "ISO-639-1 target language (e.g. \"es\"); adds `transcript_translated` (timings kept). Requires \"transcript\" (or \"digest\"). Billed per audio-minute." }, "subtitle_format": { "type": "string", "enum": [ "srt", "vtt" ], "description": "Renders transcript as subtitles in `subtitles` (srt/vtt). Requires \"transcript\" (or \"digest\"); uses translated cues if \"translate\" set." }, "voice": { "type": "string", "enum": [ "alloy", "echo", "fable", "onyx", "nova", "shimmer", "Fritz-PlayAI" ], "description": "Voice for \"audio_digest\": OpenAI voices (alloy/echo/fable/onyx/nova/shimmer) + Groq \"Fritz-PlayAI\"; default \"alloy\"." }, "comments_cap": { "type": "integer", "minimum": 1, "maximum": 200, "description": "Max top-level comments (1-200, default 30); only used with \"comments\"." }, "ask": { "type": "string", "minLength": 3, "maxLength": 500, "description": "Question about the video (3-500 chars); <=500-token answer w/ timestamped quotes, grounded in the transcript (auto-pulled). Never cached; degrades (never charged) if unavailable. Long videos: answer draws on a relevance-selected/sampled subset, not just the head — see response `ask.coverage`. No transcript available: falls back to frames, `based_on`:[\"frames\"]." }, "cache": { "type": "boolean", "description": "false forces a fresh, billed extract." } }, "required": [ "url" ] }
Connections
streamable-http
https://framefetch.net/mcp