brand_read
Read a brand from its website and its Instagram, TikTok or Facebook accounts, and save it as the brand profile: name, logo, colours, voice, products, audiences, competitors and market white space. Free, takes 1 to 3 minutes. Start it with "url", "socials" or both: a creator or a shop with no website is read from its accounts alone. It answers with a jobId: call this tool again with only "jobId" to follow it (each call waits up to 20 seconds for progress). When status is "done", call brand_profile. Reading again replaces the current profile, so only do it when the user asks or when brand_profile has nothing.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "brand_read"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | The brand website, e.g. "hookbird.ai", or a profile link, e.g. "instagram.com/gymshark", to start a read | |
| jobId | No | The jobId of a read that was started, to get its progress | |
| socials | No | Social accounts to read, with or without a website |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| step | No | ||
| error | No | ||
| jobId | No | ||
| label | No | ||
| steps | No | ||
| status | No | ||
| partial | No |