Any social-video URL → transcript, metadata, frames, OCR, summary, search, Q&A. MCP server + x402.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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.
This tool takes no arguments.
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.
No arguments.
{
"type": "object",
"properties": {}
}Extract data from ONE public social-video URL (YouTube incl. Shorts, TikTok, Instagram Reels, Pinterest, Reddit): 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"]}.
| Argument | Type | Description |
|---|---|---|
| ask | string | 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 (e.g. Pinterest): falls back to frames, `based_on`:["frames"]. |
| url* | string | Public video URL from a supported platform. |
| cache | boolean | false forces a fresh, billed extract. |
| voice | string | Voice for "audio_digest": OpenAI voices (alloy/echo/fable/onyx/nova/shimmer) + Groq "Fritz-PlayAI"; default "alloy". |
| fields | array | 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 | object | Frame-sampling spec; required when "frames" or "text_overlay" is requested. |
| translate | string | ISO-639-1 target language (e.g. "es"); adds `transcript_translated` (timings kept). Requires "transcript" (or "digest"). Billed per audio-minute. |
JSON matrix of data types (metadata, insights, transcript, frames, comments) per platform — YouTube (+Shorts), TikTok, Instagram Reels, Pinterest, Reddit. Call before framefetch_extract to confirm support. No input.
No arguments.
{
"type": "object",
"properties": {}
}Search YouTube by keyword (yt-dlp, no login). Returns up to `limit` hits: url/title/uploader/durationSec/uploadDate(often null)/thumbnail/views. YouTube only — use framefetch_extract on a hit's url for transcript/frames/etc. Billed ~$0.002/call (metadata-tier), regardless of `limit`.
| Argument | Type | Description |
|---|---|---|
| cache | boolean | false = fresh, billed search. |
| limit | integer | Default 10. |
| query* | string | 2-200 chars. |
| platform | string |
{
"type": "object",
"required": [
"query"
],
"properties": {
"cache": {
"type": "boolean",
"description": "false = fresh, billed search."
},
"limit": {
"type": "integer",
"maximum": 25,
"minimum": 1,
"description": "Default 10."
},
"query": {
"type": "string",
"description": "2-200 chars."
},
"platform": {
"enum": [
"youtube"
],
"type": "string"
}
}
}| comments_cap | integer | Max top-level comments (1-200, default 30); only used with "comments". |
| subtitle_format | string | Renders transcript as subtitles in `subtitles` (srt/vtt). Requires "transcript" (or "digest"); uses translated cues if "translate" set. |
{
"type": "object",
"required": [
"url"
],
"properties": {
"ask": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"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 (e.g. Pinterest): falls back to frames, `based_on`:[\"frames\"]."
},
"url": {
"type": "string",
"description": "Public video URL from a supported platform."
},
"cache": {
"type": "boolean",
"description": "false forces a fresh, billed extract."
},
"voice": {
"enum": [
"alloy",
"echo",
"fable",
"onyx",
"nova",
"shimmer",
"Fritz-PlayAI"
],
"type": "string",
"description": "Voice for \"audio_digest\": OpenAI voices (alloy/echo/fable/onyx/nova/shimmer) + Groq \"Fritz-PlayAI\"; default \"alloy\"."
},
"fields": {
"type": "array",
"items": {
"enum": [
"metadata",
"insights",
"transcript",
"frames",
"text_overlay",
"digest",
"audio_digest",
"structured",
"comments",
"comment_sentiment",
"delta"
],
"type": "string"
},
"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",
"required": [
"mode"
],
"properties": {
"n": {
"type": "number",
"description": "every_n: take every Nth source frame"
},
"to": {
"type": "number",
"description": "range: end second"
},
"fps": {
"type": "number",
"description": "fps/range: frames per second (max 60)"
},
"from": {
"type": "number",
"description": "range: start second"
},
"mode": {
"enum": [
"all",
"every_n",
"fps",
"range"
],
"type": "string"
},
"width": {
"type": "number",
"description": "downscale width in px (16–7680)"
},
"format": {
"enum": [
"jpg",
"png",
"webp"
],
"type": "string"
}
},
"description": "Frame-sampling spec; required when \"frames\" or \"text_overlay\" is requested."
},
"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."
},
"comments_cap": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Max top-level comments (1-200, default 30); only used with \"comments\"."
},
"subtitle_format": {
"enum": [
"srt",
"vtt"
],
"type": "string",
"description": "Renders transcript as subtitles in `subtitles` (srt/vtt). Requires \"transcript\" (or \"digest\"); uses translated cues if \"translate\" set."
}
}
}