面向本机 Agent 的轻量研究工具：一次输入主题，采集官方原文与社媒经验，返回带 source_id 和 excerpt 的 ResearchPacket。工具负责确定性的采集、角色初分、精确去重和缺口记录；Codex、Hermes、Claude、Kimi 等宿主 Agent 负责真正的语义判断。
需要 Node.js 22+、本机 OpenCLI 和用于 PDF 的 /opt/homebrew/bin/pdftotext。
npm install
npm linknpm link 会提供两个与当前目录无关的命令：agent-search 和 agent-search-mcp。
agent-search research --topic "粤车南下申请条件和实测技巧"
agent-search research --topic "香港短期车险" --platform xiaohongshu --platform reddit结果写到 stdout，底层诊断只写 stderr。调用本身不会保存网页、研究包或日志。
各 Agent 都注册同一个 stdio 命令：
{
"mcpServers": {
"agent-search": {
"command": "agent-search-mcp"
}
}
}服务只暴露一个工具：research({ topic, as_of?, platforms? })。
source_role 只表示来源身份：政府/监管、商业第一方、权威二手、社媒经验或未知。它不等于证据状态。
宿主 Agent 根据包内 judgment_protocol 产出最终判断：
verified：与来源角色相称的一手原文支持；corroborated：至少两个真正独立的经验来源一致，且不违反官方规则；lead：有价值但证据不足；conflict：来源存在实质冲突。
- 小红书：搜索、笔记正文、评论；
- Reddit：搜索、帖子和评论；
- B站：搜索、视频信息、字幕、评论；无字幕时不能升级为事实；
- 抖音：首版仅可靠用于发现，没有可读正文的结果保持为 lead；
- 官方网页/PDF：直接读取原页，搜索摘要不进入 excerpt。
社媒能力使用本机 OpenCLI 已有登录态。登录失效、验证码、风控、地区限制、正文或字幕不可用都会进入 gaps，不会阻断其他来源，也不需要每个 Agent 再走一套授权参数。
sources 中的原帖/字幕和评论各自绑定自己的作者与 excerpt；每个深读结果最多保留两条有作者评论。没有正文的抖音等发现项进入独立 leads 数组，URL 会保留，但搜索摘要不会冒充原文。
如果 macOS 的代理 DNS 返回 198.18.0.0/15 fake-IP，官方原页 reader 会用固定直连 DoH 取得真实公网地址后再绑定连接；它不会读取代理配置或把 fake-IP 当作安全目标。
npm test完整设计与边界见 docs/design.md。