research-serp
Когда использовать
Когда тебе нужно собрать первичный research-пакет: список релевантных источников по теме. Дальше writer-агент будет цитировать эти источники.
НЕ используй для: глубокого парсинга контента (это отдельная задача), проверки одного факта (для этого один URL → одна выписка, не SERP).
Алгоритм
- Sanitize topic. Убери лишние пробелы, новые строки. Если тема — markdown с заголовком и описанием, оставь только заголовок.
- Запусти скрипт:
Скрипт возвращает JSON последней строкой stdout:pnpm exec tsx skills/research-serp/scripts/search.ts "<topic>"{ "topic": "...", "results": [ {"title": "...", "url": "https://...", "snippet": "..."}, ... ], "errors": [] } - Интерпретируй. Отбрось результаты с:
- подозрительными доменами (spam-сайты, кликбейт)
- дубликатами по URL
- явно не relevant контентом (по title/snippet)
- Запиши итоговый research как markdown в output путь (передаётся
routine'ой). Формат:
# Research: <topic> Дата: YYYY-MM-DD ## Sources 1. [Title](url) — snippet ... ## Key facts (если уже видно из snippets) - ... ## Notes - ...
Ограничения
- DuckDuckGo может вернуть пусто или капчу — это попадёт в
errors. - Скрипт не ходит на сами страницы (deep parsing — отдельный скилл).
- Без VPN/прокси — географическая привязка ограничивает выдачу.