archive_audience
ChatGPTArchive a target audience (soft): it stops accepting assignments and drops out of fan-out, but stays selectable in insights with its history intact.
Overview
Yolando spots emerging trends, connects the dots, and moves before the market – or your competitors – see it coming. Connect your Yolando workspace to ask, in plain language, how ChatGPT and other AI assistants describe your business, where you're cited and where you're not, and how your visibility compares to your competitors'. Pull citation and reputation trends, track competitor movements, and get a prioritized list of what to create, optimize, or fix — all from your own workspace data, right inside the conversation. Requires a Yolando account.
Tools
archive_radar_item
ChatGPTArchive a radar feed item so it no longer appears in the feed.
assign_prompts_to_audience
ChatGPTAdd an audience to a list of prompts (existing audiences on those prompts are kept). Prompts with no audience are in DEFAULT.
assign_topics_to_audience
ChatGPTLink topics to an audience. New prompts created in those topics inherit it; with apply_to_prompts=true every existing prompt in them is linked too.
batch_update_prompts
ChatGPTEnable or disable a set of prompts in bulk. Disabled prompts are excluded from nightly AI platform runs.
cancel_keyword_research_job
ChatGPTCancel a queued or running keyword job in this workspace. A request already sent to Google may still finish; results collected so far remain readable.
create_audience
ChatGPTCreate a target audience in this workspace. Optionally link regions (from list_regions / create_region): a prompt assigned to the audience then runs once per region, which multiplies its cost by the number of regions.
create_chat_suggestion
ChatGPTCreate a chat empty-state suggestion (employee only). A suggestion is a prompt: clicking its pill sends `
message (falling back to label`) through the chat.create_competitor
ChatGPTAdd a competitor to this workspace by URL. Triggers a web crawl and brand profile analysis.
create_content_item_direct
ChatGPTCreate a content item with its body supplied directly. Fast-track entry: the item and markdown body are written straight to the content hub — no Research → Plan → Write pipeline, no background generation; it lands immediately as a draft with the provided body.
create_content_piece
ChatGPTCreate a new content item and enqueue AI generation. Kicks off the Research → Plan → Write pipeline. Returns immediately with the content item in `
"generating"` status — generation typically takes 5-15 minutes.create_prompts
ChatGPTAdd new tracked prompts to a topic. Prompts are the questions Yolando submits to AI platforms (ChatGPT, Perplexity, Gemini, etc.) to measure brand discoverability. Returns the created prompts.
create_region
ChatGPTCreate a region (market) for this workspace. Supply city/admin_region/timezone or latitude+longitude to make AI searches localise to it; country_code alone does not localise.
create_skill
ChatGPTCreate an Agent Skill in the catalog (employee only).
create_skill_resource
ChatGPTAdd a bundled resource file to an existing Agent Skill (employee only).
create_topic
ChatGPTCreate 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`.delete_brand_voice
ChatGPTDelete a brand voice from this workspace.
delete_chat_suggestion
ChatGPTSoft-delete a chat suggestion (employee only).
delete_competitor
ChatGPTRemove a competitor from this workspace.
delete_content_item
ChatGPTDelete a content item. Soft-deletes the content item and cascades to its pieces.
delete_prompts
ChatGPTDelete prompts from this workspace by ID.
delete_skill
ChatGPTSoft-delete a skill from the catalog (employee only). The slug is freed for reuse; usage history keeps referring to the deleted row.
delete_skill_resource
ChatGPTDelete a bundled skill resource file (employee only).
delete_topic
ChatGPTDelete a topic and all its prompts from this workspace. Soft-deletes the topic and cascade-soft-deletes its prompts.
get_audience
ChatGPTOne target audience by id, with its regions and counts.
get_citation_insights
ChatGPTAggregated 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_competitor_citation_trends
ChatGPTCitation 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_discoverability_trends
ChatGPTDiscoverability 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_reputation_trends
ChatGPTReputation 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_content_attribution
ChatGPTSearch clicks/impressions earned by Yolando-generated content, one row per content item matched to a live page.
get_content_attribution_daily
ChatGPTDay-by-day clicks/impressions and traffic for one content item, across all linked pages.
get_content_item
ChatGPTFull 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 the id` field from that list.get_insights_overview
ChatGPTBrand-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_keyword_research_job
ChatGPTStatus and results of a keyword job started by get_keyword_volumes, suggest_keywords or start_keyword_research in this workspace. While the job is queued or running,
keywords is empty or partial — wait and call again. Once completed, pages through the keywords: filter with search / min_volume / relevance, order with sort, and follow has_more with page. A status other than completed (partial, failed, cancelled, waiting_for_access) is reported with its error; missing volumes stay null and are never estimated.get_keyword_volumes
ChatGPTGoogle search-volume estimates for up to 500 exact keywords, read directly from Google Ads Keyword Planner for one country and language. Returns each keyword's estimated average monthly searches over the last 12 reported months, plus advertiser competition and top-of-page bid range. Usually answers in a few seconds; if the job is still running the response says so and gives a job_id for get_keyword_research_job. Repeating an identical request within 24 hours returns the earlier job. READING THE NUMBERS: volume null means Google returned nothing for that keyword (volume_status says why: not_returned, or invalid_keyword for text Google cannot measure such as punctuation or more than 10 words) — it is not zero. Google merges close variants, so a row with matched_as=close_variant carries the volume of google_keyword; never add rows together. ad_competition describes advertisers, not organic ranking difficulty — this server has no organic difficulty score.
get_platform_insights
ChatGPTDiscoverability, 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_by_brand
ChatGPTPlatform 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_topic
ChatGPTPlatform 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_radar_item
ChatGPTFull 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 the id` field from any item in that list.get_recommendation
ChatGPTFull 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_registry_skill
ChatGPTGet a full skill registry entry, including SKILL.md body (employee only).
get_registry_skill_resource
ChatGPTGet a full skill resource row, including inline content (employee only).
get_reputation_overview
ChatGPTBrand 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_search_performance
ChatGPTFind 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.
get_website_vitals
ChatGPTLatest 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.
list_audiences
ChatGPTTarget audiences defined in this workspace (who its content is meant to serve), every lifecycle state, with each audience's regions and current prompt/topic counts. The DEFAULT audience holds everything not assigned to a segment. Use the ids with target_audience_id on the insights tools, or with assign_prompts_to_audience.
list_brand_voices
ChatGPTBrand 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_competitors
ChatGPTList 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_content
ChatGPTContent 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_keyword_research_jobs
ChatGPTRecent keyword jobs in this workspace, newest first: kind (metrics = volume lookup, ideas, research), status, market, and how many keywords each requested and returned. Use it to find a job_id for get_keyword_research_job instead of repeating a lookup.
list_prompt_executions
ChatGPTRaw 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.
list_prompt_insights
ChatGPTPer-prompt insights for the target workspace. Use this to answer "which of my tracked prompts are doing best / worst?" — returns prompt-level discoverability and mention metrics. 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_prompts
ChatGPTPrompts (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.
list_radar_feed
ChatGPTCompetitive 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_recommendations
ChatGPTSurfaced 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_regions
ChatGPTRegions (markets) defined in this workspace — country, locale, city and whether the region localises AI search. Audiences are linked to regions; a prompt runs once per region across its audiences.
list_registry_skills
ChatGPTList skills in the authoring registry (employee only).
list_topics
ChatGPTTopics (thematic categories) defined in this workspace. Returns each topic's name, ID, and prompt count. Use this to discover topic IDs before creating prompts or to understand how the workspace's tracked questions are organized.
list_workspaces
ChatGPTList every workspace this token's user can currently access, with the scopes usable on each and an explicit
writable flag. Call this first whenever you are unsure which workspace to target, then pass the chosen id as workspace_id to the other tools and reuse it across calls in a session. Results are keyset-paginated: pass next_cursor back as cursor to continue, keeping search unchanged (changing the search restarts iteration without a cursor).promote_chat_suggestion_to_global
ChatGPTPromote a workspace suggestion to global (employee only). Clears the suggestion's workspace scope so every workspace sees it.
promote_skill_to_global
ChatGPTPromote a workspace skill to the global catalog (employee only). Clears the skill's workspace scope so every workspace sees it. Fails when a global skill already uses the slug.
set_prompt_audiences
ChatGPTReplace one prompt's audience set. An empty list means DEFAULT.
start_keyword_research
ChatGPTStart a full keyword research job for this workspace's own website: reads up to 20 pages of the brand site, asks Google Ads Keyword Planner for ideas from your seeds and from the site itself, then tags each keyword with a lexical relevance, intent, topic cluster and any existing page that already covers it. Takes one to three minutes. Returns a job_id immediately — poll get_keyword_research_job until status is completed. One research job per workspace at a time. The website is always the workspace's brand domain. Use get_keyword_volumes or suggest_keywords instead when you only need numbers for known keywords or quick ideas.
suggest_keywords
ChatGPTKeyword ideas related to 1-20 seed phrases, from Google Ads Keyword Planner, each with its estimated average monthly searches. Returns up to 1,000 ideas per job, highest volume first (sort=relevance gives Google's own order); page through them with get_keyword_research_job. Seeds are combined into one related-ideas query, so keep them on one theme. New or niche phrases can return only the seeds themselves. Volumes are estimates; null means Google returned no figure, never zero. Ideas overlap heavily — do not sum them. ad_competition is advertiser competition, not organic difficulty.
unassign_prompts_from_audience
ChatGPTRemove an audience from a list of prompts. A prompt left with no audience returns to DEFAULT.
unassign_topics_from_audience
ChatGPTUnlink topics from an audience; with apply_to_prompts=true the prompts in them are unlinked too.
update_audience
ChatGPTRename, describe, re-region, or archive/restore a target audience. Archiving keeps its history and links; the DEFAULT audience cannot be renamed or archived.
update_brand_voice
ChatGPTUpdate fields on an existing brand voice. At least one field must be provided.
update_chat_suggestion
ChatGPTUpdate a chat suggestion (employee only).
update_competitor
ChatGPTUpdate a competitor's brand profile. At least one of `
name, icon_url, or aliases` must be provided.update_content_item
ChatGPTUpdate a content item's title and/or body directly, without running the AI generation pipeline. Writing markdown saves a new revision; at least one of title or markdown is required.
update_prompt
ChatGPTMove a prompt to a different topic or change its funnel stage. At least one of `
topic_id or funnel_tag` must be provided.update_skill
ChatGPTUpdate a skill's content or active state (employee only). Content changes (description or instructions) bump the skill's revision so usage stays version-distinguishable.
update_skill_resource
ChatGPTUpdate a bundled skill resource file (employee only).
update_topic
ChatGPTRename a topic in this workspace. Use `
list_topics` to find the topic ID.upload_registry_skill_resource
ChatGPTUpload bytes to GCS and attach them as a skill resource (employee only).
Capabilities
Writes
Example Prompts
Click any prompt to copy it.
