Documentation

Guided prompts

Where tools are low-level primitives, prompts are named, task-oriented starting points. They appear in your assistant's prompt or slash menu with a description and argument hints, and each one tells the assistant exactly which tools to chain to complete a full task. They're the recommended way to begin — pick one, fill in its argument, and let the assistant do the orchestration.

Prompts don't do anything you couldn't ask for in plain language — they're just reliable, pre-written recipes. If a prompt doesn't quite fit, ask your question directly and the assistant will select tools itself.

Report prompts

These take a report's public token (from a share URL) and analyze a single shared report. See Reports for the underlying tools.

PromptArgumentWhat it does
Analyze a Spyglasses report (analyze_report)publicTokenDetects whether the token is an AI Visibility report or a Site Readiness audit, then leads with the headline numbers and the 3–5 most important findings.
What should I fix first? (what_to_fix_first)publicTokenTurns a report into a prioritized action plan grouped by team (SEO/AEO, PR, technical), highest-impact and lowest-effort first.
Where do competitors beat me? (competitor_gaps)publicTokenSurfaces the searches and citations where competitors appear and the brand doesn't, with content and PR targets to close the gaps.
Find my weakest pages (audit_worst_pages)publicTokenRanks a site audit's lowest-scoring pages and explains the specific fixes to raise each one's readiness score.

Account prompts

These use your signed-in account. Most take a propertyId or projectId you get from list_properties / list_projects. See Account data and Scoring for the underlying tools.

PromptArgumentWhat it does
List my organization's reports (list_my_reports)—Lists the reports in your organization (asking which one if you belong to several) so you can pick one to analyze.
Analyze a project (analyze_project)projectIdSummarizes a project's progress (metric deltas, goals, weekly trend) and recommends next moves, including the project-scoped daily series and brand ranking.
Who does AI name here? (brands_in_context)propertyId, optional sliceRanks the brands AI names for one slice of a property (a stage, a platform, a prompt tag, a project, a market) and drills into the prompts and answers behind the ranking.
Track message drift (track_message_drift)propertyIdShows how AI's description of the brand changes over time for a tracked query, plus how key-message pull-through trends.
Citation mix over time (citation_mix_trends)propertyIdShows how the mix of sources AI cites shifts over time, and where to focus content and outreach.
Evaluate publishers (AIPVS) (evaluate_publishers)domains, optional propertyIdScores and ranks publisher domains by AI Placement Value Score, optionally in a brand's context.

How prompts relate to tools

Each prompt expands into a short plan the assistant follows. For example, Track message drift runs roughly:

Call get_message_tracking to see each key message's pull-through rate over time.

Call get_answer_summaries with no query to list tracked queries, pick the most strategic one, then call it again for that query's full weekly answers per platform.

Compare the weekly answers to narrate what's changing, and chart pull-through from the returned series.

Who does AI name here? runs the same way one level deeper:

Call list_prompt_tags (plus list_projects / list_locations when a project or market is in scope) to turn the slice you asked for in plain words into real filter values.

Call get_competitor_share_of_voice with those filters and includeSeries: true, honoring the payload's own guardrails (empty, thin, basis, dimensionStartDate) before reporting anything.

Call get_answer_drilldown for a date from that series, with the same filters and a brandName lens, to read the prompts that named the brand and the ones that did not, then pass a queryId for one prompt's full answer text.

You can always stop a prompt partway and steer — ask for a different query, a chart, or a deeper drill-down. The prompt just gets the conversation moving in the right direction.

  • Reports — the token-scoped report tools the report prompts use
  • Account data — the property tools the account prompts use
  • Scoring — publisher and placement scoring behind evaluate_publishers

On this page

How-to guides for setting up Spyglasses to track your AI traffic