swain-search 是用于 swain-design 工件的素材采集、规范化与缓存工具，把 Web、本地文件与视频/音频等来源整理为可被引用的 trove 资料库。其模式包括：新建 trove、扩展已有 trove、刷新过期来源、按标签检索已有 trove。创建或搜索前会先做 prior art 检查，用关键词与语义主题匹配已有 trove，并输出可审计的路由决策，避免重复研究。
主要能力：支持网页搜索与 URL 抓取、认证站点（通过导出 cookies）、Google Docs/Drive、付费墙代理回退、YouTube/Instagram/播客等视频音频（字幕、描述、逐帧 OCR 分级回退）、X/Twitter 线程展开、本地文件、论坛、代码仓库、文档站点以及 CLI 工具的 manpage 与 --help 捕获。远程来源需先由脚本导出原始快照，记录到 .agents/search-snapshots/metadata.jsonl，并经验证后才可作为证据。
使用方式：脚本位于脚本目录，需先运行一次 bootstrap，要求 PATH 中存在 uv；快照导出、元数据记录与验证均有对应脚本，媒体与 X 线程流程前也需 bootstrap。
限制：若缺少网页搜索能力需告知用户并跳过；抓取失败会标记 failed；X 线程在无法展开时标记失败；帧提取与本地 OCR 等回退需操作者确认；具体价格、平台与效果等资料暂未提供。