Fetch MCP — URL → čistý Markdown

⏱ Odhadovaný čas 45 min

📍 Pozice Den 7, blok 3 / 7

🎯 Po tomto bloku budeš umět

• Fetch MCP nainstalovaný — `/mcp` ho ukazuje
• CC stáhl URL → Markdown — vyzkoušel/a jsi 2 různé weby
• Vidíš token cost realitu (fetch velkého článku = velký kontext)

🎯 Co Fetch MCP umí

Vezme URL a vrátí čistý Markdown obsah stránky. CC pak ten Markdown čte jako jakýkoli jiný text.

Use cases:

• 📰 Stáhnout článek (Wikipedia, BBC, news) → CC z toho udělá shrnutí / otázky
• 📚 Stáhnout dokumentaci → CC odpoví podle ní
• 🌐 Stáhnout cokoli, co by sis jinak otevíral/a v prohlížeči manuálně

Fetch MCP NEumí:

• ❌ Login na stránku (ChatGPT, gmail, paywally) — vrátí jen veřejný HTML
• ❌ Vykonat JavaScript (SPA aplikace, Cloudflare challenge) — vrátí raw HTML
• ❌ Přihlásit se za tebe — žádné cookies, headers

💡 Pro JavaScript-heavy stránky existuje Playwright MCP (browser automation, Y discovery v Bloku 06). Pro většinu studijních zdrojů (Wikipedia, gov sites, news) Fetch stačí.

---

1. Install (5 min)

claude mcp add fetch -s user -- npx -y @modelcontextprotocol/server-fetch

Stejný pattern jako Filesystem (Bloku 01) a Memory (Dne 4). Žádné argumenty — Fetch nepotřebuje sandboxing (URL jsou už explicit veřejné).

Ověření

claude mcp list

Vidíš memory, filesystem, fetch. ✅

---

2. První fetch (15 min)

V Claude Code chat (/mcp ukazuje fetch):

1. Test základní fetch:

   Fetch URL https://cs.wikipedia.org/wiki/Třicetiletá_válka
   a shrň mi do 5 vět, co se na té stránce píše.

2. Sleduj:

   • Tool call indikátor: ⏺ fetch(...) nebo podobné
   • CC stáhne stránku (pár sekund)
   • Vrátí 5-větné shrnutí

3. Pokud fetch selže:

   • „Connection refused” → firewall / corporate network blokuje. Zkus mobilní hotspot.
   • „403 Forbidden” → server odmítá user-agent. Většina veřejných stránek je OK.
   • „Empty content” → JavaScript-rendered SPA. Vyzkoušej jinou URL (Wikipedia, gov sites).

💰 Token cost reality — fetch velkého článku = velký context

Fetch celého Wikipedia článku může vrátit 5000-20 000 tokenů Markdown obsahu. To je podstatná část tvého context window.

Praktická pravidla:

• Krátké stránky (FAQ, definice): OK, fetch celé
• Velké články (Wikipedia main page): zkus přidat instrukci — „Fetch URL, ale NEvracej celý obsah. Místo toho udělej rovnou shrnutí (5 vět).” Agent může číst stránku ve více tool callech a vracet jen extracts.
• Pokud se context window plní rychle: /clear (Dne 4 Blok 03) — vyčistí historii session, ale zachová CLAUDE.md a skills

Free tier studenti — sleduj /cost po každém fetchi velkého článku.

---

3. Praktická úloha (15 min)

Student A

Use case: vytvoř maturitní otázky z aktuálního Wikipedia článku.

Fetch URL https://cs.wikipedia.org/wiki/Třicetiletá_válka
(nebo jiné téma které máš slabé). Z článku udělej 10 maturitních otázek:
- 5 otevřených (vysvětli, popiš, porovnej)
- 5 testových A/B/C/D s 1 správnou
Pokrytí: hlavní bitvy, hlavní postavy, dopady na ČR, datace.
Cílová úroveň: maturitní student v ČR.

Sleduj:

• ⏺ fetch(...) tool call
• CC vrátí strukturované otázky podle Wikipedie
• Pokud otázky jsou mimo téma (Wikipedia uvádí něco jiného než čekáš), je to známka, že tvoje poznámky jsou neaktuální — užitečný insight

Student B

Use case: vocabulary cards z autentického článku.

Fetch URL https://learningenglish.voanews.com/a/<vyber článek B1>/
(VOA Learning English nebo BBC Learning English). Z článku udělej:
- 8 vocabulary cards: slovíčko (EN) + kontext (věta z článku) + překlad (CZ)
- Vyber slovíčka, která pro úroveň B1 STOJÍ za naučení (ne basic, ne C1+)
- Pro každé slovíčko: 1 použitová poznámka (collocation, nuance)

Sleduj:

• ⏺ fetch(...) tool call
• CC vrátí 8 cards strukturovaně
• Pokud výběr slovíček je moc snadný nebo moc těžký, dej feedback agentovi: „Tahle 4 slovíčka jsem znala, vyber jiné”

---

✍️ Reflexe (5 min)

Do zaznamy.md:

1. Fetch MCP funguje: ✅ / ❌
2. Token cost reality: Sledoval/a jsi /cost před a po? Velký článek = jak velký skok?
3. Praktická užitečnost: Co tě nejvíc překvapilo na výstupu?
4. Limity Fetch MCP: Zkusil/a jsi URL, kterou Fetch nezvládl? (např. paywall, SPA)

---

🛟 Pokud se zasekneš

Symptom	Řešení
claude mcp add fetch selže	Stejné jako Filesystem (Dne 5/6 npm cache fix)
Fetch vrátí prázdný obsah	URL je SPA / Cloudflare-protected. Zkus alternativu
Fetch vrátí HTML místo Markdown	Server-side rendering OK, ale formát je horší. Agent tě požádá o explicit „převést na Markdown” — řekni ano
Token cost vyletí	/clear historii, fetch jen krátké výřezy. Free tier — pozor na quota
Fetch chybí v /mcp	Restart claude (/exit + claude)

---

🧪 Checkpoint 105 min (od začátku dne)

• claude mcp list ukazuje fetch (kromě memory + filesystem)
• V Claude Code /mcp vidíš všechny 3 ✅
• Vyzkoušel/a jsi 2 různé URL (alespoň 1 česká, 1 anglická)
• Vidíš token cost reality
• Reflexe v zaznamy.md (4 otázky)

---

✅ Fetch MCP funguje, vyzkoušel/a jsem 2 URL, vidím token cost

Pokračovat na blok 03: Multi-MCP workflow →