agentic-search
/agentic-search
Prowadzi głęboki research webowy z cytatami, wspierany przez Tavily i Firecrawl: pobieranie stron do Markdown, mapowanie witryn, cytaty dosłowne, reranking źródeł i wielokrokowe sesje.
- Autor
- appautomaton ↗
- Repozytorium
- webmaton ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 25.08.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 16
- Skrypty
- 9
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 25.08.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- 9 skryptów w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.
Skrypty: scripts/_http.py, scripts/_prompts.py, scripts/_session.py, scripts/agentic_extract.py, scripts/agentic_fetch.py, scripts/agentic_get_sources.py, scripts/agentic_map.py, scripts/agentic_rank.py
Co robi i kiedy
Prowadzi głęboki research webowy z cytatami, wspierany przez Tavily i Firecrawl: pobieranie stron do Markdown, mapowanie witryn, cytaty dosłowne, reranking źródeł i wielokrokowe sesje.
Oryginalny opis (EN)
Grok-primary deep research skill for source-backed web work. Use when the task needs current web research, grounded citations, supplementary Tavily/Firecrawl source discovery, high-fidelity page-to-Markdown fetch, Tavily site mapping, verbatim quote extraction, source reranking, or reusable multi-step research sessions. Use as a supplement when ordinary search results feel incomplete, thinly sourced, or need more URLs, quotes, fetched pages, or session composition; not for simple one-off facts.
Jak działa
- How to invoke
- Session workflow
- Operating discipline
- Failure modes
Podgląd SKILL.md
---
name: agentic-search
description: "Grok-primary deep research skill for source-backed web work. Use when the task needs current web research, grounded citations, supplementary Tavily/Firecrawl source discovery, high-fidelity page-to-Markdown fetch, Tavily site mapping, verbatim quote extraction, source reranking, or reusable multi-step research sessions. Use as a supplement when ordinary search results feel incomplete, thinly sourced, or need more URLs, quotes, fetched pages, or session composition; not for simple one-off facts."
---
# agentic-search
| # | Script | Intent |
|---|---|---|
| 1 | `scripts/agentic_search.py` | Research a topic — AI-reasoned answer with citations |
| 2 | `scripts/agentic_fetch.py` | Full page → Markdown, no summarization |
| 3 | `scripts/agentic_map.py` | Enumerate URLs under a site (Tavily-only) |
| 4 | `scripts/agentic_extract.py` | Verbatim title + 2–4 quotes from a URL |
| 5 | `scripts/agentic_rank.py` | Rerank session sources by a refined query |
| 6 | `scripts/agentic_get_sources.py` | Retrieve or list cached sessions |
## How to invoke
All scripts use PEP 723 inline deps — always invoke via `uv run`. Allow up to 3 minutes per call.
```bash
uv run scripts/agentic_search.py --query "..." [--extra-sources N] [--auto-fetch-top N] [--platform "..."]
uv run scripts/agentic_fetch.py --url "..." [--engine auto|tavily|firecrawl|grok]
uv run scripts/agentic_map.py --url "..." [--instructions "..."] [--limit N]
uv run scripts/agentic_extract.py --url "..." [--session-id S]
uv run scripts/agentic_rank.py --query "..." --session-id S
uv run scripts/agentic_get_sources.py --list | --session-id S
```
## Session workflow
`agentic_search` generates a `session_id` persisted to disk — the connective tissue for composing steps:
```
agentic_search → session_id
├─→ agentic_rank --session-id S --query Q (rerank in place; mutates session)
├─→ agentic_extract --session-id S --url U (append verbatim quotes)
└─→ agentic_get_sources --session-id S (inspect full session)
```
Sessions survive between invocations but may be cleared on OS reboot.
## Operating discipline
Load the relevant reference before composing a non-trivial query — don't load all four upfront.
- **`references/search-discipline.md`** — two-pass methodology, citation contract, time-context heuristic. Read for research tasks.
- **`references/fetch-fidelity.md`** — engine trade-offs, fidelity guarantees, when not to fetch. Read before presenting extracted content.
- **`references/extract-and-rank.md`** — extract vs fetch, when to rank, session composition patterns. Read for multi-step workflows.
- **`references/provider-quirks.md`** — env vars, provider schemas, retry policy, debugging. Read when configuring or debugging.
## Failure modes
- No `GROK_API_KEY` / `GROK_API_URL` → config error on any Grok-using script.
- `agentic_fetch --engine auto` total failure → retry with `--engine grok` or fall back to built-in `WebFetch`.
- `agentic_map` without `TAVILY_API_KEY` → hard exit.
- `agentic_rank --session-id S` session expired → re-run `agentic_search`.
- `sources_count: 0` with non-empty `content` → Grok used training data; check `providers_used` (`grok-web-search` = real citations, `grok` = heuristic fallback).
Pliki w paczce (16)
- .env.search.template 3 KB
- .gitignore 1 KB
- SKILL.md 3 KB
- references/extract-and-rank.md 3 KB
- references/fetch-fidelity.md 5 KB
- references/provider-quirks.md 3 KB
- references/search-discipline.md 6 KB
- scripts/_http.py 19 KB
- scripts/_prompts.py 9 KB
- scripts/_session.py 5 KB
- scripts/agentic_extract.py 6 KB
- scripts/agentic_fetch.py 8 KB
- scripts/agentic_get_sources.py 2 KB
- scripts/agentic_map.py 4 KB
- scripts/agentic_rank.py 8 KB
- scripts/agentic_search.py 35 KB
Wersje
W bazie nie ma innych skilli o nazwie agentic-search.
Migawka bazy z 13.11.2026 · wersja paczki 0e70df66722e (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100tavily-deep-research
Wyszukuje w sieci, wyciąga treść z adresów URL i mapuje strukturę witryn przez Tavily w SandBase, także do czytania całych artykułów i szukania newsów. - 100tavily-web
Prowadzi badania w sieci, wyszukuje źródła, pobiera treść stron, mapuje i przeszukuje witryny przez Tavily. - 100tavily-research
Prowadzi pogłębiony research z cytatami przez CLI Tavily i zwraca ustrukturyzowany raport oparty na źródłach internetowych, na przykład porównania, analizy rynku i przeglądy literatury. - 100tavily-web
Wyszukuje w sieci, wyciąga treść z adresów URL, crawluje witryny i prowadzi research przez API Tavily, gdy potrzebne są aktualne informacje. - 100tavily-web
Wyszukuje w sieci, wyciąga treść z adresów URL, crawluje witryny i prowadzi research przez API Tavily, gdy potrzebne są aktualne informacje. - 100multi-search
Wyszukuje równolegle w wielu źródłach (Web, Scholar, Smart, Tavily) z oceną pewności i syntezą AI, do badań wymagających krzyżowej walidacji źródeł.