Framefetch MCP server
online · 100% uptimeio.github.MarvinRey7879/framefetch·v1.9.1Any social-video URL → transcript, metadata, frames, OCR, summary, search, Q&A. MCP server + x402.
0 stars
Reviews
Write oneNobody has reviewed Framefetch yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Framefetch tools (4)
write = sends, deletes, buys or postsframefetch_accountFreeCheck 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.
framefetch_extractFreeExtract 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"]}.
framefetch_platform_capabilitiesFreeJSON 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.
framefetch_searchFreeSearch 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`.
Public scan report
scanner v0.1.9 · 2026-09-24 · same rubric, same numbers if you re-run it
- –Code scanremote-only server, no package to scann/a
- Live reliabilityremote reachable in 4429ms17/20
- Tool poisoning4 tool descriptions checked15/15
- Auth qualityopen endpoint, read-only tools10/15
- Maintenancelast push 55 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Framefetch compares
Against every graded Web search MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 83/100
- higher than 70% of 3,470 Web search servers
- Tools
- 4
- the typical Web search server has 5
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- Uptime
- 100%
- of our recent checks; the typical remote Web search server answers 100%
- Response time
- 96 ms
- faster than 89% of 2,238 Web search servers
What its tools let an agent do: 4 read
Install Framefetch in Claude Code, Cursor or VS Code
claude mcp add --transport http framefetch https://framefetch.net/mcp
What the publisher says
From the Framefetch repository's README, as published. We do not edit it. Read it on GitHub
FrameFetch
Any social-video URL → answers, transcript, metadata, insights, frames & on-screen text (OCR). Agent-first video data API + MCP server. Pay per call, or with x402 (USDC) — no account.
FrameFetch turns one YouTube, YouTube Shorts, TikTok, Instagram Reels, Pinterest, or Reddit video URL into a single JSON response: a direct answer to a question about the video, metadata, engagement insights, a transcript (captions or Whisper), an LLM digest (text or spoken mp3), structured JSON (chapters/entities/products/claims), comments + sentiment, parametrically-sampled frames (every Nth / 1-per-second / a time range, at any width), and the on-screen text burned into those frames (OCR — captions, price tags, signage). Plus keyword search when you don't have a URL yet, and batch for up to 10 URLs in one call. Built API-first and MCP-first for AI agents.
This repo is the open-source client + docs. The service itself runs at framefetch.net — you bring a free API key (or pay per call with x402); the backend stays hosted.
Why
An LLM can't watch a video. To reason about one it needs the video turned into text and images first — an answer, a transcript, metadata, a few frames. FrameFetch returns all of that from a URL, across six platforms, through one schema.
Install
npm install framefetchNode 18+ (uses built-in fetch). Get a free key: framefetch.net.
Version note. This repo is at 0.4.0. The newest version currently on npm is 0.3.0 — npm install framefetch still gives you that one, and it has only extract/metadata/transcript/frames/platforms/status/demo/createKey. Everything else documented below is live on the API today and available from this repo; from npm 0.3.0 you can reach the same data through extract({ fields: [...] }).
Ask a question — get an answer, not a transcript dump
A direct question about a video returns a short, grounded answer with timestamped quotes, instead of you parsing a 25,000-token transcript yourself.
import { FrameFetch } from 'framefetch';
const ff = new FrameFetch({ apiKey: process.env.FRAMEFETCH_API_KEY });
const { ask } = await ff.ask(
'https://www.youtube.com/watch?v=jNQXAC9IVRw',
'What does the presenter say to do first?',
);
console.log(ask.answer); // short, direct answer
console.log(ask.confidence); // 'high' | 'medium' | 'low'
for (const q of ask.quotes) { // verbatim, timestamped supporting quotes
console.log(`[${q.t_sec}s] ${q.text}`);
}
console.log(ask.coverage); // which part of the transcript was analyzedCharged only when an answer is actually produced. A repeat question about an already-extracted video reuses the cached transcript, so it answers fast without a re-download or re-transcription — but the answer itself is always freshly generated, never cache-served.
Frames-based answers: when a video has no transcript (e.g. Pinterest, or transcription failed), the answer is grounded in sampled keyframe images instead. Then coverage.mode is "frames", quotes is [] (no transcript text to quote), and confidence is capped at "medium".
Quick start
import { FrameFetch } from 'framefetch';Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Framefetch: common questions
- Is Framefetch MCP server safe?
- Mostly: it is graded B (83/100). Read the Framefetch safety report
- How do I install Framefetch?
- It runs remotely at framefetch.net. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
- Does Framefetch need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Framefetch maintained?
- The last commit was 96 days ago (2026-07-31). The latest release is v1.9.1.
- Is Framefetch up?
- 100% of our last 28 checks got an answer. We check remote servers about four times a day.
- What can I use instead of Framefetch?
- Servers from other publishers that do the same job: screenpipe MCP server, Brave Search MCP server and SearXNG Search MCP server.
- How does Framefetch compare with other Web search MCP servers?
- safety score 83/100 (higher than 70% of 3,470 Web search servers); tools 4 (the typical Web search server has 5); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Framefetch
Same job from other publishers: the closest match first, then the best rated.
- screenpipeSearch your local screen recordings, audio transcripts, and computer activity from screenpipe.not reviewedWidely usedB
- Brave SearchBrave Search MCP Server: web results, images, videos, rich results, AI summaries, and more.not reviewedEstablishedA
- SearXNG SearchMCP server for SearXNG — privacy-respecting web search with pagination, URL readingnot reviewedEstablishedB
GitHitsSearch public open-source code, documentation, metadata, vulnerabilities, changelogs, and examples.not reviewedEstablishedA- CLIO WebProvider-fixed web search plus transparent URL, DOI, and document fetchingnot reviewedEstablishedA