List the AI search visibility opportunities worth working on
visibility_list_opportunitiesReturns the ranked work queue Hi, Moose builds from a project's stored AI search visibility results: the same rows as the Opportunities tab in the app. Each row carries a one-line headline, a summary of what is happening and numbered steps (what to do), written by a model that read the real AI answers and the pages involved (adviceSource "model"; rows the app has not written advice for yet fall back to a template headline and next step, adviceSource "template"), plus the priority with its reasons, how consistently the gap held across runs, the effort, the status the team set in Hi, Moose, and an opportunity id. Five kinds of row: create-coverage (no page of yours answers a prompt competitors win), improve-page (a page of yours is cited or is the closest match but the brand is left out, ranked behind or cited without being named), earn-inclusion (a third-party page the AI systems cite names competitors but not the brand), correct-description (answers repeat a claim about the brand that needs checking) and investigate-change (the brand was named or cited before and is not any more). Reads stored results only, over the last lookbackDays (default 7) compared with the window before it; it does not run new checks. Call it again with opportunityId to get the full evidence for one row: the steps, how we know (the model's reasoning, confidence and quotes from the answers and pages), every prompt and AI system with its state and answer id, competitors, pages cited instead, your page, flagged answers and what changed. The detail call writes the advice when the app has none yet, which can take a minute. Rows cover the tracked prompts on the tracked engines only; report the window and sample sizes plainly and never claim causation. Takes a few seconds to a minute.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"project": "<project>"
},
"name": "visibility_list_opportunities"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | How many rows to return, best first. Default 10. | |
| action | No | Optional: only rows of this kind. | |
| project | Yes | The Hi, Moose project, by its name as shown by list_projects. The projectId is also accepted. | |
| priority | No | Optional: only rows with this priority. | |
| lookbackDays | No | How many days of stored results to read. Default 7, the same window as the Opportunities tab. | |
| includeClosed | No | Optional: also return rows the team marked done, dismissed or snoozed in Hi, Moose. Default false. | |
| opportunityId | No | Optional: the opportunity id from an earlier result. Returns the full evidence for that one row instead of the list. |