← Back to HookFindr

HookFindr for developers

Multi-platform short-form video transcription as an HTTP API + MCP server + x402-paid endpoints. live since 2026-05-06

What you can do with it

Pass any public URL from TikTok, YouTube, YouTube Shorts, Instagram Reels, Twitter/X, Twitch clips, Facebook video, or ~1000 other platforms (yt-dlp extractors) and get back:

• Full transcript with word-level timestamps
• Video metadata (title, duration, uploader, detected music track)
• Broadcast-quality SRT subtitle file
• Opening-hook classification with strength score and explanation

Three integration paths

1. MCP server (Claude Desktop, Cursor, any MCP client)

One-line install — Claude can transcribe video URLs directly.

{
  "mcpServers": {
    "hookfindr": {
      "command": "npx",
      "args": ["-y", "hookfindr-mcp-server"]
    }
  }
}

Source: github.com/refinedsolutionsit-hub/hookfindr/tree/main/mcp-server (MIT)

2. x402 pay-per-call (AI agents with USDC on Base)

No signup, no API key. Pay per call via the x402 protocol. Endpoints listed on the x402 Bazaar:

Endpoint	Price	Returns
POST /api/x402/info	$0.005	Video metadata
POST /api/x402/transcribe	$0.05	Transcript + word timestamps
POST /api/x402/caption.srt	$0.05	SRT subtitle file
POST /api/x402/hook	$0.02	Hook classification + strength

Network: Base mainnet (eip155:8453) · Asset: USDC · Facilitator: Coinbase CDP · Protocol: x402 v2

Also reachable at https://x402.hookfindr.com/api/x402/*.

Example with @x402/fetch:

import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.EVM_PRIVATE_KEY);
const fetchPaid = wrapFetchWithPaymentFromConfig(fetch, {
  schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(account) }],
});

const res = await fetchPaid("https://api.hookfindr.com/api/x402/transcribe", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ url: "https://www.tiktok.com/@some/video/123" }),
});
console.log(await res.json());

3. Plain HTTP (OpenAI / Anthropic function-calling, custom agents)

Free tier — no auth, no payment. Anonymous IP-based rate limit.

POST https://api.hookfindr.com/api/info        { "url": "..." }
POST https://api.hookfindr.com/api/transcribe  { "url": "..." }

OpenAI / Anthropic function-calling tool spec ready to paste in: public gist.

Rate limits

• Anonymous: 5 transcripts per IP per 30 days, no signup
• Email (magic-link at hookfindr.com): 5 per day
• x402: unlimited pay-per-call

Cache hits (same URL within 90 days) are free across all tiers.

Machine-readable specs

• OpenAPI 3.1 spec — every endpoint, request/response schema, error code. Drop into LangChain, OpenAI Agents SDK, AutoGen, or any framework that consumes OpenAPI.
• llms.txt — short crawler-friendly site description.
• Python integration example — all three tiers including a hand-rolled EIP-3009 signing flow for x402.
• Function-calling JSON — for OpenAI / Anthropic tool use.

Response shapes + error codes

Full schema reference and example responses are in docs/agents.md, or as a structured spec at /openapi.json.

Status

Production. Live since 2026-05-06. x402 endpoints live since 2026-05-15. Source for the worker, MCP server, and frontend is on GitHub.

Questions, bug reports, or integration help: [email protected]