Hookownia

Costs 4 credits per call. A breakdown of a reference video transcript the user pasted: measurable traits (words, sentences, time, questions, commands), the hook, the role of every sentence, the closest structures from the library, a checklist of what to note about the reference, and, with a new topic, a timed plan to reuse the structure. The transcript is not stored. Spends credits from the user's Hookownia account.

analyze_reference

Costs 3 credits per call. Up to five hook templates for the topic from the Hookownia library (Polish; for another `language` with the original pattern to adapt from), from different families and mechanisms: the pattern with its [SLOTS], fill rules and examples per slot, an example, why it fits, how to say it and what to avoid, plus the steps for writing and scoring the fills and the hook scoring rubric. Requires the research object from research_plan, complete and fresh (or researchSkippedReason for the creator's own story); without it returns, free, what is missing. For only a hook the work ends when the user picks one; for a full script the picked template id (hookId) and filled hook go to build_script_brief. Spends credits from the user's Hookownia account.

find_hooks

Free (no credits). The allowed values for the other tools: durations, goals, formats, tones, viewer awareness levels, platforms, niche ids and style ids, with Polish labels, the size of the library and how many new hook templates (and structures) the account can still receive in the rolling 30 days.

list_options

Costs 5 credits per call. A recording plan for a short video around the hook the user picked, in Polish or the requested `language` (word budgets follow its pace): the fixed hook, three script versions for 30 or 60 s (two for 90 or 120 s), each with its angle, structure, style and timed parts with word counts and delivery cues (tone, pace, stress, pauses, on-screen text, shot), the notation legend, research rules, writing rules, the script scoring rubric, a self-check list and the answer format: one table of eight columns (Czas, Co mówisz, Ton, Tempo, Akcent, Pauza, Na ekranie, Ujęcie; headers in the language of the conversation), one row per part, the legend marks in the spoken text, then a clean prompter version. Requires hookId and hookText from find_hooks and the same research object find_hooks got (or researchSkippedReason for the creator's own story); without them it returns, free, the list of what is missing. Spends credits from the user's Hookownia account.

build_script_brief

Costs 1 credit per call. The research checklist for a video topic, the first step for hooks or a script: questions by priority (each with the field of the research object it fills), the freshness window with real dates, the minimum (5 dated facts with sources, a myth, 3 sources from the last 6 months, a summary), what to verify, how to write numbers to be said aloud, where to look, and the exact research object find_hooks and build_script_brief accept, with an example. Spends credits from the user's Hookownia account.

research_plan

Costs 4 credits per call. Measurable traits of the creator's own scripts or transcripts: point of view, pace, sentence length, frequent words, the closest styles from the library and a checklist of what to note about the creator's style. The samples are not stored. Spends credits from the user's Hookownia account.

style_profile

Free (no credits). The creator's profile (niche, audience, goals, tone, grammatical gender, topics to avoid, where the call to action leads, platforms, length). Without input it returns the fields with the question for each (ask only what the next tool needs; the optional ones only if the user wants to add them), and the rules for looking at a public profile link the user gave. With `profile` it checks the whole profile and lists what is still missing. Pass `language` (the script's): in en and de the grammatical gender is not needed. Nothing is stored on the server (`storedOnServer: false`): the profile stays in this conversation, and the next tools take niche, goal, tone, audience and platform (build_script_brief also grammaticalGender and offer) as their own fields.

creator_profile

Costs 2 credits per call. Only topic ideas for short videos in the creator's niche, each with its angle, a suggested format and goal; no research needed. Send the niche from the conversation; without it the tool returns, free, what is missing. Ideas touching the topics in avoid are left out. Spends credits from the user's Hookownia account.

suggest_topics

Costs 1 credit per call. Checks of a finished script against the chosen length at the pace of its `language` (Polish by default): word count and estimated time against the word budget, hook length, long sentences, a repeated hook, delivery marks and unfilled [SLOTS]; for Polish also the hook opening, forbidden phrases, digits instead of spoken numbers and the call to action; for a pasted answer table also its format (eight columns, times with part names, stress, pace in words per second, one sentence a prompter line); a technical score from 0 to 1 with its parts, and the script scoring rubric. Pass the whole answer, and duration, hookId and language from the brief. The script is not stored. Spends credits from the user's Hookownia account.

check_script

Free (no credits). The user's Hookownia account: credit balance, credits expiring soon, paid calls in the last 24 hours against the account's daily limit when it has one, what the credits went on in the last 30 days by operation, the cost of each tool and of the three paths (only topics, only hooks, a full script), how many new hook templates (and structures) the account can still receive in the rolling 30 days, and links to the account page and to a page about credits.

account_status