MCP server

Dostupné nástroje

Kompletní přehled nástrojů, které Ranketta MCP server nabízí, rozdělený podle oblastí.

Každý z nástrojů níže běží v rámci vašeho přihlášeného účtu Ranketty a jeho existující role a oprávnění k modulům, stejně jako v samotné aplikaci. Většina nástrojů přijímá website_id, kterým určíte, na který web se mají vztahovat. Názvy a popisy nástrojů používají stejné pojmy jako aplikace Ranketta (v angličtině), aby agent dokázal nástroj spárovat se stránkou, kartou nebo tlačítkem, které vidíte.

Weby

Nástroj	Co dělá
`list_websites`	Vypíše všechny weby dostupné přihlášenému uživateli.
`get_website_profile`	Název, doména, země a Aliases webu.

Overview

Nástroj	Co dělá
`get_overview_stats`	Horní karty stránky Overview: Your Visibility, Your Average Position, Your Sentiment Score, Your Share of Voice a Top Competitor, včetně změn za období.
`get_overview_chart`	Graf Overview (Overall Visibility / Overall Position / Overall Sentiment / Overall Share of Voice) napříč všemi prompty, jedna řada na konkurenta.
`get_overview_chart_by_ai_model`	Graf Overview podle AI modelu (Your Visibility / Your Position / Your Sentiment / Your Share of Voice, Across All Prompts by AI model).
`get_overview_competitor_scatter`	Graf Purchase Likelihood: Visibility vs. Average Sentiment Score pro vaši značku a konkurenty.
`get_visibility_by_ai_model`	Visibility za jedno období podle AI modelu (ChatGPT, Perplexity, Gemini a další).
`list_ai_models`	Vypíše všechny AI modely sledované pro daný workspace.

Citations a Query Fan-out

Nástroj	Co dělá
`get_citation_stats`	Horní karty stránky Citations: Citation Pages, Covered Pages, Mention Rate a Citation Domains. Podporuje `topic_ids` a `mentioned_status` (`all` / `mentioned` / `not_mentioned` = filtr Mentions All / Mentioned / Not Mentioned, výchozí `all`).
`get_citation_urls`	Pohled Pages na stránce Citations: stránkované citační stránky s usage rate, plus filtry search, `mentioned_status`, typ a `topic_ids`.
`get_citation_domains`	Pohled Domains na stránce Citations: stránkované citační domény s usage rate, plus filtry search, `mentioned_status`, typ a `topic_ids`.
`get_citation_prompts`	Prompty, ve kterých se objevuje daná citační stránka nebo doména, včetně usage rate u každého promptu. Podporuje `topic_ids`.
`get_citation_domain_types_breakdown`	Podíl citací podle typu domény (Corporate, UGC, Editorial, Review, Institutional, Social media, E-commerce, Wiki, News, Other). Podporuje `topic_ids` a `mentioned_status`.
`get_citation_page_types_breakdown`	Podíl citací podle typu stránky (Landing page, Blog post, Press release, Guide, Listicle, Comparison, Review, Product page, Product category, Documentation, Data report, Other). Podporuje `topic_ids` a `mentioned_status`.
`get_query_fanouts`	Query Fan-outs pro daný web, s usage rate a stránkováním.

Site Audit

Nástroj	Co dělá
`get_site_audit`	Souhrn Site Audit: celkové skóre plus Technical SEO, Content Quality a AEO Score.
`get_site_audit_pages`	Stránkované stránky ze Site Audit, s filtry na skóre a řazením.
`start_site_audit`	Start Site Audit: spustí nové procházení webu.
`analyze_page`	Jak AI vidí danou URL: markdown viditelný pro AI, Technical SEO, Content Quality, AEO Score a issues.
`add_page_to_site_audit`	Analyze new page: přidá jednu URL do Site Audit (vrací jen ID auditu/stránky).
`check_schema_org`	Zkontroluje Schema.org markup na stránce (volitelné `url`, jinak homepage).
`check_wikipedia`	Zkontroluje, zda má doména webu stránku na Wikipedii.

Prompts

Nástroj	Co dělá
`get_prompts`	Tabulka Prompts, volitelně filtrovaná podle tématu a textu, `is_active` (`true` záložka Active, `false` záložka Drafts, bez hodnoty obojí), s paginací `limit`/`offset` (max. 100 na stránku). Řádky nesou Visibility, Position, Sentiment score, Share of voice, Tags a Search volume.
`get_prompt_details`	Detail promptu a souhrnné statistiky, podle ID nebo textu promptu.
`create_prompt`	Vytvoří nový prompt do záložky Active pro web a volitelné téma.
`list_countries`	Vypíše dostupné země (kódy a ID) pro web, hodí se při vytváření promptu.
`list_topics`	Vypíše témata dostupná pro prompty v daném webu.
`create_topic`	Vytvoří nové téma pro prompty.
`list_tags`	Vypíše Tags dostupné pro prompty v daném webu.
`create_tag`	Vytvoří nový Tag pro prompty.
`add_tags_to_prompts`	Přidá existující Tags k jednomu nebo více promptům, bez odebrání těch, které na nich už jsou.
`move_prompts_to_topic`	Přesune prompty do tématu; bez `topic_id` je odřadí (uncategorized).
`delete_prompts`	Trvale smaže prompty podle ID (nejprve potvrď s uživatelem).
`reject_prompts`	Zamítne (smaže) jen Drafts; seznam přes `get_prompts(is_active=false)`.
`research_topics`	Prompt research: související témata podle klíčového slova nebo domény konkurenta (záložka Research).
`generate_prompts_for_topics`	Vygeneruje Drafts pro 1-3 klíčová slova témat, nebo pro jedno existující téma přes `topic_id`; Start tracking přes `track_research_prompts`.
`track_research_prompts`	Start tracking vybraných Drafts (přesunou se do záložky Active) z `get_prompts(is_active=false)` nebo generate nástrojů.
`get_prompt_citations`	Citační stránky pro prompt, identifikovaný textem.
`get_prompt_query_fanouts`	Query Fan-outs pro prompt, identifikovaný textem.
`get_prompt_responses`	Responses pro jeden prompt, se stránkováním, časovým rozsahem a filtry na AI model.
`get_responses`	Stránka Responses: odpovědi AI modelů napříč všemi prompty, s filtry a řazením.
`get_prompt_chart_data`	Graf v detailu promptu (Visibility / Position / Sentiment / Share of Voice) v čase.
`get_prompt_competitors`	Tabulka konkurentů v detailu promptu, s Visibility, Position, Sentiment a Share of Voice.

Watchlist (Competitors)

Nástroj	Co dělá
`list_competitors`	Konkurenti ve Watchlist pro web (`is_active` `true` Tracked, `false` Suggested a Not tracked, bez hodnoty vše).
`list_competitor_aliases`	Aliases jednoho konkurenta.
`add_competitor_aliases`	Group selected: sloučí další konkurenty do jednoho jako Aliases.
`remove_competitor_alias`	Ungroup alias: odpojí alias, který se stane samostatným konkurentem.
`update_competitor_domain`	Nastaví nebo vymaže doménu konkurenta.
`create_competitor`	Přidá nového konkurenta do Watchlist a začne ho sledovat.
`set_competitors_tracking`	Start nebo stop tracking pro jednoho, více, nebo všechny konkurenty ve Watchlist (`is_active`, `competitor_ids` nebo `all_competitors`).

Actions

Nástroj	Co dělá
`list_actions`	Řádky stránky Actions pro web, s filtry na stav, typ a vyhledávání.
`create_action`	Vytvoří novou akci.
`complete_action`	Mark as done: nastaví akci na Completed.
`archive_action`	Archive: archivuje akci, volitelně s důvodem.
`star_action`	Označí nebo zruší hvězdičku u akce (`starred` volitelné; bez něj přepne).

Content Studio

Nástroj	Co dělá
`list_content_types`	Vypíše aktivní typy obsahu dostupné pro New Content.
`list_content`	Seznam Content Studio, s filtry na vyhledávání, stav (Draft / Generating / Optimizing / Completed / Exported) a typ obsahu.
`create_content`	New Content: prázdný, z URL nebo z existujícího článku; prázdná cesta rovnou spustí generování.
`optimize_content`	Optimalizuje existující obsah, v základním nebo SEO/GEO režimu.

Sentiment

Nástroje stránky Sentiment (snippet-based). Brand Perception je dostupný jen v Agent mode, ne přes MCP.

Nástroj	Co dělá
`get_snippet_sentiment_over_time`	Sentiment trend ze stránky Sentiment, včetně karet Sentiment Score, Positive Snippets, Negative Snippets a Responses Analyzed.
`get_snippet_highlights`	Positive Snippets a Negative Snippets o vaší značce ze stránky Sentiment.
`get_snippet_perception`	Head-to-Head Comparison ze stránky Sentiment: vaše značka vs. volitelný konkurent.
`list_snippet_source_domains`	Citační domény se snippety o vaší značce (filtr Sources).

Shopping

Nástroj	Co dělá
`get_shopping_overview_stats`	Horní karty Shopping Overview: Your Product Visibility, Your Product Position, Your Product Sentiment, Your Merchant Visibility a Your Merchant Share of Voice.
`get_shopping_overview_chart`	Graf Shopping Overview napříč všemi Product Recommendations (`product_` / `merchant_`).
`get_shopping_overview_competitor_scatter`	Graf Purchase Likelihood v Shopping Overview pro značky.
`get_shopping_top_performers`	Top performers: produkty, které AI modely doporučují, s metrikami viditelnosti (`mine_only` = filtr My Products).
`get_shopping_products`	Tabulka My Products, se skóre zdraví a viditelností.
`get_shopping_product_detail`	Kompletní detail položky z My Products: atributy, obrázky, viditelnost.
`enrich_shopping_product`	Enrich: zařadí do fronty běh obohacovacího agenta pro jeden produkt.

Shopping feedy (Feed sources, Channels, Proposals, Audiences)

Vyžaduje modul merchandiser. Jen config a sync, bez mazání. Review Proposal (approve, reject, revert) je dostupný přes MCP.

Nástroj	Co dělá
`list_feed_formats`	Podporované formáty feedů pro Feed sources a Channels.
`list_feed_sources`	Feed sources se stavem syncu.
`get_feed_source`	Detail jednoho Feed source.
`create_feed_source_from_url`	Vytvoří Feed source z URL a spustí první import.
`update_feed_source`	Aktualizuje název nebo active flag Feed source.
`sync_feed_source_now`	Spustí okamžitý re-import.
`list_channels`	Channels webu.
`get_channel`	Detail jednoho Channel.
`create_channel`	Vytvoří nový Channel.
`update_channel`	Aktualizuje filtry produktů a active flag Channel.
`get_channel_schema`	Schema / sloty Channel (jen čtení; mapping se mění v aplikaci).
`get_product_enrichment_options`	Enrichment možnosti pro produkt.
`list_enrichment_proposals`	Proposals (filtr podle statusu).
`approve_enrichment_proposal`	Schválí pending Proposal a aplikuje ho na produkt.
`reject_enrichment_proposal`	Zamítne pending Proposal bez aplikace.
`revert_enrichment_proposal`	Vrátí schválený, auto_approved nebo rejected Proposal zpět do pending review.
`list_audiences`	Audiences (uložené publikum / ICP).

ChatGPT Ads

Reklamy, které se objevily v trackovaných ChatGPT odpovědích tohoto webu (stejná data jako stránka ChatGPT Ads). total_count / rendered_count jsou počty zobrazení v těchto odpovědích, ne imprese reklamní sítě.

Nástroj	Co dělá
`get_ads_overview_stats`	Horní karty ChatGPT Ads: Total Ads Found, Your Ad Presence, Other Advertisers a Rendered Rate.
`list_ads`	Tabulka All Ads: stránkované kreativy (jeden řádek na inzerenta + titul). Výchozí řazení podle počtu zobrazení.
`list_ad_advertisers`	Advertisers: inzerenti s největší přítomností v ChatGPT reklamách.
`get_ad_detail`	Jeden inzerent nebo kreativa: statistiky, vzhled (`body`, obrázek, cílová URL) a prompty, na kterých se reklama zobrazila.

Řada těchto endpointů je dostupná i na veřejném REST API, pro integrace, které místo MCP používají API klíče.

Úvod

Propojte Claude, Cursor a další MCP klienty přímo s daty z Ranketty přes Model Context Protocol.