---
name: gdtest-skill-curated
description: >
  Fetch, parse, and cache web content with gdtest-skill-curated.
  Use when writing Python code that fetches URLs, parses HTML,
  or needs in-memory caching.
license: MIT
compatibility: Requires Python >=3.10.
metadata:
  author: gdg-test-suite
  version: "1.0"
---

# gdtest-skill-curated

A lightweight toolkit for fetching, parsing, and caching web content.

## Installation

```bash
pip install gdtest-skill-curated
```

## When to use what

| Need | Use |
|------|-----|
| Fetch a URL | `fetch(url)` |
| Parse HTML content | `parse(html, selector)` |
| Cache results in memory | `CacheStore()` |
| Set cache TTL | `CacheStore(ttl=seconds)` |
| Limit cache size | `CacheStore(max_size=n)` |

## Gotchas

1. **Always set a timeout** when calling `fetch()` — the default is
   30 seconds, which may be too long for interactive use.
2. **`parse()` returns a list**, not a string. Even for a single
   match you get a one-element list.
3. **`CacheStore` is not thread-safe.** Use a lock if sharing across
   threads.
4. The module name is `gdtest_skill_curated`, not
   `gdtest-skill-curated`.

## Capabilities and boundaries

**What agents can configure:**

- Fetch URLs with custom timeouts
- Parse HTML with CSS selectors
- Create and query in-memory caches
- Set TTL and max size on caches

**Requires human setup:**

- Network access for `fetch()`
- Installing the package (`pip install`)

## Resources

- [llms.txt](llms.txt) — Indexed API reference for LLMs
- [llms-full.txt](llms-full.txt) — Full documentation for LLMs