Skip to content

Instantly share code, notes, and snippets.

Show Gist options
  • Select an option

  • Save refinedsolutionsit-hub/f373d2c54ee5fb6d3b704790cc9e3f3b to your computer and use it in GitHub Desktop.

Select an option

Save refinedsolutionsit-hub/f373d2c54ee5fb6d3b704790cc9e3f3b to your computer and use it in GitHub Desktop.
HookFindr — OpenAI / Anthropic function-calling tool specs for video transcription, metadata, SRT export, and hook analysis. Drop into any function-calling app. Free + x402 paid endpoints. https://hookfindr.com
[
{
"type": "function",
"function": {
"name": "hookfindr_video_metadata",
"description": "Fetch metadata (title, duration, uploader, platform, detected music track) for any public short-form video URL. Works on TikTok, YouTube, YouTube Shorts, Instagram Reels, Twitter/X, Twitch clips, Facebook video, and ~1000 other platforms via yt-dlp. Fast (<2s typical). API: POST https://api.hookfindr.com/api/info body: {url}",
"parameters": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Public URL of a short-form video."
}
},
"required": ["url"]
}
}
},
{
"type": "function",
"function": {
"name": "hookfindr_transcribe_video",
"description": "Transcribe any short-form video URL to full text with word-level timestamps. Uses native platform captions when available (~2s) and falls back to Whisper-large-v3-turbo on extracted audio (~30s). When the audio is a known song, returns LRCLIB lyrics + synced timestamps instead of garbled noise. API: POST https://api.hookfindr.com/api/transcribe body: {url}",
"parameters": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Public URL of a short-form video to transcribe."
}
},
"required": ["url"]
}
}
},
{
"type": "function",
"function": {
"name": "hookfindr_export_srt",
"description": "Get a broadcast-quality SRT subtitle file for any short-form video URL. Ready to upload to YouTube, IG Reels, TikTok, or any subtitle player. Paid endpoint requires x402 payment ($0.05 USDC on Base). API: POST https://api.hookfindr.com/api/x402/caption.srt body: {url} payment: X-PAYMENT header per x402 protocol",
"parameters": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Public URL of a short-form video."
}
},
"required": ["url"]
}
}
},
{
"type": "function",
"function": {
"name": "hookfindr_analyze_hook",
"description": "Analyze the first 8 seconds of any short-form video URL and classify the hook (question, presupposition, shock_statement, list_promise, identity_attack, mystery, before_after, contrarian, narrative, demonstration) with a strength score 1-10 and a one-sentence explanation of why it works. Useful for creator analytics, ad copy research, content strategy. Paid endpoint ($0.02 USDC on Base). API: POST https://api.hookfindr.com/api/x402/hook body: {url}",
"parameters": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Public URL of a short-form video to analyze."
}
},
"required": ["url"]
}
}
}
]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment