Yolando

Add a bundled resource file to an existing Agent Skill (employee only).

create_skill_resource

Create a target audience for this workspace. An audience needs at least one characterizing facet, and the expertise tenor is the one this tool exposes -- so it is required, and the schema says so. The audience is active immediately. It will report nothing until the next analysis run. Audience metrics are as-of each analysis: an analysis records the audiences its prompts served at the time it ran, and published numbers never move afterwards. So a freshly created audience has empty buckets even after you assign prompts to it, until those prompts are analysed again.

create_audience

Create a new topic in this workspace. Topics are thematic categories that group related prompts. Returns the created topic including its ID, which can be passed to ``create_prompts``.

create_topic

Delete a brand voice from this workspace.

delete_brand_voice

Soft-delete a chat suggestion (employee only).

delete_chat_suggestion

Remove a competitor from this workspace.

delete_competitor

Delete a content item Soft-deletes the content item and cascades to its pieces.

delete_content_item

Delete prompts from this workspace by ID.

delete_prompts

Soft-delete a skill from the catalog (employee only). The slug is freed for reuse; usage history keeps referring to the deleted row.

delete_skill

Delete a bundled skill resource file (employee only).

delete_skill_resource

Delete a topic and all its prompts from this workspace. Soft-deletes the topic and cascade-soft-deletes its prompts.

delete_topic

Per-audience discoverability buckets — the audience compare view. One row per ACTIVE or ARCHIVED audience (DEFAULT last — its bucket is the unsegmented remainder, not the workspace total) with per-platform discoverability and deltas. Buckets are as-of each analysis run, intersected with each audience's markets, and overlap — never sum them; ``groups_caveat`` states the rule. To scope OTHER metrics to a single audience, pass ``target_audience_id`` to those tools instead. Defaults to the last 30 calendar days (UTC unless `timezone` is given) when no time window is given.

get_audience_insights

Aggregated citation analytics for the workspace brand. Returns overall citation share plus the top domains that cite the brand in AI-generated responses. Use this for "where is my brand being cited?" and "top N citations" questions. Defaults to the last 30 calendar days (UTC unless `timezone` is given) when no time window is given; pass start/end or lookback_days to scope it (e.g. "last 90 days"). Use ``limit`` for "top N" requests (e.g. limit=10).

get_citation_insights

Citation share time-series for the workspace brand and all tracked competitors. Shows how each brand's share of AI citations is trending over time. Use for "who is winning citations in my space?" questions. Defaults to the last 30 calendar days (UTC unless `timezone` is given) when no time window is given; pass start/end or lookback_days to scope it.

get_competitor_citation_trends

Discoverability time-series for the workspace brand and all tracked competitors. Returns week-by-week (or day-by-day) discoverability scores so you can answer "is my brand gaining or losing ground vs competitors in AI search?" questions. Defaults to the last 30 calendar days (UTC unless `timezone` is given) when no time window is given; pass start/end or lookback_days to scope it.

get_competitor_discoverability_trends

Reputation score time-series for the workspace brand and all tracked competitors. Shows how each brand's AI reputation score is trending. Use for "how does my brand's reputation compare to competitors?" questions. Defaults to the last 30 calendar days (UTC unless `timezone` is given) when no time window is given; pass start/end or lookback_days to scope it.

get_competitor_reputation_trends

Search clicks/impressions earned by Yolando-generated content. Returns one row per content item that has been matched to a live page on the brand's site, with Google Search Console clicks/impressions and GA4 sessions/engaged sessions summed across all of the item's linked pages (including pages it was published on before a republish). Items whose pages have no metrics yet appear with zeros; unpublished items don't appear at all. Ordered by clicks, most-earning first. Use this for "how is our published content performing in search?" questions. Defaults to all-time totals; pass start_date/end_date to scope the window.

get_content_attribution

Day-by-day clicks/impressions and traffic for one content item. Returns a daily time series of Google Search Console clicks/impressions and GA4 sessions/engaged sessions attributed to the content item across all of its linked pages. Use after ``get_content_attribution`` to drill into how a specific piece is trending. Days with no data in either source are omitted; an item with no linked pages returns an empty series. Defaults to all available history; pass start_date/end_date to scope the window.

get_content_attribution_daily

Full detail for a single content item, including the generated body. Returns the content item's metadata, current status, and the complete generated text in markdown format. Use after ``list_content`` to read or evaluate a specific piece — pass that list's ``id`` field as ``content_item_id``.

get_content_item

Measure one published content item or canonical page across GSC and GA4. The response keeps five different questions separate: Google Search visibility, sessions that started on the selected pages, all activity on those pages, named key events recorded on those pages, and property-wide key-event context. Read ``coverage`` and ``limitations`` before making a claim. Search clicks are not joined to GA4 sessions, property key events are not attributed to a page, and current/previous page matches describe URL matching history rather than document revisions or causality.

get_content_performance

Brand-insights snapshot for the target workspace. Returns discoverability, share of voice, citation share, and reputation score. Ask this first for "how is my brand doing in AI search?" questions. Defaults to the last 30 calendar days (UTC unless `timezone` is given) when no time window is given; pass start/end or lookback_days to scope it (e.g. "last 90 days").

get_insights_overview

Discoverability, share of voice, citation share, and reputation score broken down by AI platform (ChatGPT, Perplexity, Gemini, etc.). Returns four datasets in one tool call so you can answer "which platforms is my brand strongest / weakest on?" without making separate tool calls. Defaults to the last 30 calendar days (UTC unless `timezone` is given) when no time window is given; pass start/end or lookback_days to scope it.

get_platform_insights

Platform discoverability broken down by brand (workspace + competitors). Returns each tracked brand's discoverability score per AI platform, enabling side-by-side competitor comparisons across platforms. Use after ``get_platform_insights`` to drill into "which brands are winning on each platform?" questions. Defaults to the last 30 calendar days (UTC unless `timezone` is given) when no time window is given; pass start/end or lookback_days to scope it.

get_platform_insights_by_brand

Platform discoverability broken down by topic. Returns each tracked topic's discoverability score per AI platform, showing which topics the brand appears in most on each platform. Use after ``get_platform_insights`` to drill into "which topics drive visibility on each platform?" questions. Defaults to the last 30 calendar days (UTC unless `timezone` is given) when no time window is given; pass start/end or lookback_days to scope it.

get_platform_insights_by_topic

Full detail for a single radar feed item. Returns the complete radar item including strategic summary, diff sections (for site-change items), news sources (for market-news items), and topic associations. Use after ``list_radar_feed`` to drill into a specific signal — pass that item's ``id`` value as ``radar_item_id``.

get_radar_item

Full detail for a single optimization recommendation. Returns the complete recommendation including the signal that triggered it, suggested actions, and supporting data. Use after ``list_recommendations`` to drill into a specific recommendation — pass the ``id`` field from any item in that list.

get_recommendation

Get a full skill registry entry, including SKILL.md body (employee only).

get_registry_skill

Get a full skill resource row, including inline content (employee only).

get_registry_skill_resource

Brand reputation overview with theme-based score and theme breakdown. Returns the overall reputation score (percentage of positive themes), a positive/negative breakdown, and a summary of the recurring themes AI models associate with the brand. Use this for "what is AI saying about my brand's reputation?" questions. Defaults to the last 30 calendar days (UTC unless `timezone` is given) when no time window is given; pass start/end or lookback_days to scope it.

get_reputation_overview

Find which Google Search queries and pages are gaining or losing impressions, clicks, and click-through rate, from the workspace's connected Search Console. First-party Google Search performance, not AI-platform visibility. If the response is blocked because a coverage gap has reason ``property_scope_unavailable``, resolve the ambiguity before answering. Retry with the exact value from ``scope.available_property_scopes`` that uniquely matches the site named by the user or the workspace; if no single value matches, ask the user to choose from that list. Treat the blocked response as a request for scope, not as the final answer. Query grouping uses Search Console's native query report rather than re-aggregating page-dimensioned rows. ``webpage_id`` and ``page_title`` stay null when a URL maps to more than one webpage: an ambiguous page identity is left unresolved rather than guessed. Read ``limitations`` before making a claim. It carries only the conditions that apply to this result, each explaining what it does and does not qualify, so report one beside the claim it changes rather than as a closing block of caveats — a qualification that appears on every answer stops being read, including on the answer where it decided the call. Two facts hold throughout: a query absent from Search Console's bounded top rows is unknown rather than zero, and ``average_position`` is impression-weighted, never a rank observed on a results page.

get_search_performance

One target audience in detail: definition, history, and evidence. Returns the audience's definition, its ten most recent identity operations (splits, merges, re-scopes), and its ten most recent case notes. Both lists are windows, not the full history: an audience that has been re-scoped many times has older edges that this tool does not return.

get_audience

Latest website vitals report for the workspace's brand domain. Returns the most recent crawl results including technical SEO health checks, robots.txt status, llms.txt status, and sitemap-related issues. Use for "what technical issues does my site have that affect AI discoverability?" questions.

get_website_vitals

Brand voice profiles defined for the target workspace. Returns the list of brand voices available in the workspace, each representing a writing style, tone, and messaging guidelines. Use to discover which brand voice IDs can be passed to ``create_content_piece``.

list_brand_voices

List all competitors tracked by the target workspace. Returns each competitor's name, domain, and tracking status. Call this first to get competitor IDs needed by other tools.

list_competitors

Content items created in this workspace. Returns AI-generated content pieces (articles, video scripts, social posts) with their current status. Use to browse what content has been produced or to get content item IDs for ``get_content_item``.

list_content

Raw AI model responses for the tracked prompts in this workspace. Returns the actual responses generated by AI platforms (ChatGPT, Perplexity, Gemini, etc.) along with brand mention positions and citation data. Use to inspect exactly what AI models are saying about topics in the workspace's tracked prompt set. Not audience-scoped: this returns every execution in the workspace. Executions are exactly the population an audience scope restricts, so this listing will exceed an audience-scoped count for the same window.

list_prompt_executions

Prompt volume summary for the target workspace. Returns the total number of tracked prompts and prompt executions, plus a count of prompts in each funnel stage (e.g. awareness, consideration, decision). Does not include per-prompt identifiers, text, or metrics — use this for "how many prompts do I have, and how are they distributed across the funnel?" questions, not for ranking individual prompts. Defaults to the last 30 calendar days (UTC unless `timezone` is given) when no time window is given; pass start/end or lookback_days to scope it.

list_prompt_insights

Prompts (tracked questions) for this workspace. Returns each prompt's text, topic, funnel tag, and enabled state. Use to audit which questions are being tracked or to get prompt IDs before making changes. Not audience-scoped: this returns every prompt in the workspace, so its count will exceed an audience-scoped count for the same workspace.

list_prompts

Competitive intelligence feed — news, competitor changes, and market signals. Returns paginated radar items surfaced by Yolando's monitoring system. Optionally filter by full-text search or limit to unread items. Use for "what's changed with my competitors recently?" questions.

list_radar_feed

Surfaced optimization recommendations for the target workspace. Returns AI-generated recommendations for the workspace's discoverability, citation, and reputation metrics. Each recommendation includes a type, priority, and the signals that triggered it. Use to list recommendations or to get a recommendation ID for ``get_recommendation``.

list_recommendations