Live SERP data pro AI agenty: Jak jsme přidali analýzu vyhledávání v reálném čase do TeamDay

Únor 2026. Váš AI agent tvrdí, že jste na 3. místě pro určitý klíčový výraz. Ale kdy to naposledy kontroloval?

Historická data jsou skvělá pro trendy. SEO se však pohybuje rychle. Google zavádí AI přehledy, konkurenti spouštějí nové stránky, featured snippety se mění každý den. Potřebujete vidět, jak SERP vypadá právě teď.

Proto jsme postavili MCP server, který dává AI agentům live SERP data.

---

Mezera v našem SEO stacku

TeamDay již měl výkonné SEO nástroje:

• Ahrefs — zpětné odkazy, domain rating, obtížnost klíčových slov, konkurenční analýza
• SE Ranking — sledování klíčových slov, site audity, monitorování pozic v čase
• Google Search Console — vaše skutečná data o kliknutích a zobrazení

Ale žádný z nich vám neukáže, jak stránka výsledků vyhledávání vypadá právě teď. Ahrefs vám dá metriky klíčových slov. SE Ranking sleduje vaši pozici v čase. Search Console zobrazuje kliknutí ze včerejška.

Co vám neřeknou: Je tam featured snippet? Přidal Google AI přehled? Jsou místní výsledky, které tlačí organické dolů? Inzeruje konkurent na vaší značce?

To jsou live SERP data. A nyní je agenti TeamDay mají.

Co jsme postavili: DataForSEO SERP MCP Server

Zabalili jsme DataForSEO SERP API do MCP serveru — standardního protokolu, který propojuje nástroje s AI agenty. Šest nástrojů pokrývajících vše, co potřebujete:

Nástroje

Nástroj	Co dělá	Cena
google_serp_live	Kompletní Google SERP — každý typ elementu	~$0,0025
google_serp_regular	Rychlé organické + placené výsledky	~$0,001
google_locations	Vyhledání geo-targeting kódů	Zdarma
google_languages	Dostupné jazykové kódy	Zdarma
bing_serp_live	Kompletní výsledky Bing SERP	~$0,002
youtube_serp_live	Žebříčky videí na YouTube	~$0,002

Cena je zanedbatelná. Kompletní SERP dotaz stojí $0,0025. To je 400 dotazů za dolar. Nové účty DataForSEO dostávají $1 zdarma — dost pro 400+ vyhledávání při hodnocení.

Co dostanete zpět

Když agent zavolá google_serp_live, dostane každý element stránky výsledků:

• Organické výsledky — pozice, titulek, URL, doména, popis
• Featured snippety — odpovědní rámeček nahoře
• Knowledge graph — informační panel vpravo
• AI přehled — AI generovaný souhrn od Google
• Lidé se také ptají — příbuzné otázky
• Local pack — výsledky na mapě s firemními výpisy
• Placené reklamy — kdo nabízí na klíčové slovo
• Obrázky, videa, zprávy — mediální karusely

Vše ořezané na podstatné pole, aby se váš agent neutopil v tokenech.

Jak to funguje v TeamDay

Nastavení: 2 minuty

1. Přejděte do Nastavení → Integrace ve svém prostoru TeamDay
2. Najděte DataForSEO SERP na tržišti
3. Zadejte svůj přihlašovací e-mail DataForSEO a heslo API
4. Hotovo — vaši AI agenti mají nyní přístup k live SERP datům

Reálné pracovní postupy

Zde je to, co vaši agenti mohou s těmito daty skutečně dělat:

1. Konkurenční SERP audit

„Ukažte mi, kdo se umísťuje pro ‘ai project management’ a jaké SERP funkce se zobrazují.”

Váš agent zavolá google_serp_live a dostane kompletní obrázek: organické pozice, zda existuje featured snippet (a kdo ho má), jestli Google zobrazuje AI přehled a jaké reklamy běží. Za sekundy, ne hodiny ručního kontrolování.

2. Analýza mezer v obsahu

„Porovnej naše umístění na Google vs. Bing pro našich top 10 klíčových slov.”

Agent se dotáže na google_serp_live i bing_serp_live pro každé klíčové slovo a shrne, kde se vaše pozice liší. Bing často zobrazuje jiné výsledky — a jeho rostoucí podíl na trhu (zejména přes Copilot) stojí za sledování.

3. Porovnání mobilu a desktopu

„Zkontroluj, zda se naše umístění liší mezi mobilem a desktopem pro ‘team collaboration tools’.”

Předejte device: "mobile" vs. device: "desktop" a agent nahlásí rozdíly. Mobilní SERPy vypadají často velmi odlišně — méně organických míst, více místních výsledků, různé featured snippety.

4. YouTube SEO

„Co se umísťuje na YouTube pro ‘claude code tutorial’? Kde se zobrazují naše videa?”

youtube_serp_live vrací žebříčky videí, kanály a výsledky playlistů. Nezbytné pro strategii video obsahu.

5. Monitoring místního SERP

„Jak vypadají výsledky vyhledávání pro ‘ai consulting’ v San Franciscu vs. New Yorku?”

Použijte google_locations k nalezení kódů lokace, pak spusťte SERP dotazy pro každé město. Místní výsledky se mohou geograficky dramaticky lišit.

Kompletní stack SEO inteligence

S přidaným DataForSEO SERP mají agenti TeamDay nyní kompletní pipeline SEO inteligence:

┌─────────────────────────────────────────────────────────┐
│  1. SERP Snapshot (DataForSEO)                          │
│     Jak stránka výsledků vypadá PRÁVĚ TEĎ?              │
│     → Pozice, funkce, reklamy, AI přehledy              │
├─────────────────────────────────────────────────────────┤
│  2. Klíčová inteligence (Ahrefs)                        │
│     Jak obtížné je toto klíčové slovo? Jaká je návštěvnost? │
│     → Objem, obtížnost, potenciál návštěvnosti, CPC     │
├─────────────────────────────────────────────────────────┤
│  3. Historické sledování (SE Ranking)                   │
│     Jak se naše pozice měnila v čase?                   │
│     → Denní sledování pozic, monitoring konkurence      │
├─────────────────────────────────────────────────────────┤
│  4. Reálný výkon (Search Console)                       │
│     Jaká kliknutí a zobrazení jsme skutečně získali?    │
│     → CTR, zobrazení, skutečné vyhledávací dotazy       │
├─────────────────────────────────────────────────────────┤
│  5. Chování uživatelů (Google Analytics)                │
│     Angažují se návštěvníci z vyhledávání?              │
│     → Míra opuštění, čas na stránce, konverze          │
└─────────────────────────────────────────────────────────┘

Každý nástroj odpovídá na jinou otázku. AI agent se všemi pěti dokáže autonomně provést komplexní SEO analýzu — od analýzy SERP přes výzkum klíčových slov až po validaci výkonu.

Technické detaily (pro zvídavé)

Architektura

MCP server je lehký Node.js proces komunikující přes stdio (standardní vstup/výstup):

Claude Agent ←→ MCP protokol (stdio) ←→ DataForSEO SERP Server ←→ DataForSEO API v3

Žádné závislosti nad rámec MCP SDK. Používá nativní fetch pro HTTP, Basic Auth pro API. Server se spouští okamžitě a má nulový paměťový otisk při nečinnosti.

Ořezávání odpovědí

DataForSEO vrací velmi podrobná SERP data. Jeden dotaz může vyprodukovat 50KB+ JSON s hluboce vnořenými strukturami elementů. Každý výsledek ořezáváme na pole, která agenti skutečně potřebují:

• type — organic, featured_snippet, knowledge_graph, local_pack atd.
• rank_group a rank_absolute — pozice na stránce
• title, url, domain, description — obsah
• rating, price, snippet — zahrnuty pokud jsou přítomny

Tím jsou náklady na tokeny rozumné a zároveň jsou zachovány všechny použitelné informace.

Live vs. task-based

DataForSEO nabízí jak live (synchronní) tak task-based (asynchronní) endpointy. Používáme výhradně live endpointy, protože:

1. Okamžité výsledky — žádné polling, žádné čekání
2. Bezestavové — MCP stdio servery nepřetrvávají mezi voláními
3. Jednodušší — jeden požadavek, jedna odpověď
4. Pokrývá 95 % případů — task-based je potřeba jen pro hromadné operace

Začínáme

Pokud jste již na TeamDay

1. Otevřete Nastavení → Integrace svého prostoru
2. Vyhledejte „DataForSEO”
3. Přidejte své přihlašovací údaje (zaregistrujte se zde — $1 zdarma)
4. Zeptejte se svého agenta: „Jak vypadá Google SERP pro [vaše klíčové slovo]?”

Pokud používáte Claude Code přímo

Přidejte do svého .mcp.json:

{
  "mcpServers": {
    "dataforseo-serp": {
      "command": "npx",
      "args": ["-y", "@teamday/mcp-dataforseo-serp"],
      "env": {
        "DATAFORSEO_LOGIN": "[email protected]",
        "DATAFORSEO_PASSWORD": "vase_api_heslo"
      }
    }
  }
}

Pak použijte nástroje jako:

mcp__dataforseo-serp__google_serp_live(keyword="vaše klíčové slovo", location_code=2203)

Běžné kódy lokalit

Kód	Lokalita
2840	Spojené státy
2826	Spojené království
2276	Německo
2250	Francie
2392	Japonsko
2036	Austrálie
2124	Kanada
2203	Česká republika

Použijte google_locations s dotazem k nalezení libovolného kódu lokalit, který potřebujete.

---

Co bude dál

Toto je v1 — live endpointy pokrývající nejčastější případy. Budoucí přídavky mohou zahrnovat:

• SERP screenshoty — vizuální snímky stránek výsledků vyhledávání
• Plánovaný SERP monitoring — automatické denní kontroly přes mise TeamDay
• SERP diff reporty — „co se změnilo od minulého týdne?”
• Hromadná analýza více klíčových slov — kontrola 50 klíčových slov najednou

MCP server je open source v repozitáři agentů TeamDay. Pull requesty vítány.

---

DataForSEO SERP je nyní dostupný ve všech prostorech TeamDay. Přidejte ho z Nastavení → Integrace, nebo nainstalujte přímo přes npx -y @teamday/mcp-dataforseo-serp.