Start AI search from the website
start_website_scanStart AI search (AEO) from the company website, as the AI search pages do: read its sitemap and main pages, work out the Google searches it is built to win, check where it ranks in Google's top 20 for each, and suggest buyer questions to track and likely competitors from what it finds. Reads the website on the company profile. Costs at most costs.websiteScanAtMost Energy (get_ai_search_overview), within today's daily limit, and keeps what it found if Energy or the limit runs out part way. One scan runs at a time. With confirmed=true it returns started, scan (scanId, site, startedAt), energy and message; it takes about a minute, then read website in get_ai_search_overview and track the suggested questions (settings.suggestions) with add_ai_search_questions. Without confirmed=true nothing runs and nothing is charged: it returns the Energy cost, the Energy left and today's AI search limit, with the call that runs it, or the money answer when Energy can't cover it. Tell the customer the cost, then call again with confirmed=true. If AI search is not on for this workspace yet, this turns it on (aiSearchTurnedOn in the result says what it starts with). Only for a connection created by a current owner or admin of this workspace.
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": "start_website_scan"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| confirmed | No | false prices the step and changes nothing; true runs it and spends Energy. Send true only after the customer agrees to the price. | |
| workspaceId | No | A teammate's workspace you may manage: an active workspace ID from list_team_workspaces. Omit for your own workspace. Supply on every call for a teammate. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| next | No | Preview only: the exact call that runs the step once the customer agrees; null when it can't run now. | |
| scan | No | Run: the scan that started; read its results in get_ai_search_overview website after about a minute. | |
| site | No | Preview: the website that would be scanned. | |
| energy | Yes | What the step costs and the Energy left. | |
| message | No | A plain summary of the price or of what started, to pass on to the customer. | |
| started | No | false on the priced preview: nothing ran or was charged. | |
| readyToRun | No | Preview only: true when Energy and today's limit allow the step; then call next after the customer agrees. | |
| aiSearchTurnedOn | No | Present only when this call turned AI search on: what it now runs with. Tell the customer. |