# HookFindr

> Multi-platform short-form video transcription as an API + MCP server + x402-paid endpoints. Drop any TikTok, YouTube, YouTube Shorts, Instagram Reels, Twitter/X, Twitch clip, Facebook video, or one of ~1000 other URLs supported by yt-dlp and get back: full transcript with word-level timestamps, broadcast-quality SRT subtitles, opening-hook classification, or just metadata.

HookFindr exposes the same underlying pipeline (yt-dlp audio extract → Whisper-large-v3-turbo / native captions → optional LRCLIB lyrics substitution → optional Llama-3.2 analysis) through three discovery surfaces designed for AI agents, developers, and humans respectively. Production-live since 2026-05-06. x402 v2 endpoints live since 2026-05-15.

## Important pages

- [Live API base](https://api.hookfindr.com): root of the HTTP API. `POST /api/info` and `POST /api/transcribe` are anonymous-free (5 transcripts per IP per 30 days).
- [Developer integration guide](https://hookfindr.com/developers): MCP install, x402 endpoint table, code examples for the three integration paths.
- [Agent docs](https://github.com/refinedsolutionsit-hub/hookfindr/blob/main/docs/agents.md): full response schemas, error codes, rate limit details.
- [OpenAPI spec](https://hookfindr.com/openapi.json): OpenAPI 3.1 JSON describing every endpoint, request/response shape, and error code. Drop into any agent framework that accepts OpenAPI.
- [Pricing](https://hookfindr.com/pricing): human tiers (free, monthly, annual, lifetime, credit packs) and agent tier (x402 pay-per-call).

## x402 pay-per-call endpoints (no signup, no API key)

USDC on Base (eip155:8453), settled via Coinbase CDP facilitator. Listed on the [x402 Bazaar](https://docs.cdp.coinbase.com/x402/bazaar).

- `POST https://api.hookfindr.com/api/x402/info` — $0.005 — video metadata
- `POST https://api.hookfindr.com/api/x402/transcribe` — $0.05 — transcript + word timestamps
- `POST https://api.hookfindr.com/api/x402/caption.srt` — $0.05 — broadcast-quality SRT subtitle file
- `POST https://api.hookfindr.com/api/x402/hook` — $0.02 — Llama-3.2 hook classification + strength score

Also reachable at `x402.hookfindr.com/api/x402/*`.

## MCP server

`hookfindr-mcp-server` exposes four tools (`video_metadata`, `transcribe_video`, `export_srt`, `analyze_hook`) over stdio. Source: [github.com/refinedsolutionsit-hub/hookfindr/tree/main/mcp-server](https://github.com/refinedsolutionsit-hub/hookfindr/tree/main/mcp-server).

## OpenAI / Anthropic function-calling

[Public gist](https://gist.github.com/refinedsolutionsit-hub/f373d2c54ee5fb6d3b704790cc9e3f3b) with function-calling JSON ready to paste into any function-calling app.

## Source

[github.com/refinedsolutionsit-hub/hookfindr](https://github.com/refinedsolutionsit-hub/hookfindr) — Cloudflare Worker (TypeScript) + Pages frontend + Survivor-hosted yt-dlp extract service. Worker code is open under MIT. Pricing matrix and architecture documented in the repo.