knowledge_hub: the brand facts every audit reads
knowledge_hub reads and edits a brand's Knowledge Hub: the brand profile, the content guideline, the target audiences and the topic clusters each audience asks about. AI Visibility, the Website Audit, Insights and Automations all read it, so an edit here changes what they work from.
Read it with a view. Change it with an action: patch the profile or guideline, add, edit or remove audiences and topic clusters, or let AI draft new clusters. Audiences and clusters are named, never addressed by id.
What it can read and do
Every call names a brand and either a view (what to read) or, on the audit and Knowledge Hub tools, an action (what to change). With neither, the tool returns its default view.
hubDefault- The profile, the content guideline, and each audience with its topic clusters (description, funnel stage, keywords), plus the plan limits.
overview- For each audience and topic cluster, how many AI Visibility prompts, audited pages and Insights questions cover it, planned against created.
update_profile- Change brand profile fields: description, products and services, value proposition, markets, competitors and more. Only the fields you send change.
update_guideline- Change the content guideline: tone of voice, content pillars, topics to avoid, formats and more.
add_audience- Add a target audience. fields.name is required. The first audience stays the primary one.
update_audience- Change the fields of the audience named in audience.
remove_audience- Remove the audience named in audience, with its topic clusters. A brand keeps at least one audience.
add_cluster- Add a topic cluster under audience (default: the primary audience). fields.name is required; keywords take up to 10 real search queries.
update_cluster- Change the cluster named in cluster. Put an audience name in fields.audience to move it.
remove_cluster- Remove the cluster named in cluster.
draft_clusters- AI drafts topic clusters: for every audience without any, otherwise two more each, up to the brand's limit. It runs for about a minute; read view hub until status is ready.
What a call costs
- Reads and edits are free, and work even when the balance is empty.
- draft_clusters calls an AI model, so it costs the 1-credit call fee.
Input parameters
Every parameter the tool's input schema accepts. Your assistant fills these in from what you ask; you never type them yourself.
| Parameter | What it does |
|---|---|
brandRequired | The brand's name, case-insensitive, as brand_insights lists it. |
view | What to read: hub (default) or overview. |
action | What to change. Leave it out to read. |
audience | A target audience's name: the one to update or remove, the audience a new cluster goes under, or which audience's cluster you mean when two share a name. |
cluster | update_cluster and remove_cluster: the topic cluster's name. |
fields | The fields to set, as an object. Updates are patches: fields you leave out stay as they are. |
Questions that use this tool
Ask in plain language and the assistant picks the view or action. These make good first questions.
- “Show me [brand]'s target audiences and their topic clusters.”
- “Add a 'First-time buyers' audience for [brand], aged 22–30, who compare prices on TikTok.”
- “Add three keywords to the 'Pricing' cluster for Busy Moms.”
- “Draft topic clusters for [brand]'s new audience.”
- “Which topic clusters have no AI Visibility prompts or pages yet?”
Questions about this tool
Does editing the Knowledge Hub change my audits?
Yes. AI Visibility and the Website Audit read the hub, so new audiences and clusters flow into them. Existing results stay as they are.
Can it delete things?
remove_audience and remove_cluster take them off the brand. Removing an audience removes its clusters too. Past results that name them keep working.
Why is it free?
Only draft_clusters calls an AI model, so only it is charged. Reading and editing your own brand facts costs nothing.