| name | agentrs-search |
| description | 联网搜索工具箱 —— 通过京东 agentrs 代理网关，用单一 Bearer Token 调用 4 个搜索引擎： tavily(AI搜索)、cloudsway(必应/Bing,可拿网页全文)、SearchPro(搜狗,实时新闻时效最强)、 jdcloud_search(京东云RAG,返回整页正文)。当需要联网检索资讯、新闻、研报、实时信息， 或要抓取网页正文做后续分析时使用。触发词：联网搜索、实时搜索、查资讯、查新闻、 搜一下、tavily、bing、cloudsway、搜狗、京东搜索、web search、抓网页正文。
|
agentrs-search —— 联网搜索（4 引擎）
通过 https://agentrs.jd.com/api/saas/proxy-k/v1/<tool>，单一 Bearer Token 调 4 个搜索引擎。
鉴权与调用约定（先读）
- 环境变量取密钥，不硬编码：
export JD_AGENTRS_TOKEN='你的token'
- 网关只认 JSON body：文档标 GET/POST 都不影响，query string 会报"缺少必要输入参数"。
- HTTP 恒 200，业务看 body：
1001=token 未授权（充值/补参无用）；9999 缺少必要输入参数=参数错；9999 用户积分不足=余额不足（重试常能通）。
4 个引擎怎么选
| 引擎 | 底层 | 入参 | 结果路径 | 选用场景 |
|---|
tavily | Tavily | {query} | results[] | 通用 AI 搜索，默认首选 |
cloudsway | Bing/必应 | {q,count,freshness,enableContent,contentType,mainText,sites,blockWebsites} | webPages.value[] | 中文好；enableContent=true 直接拿网页正文；sites/blockWebsites 站点过滤；freshness=Day/Week/Month 时间过滤 |
searchpro | 搜狗 | {Query,Cnt,Site,Industry,...} | Response.Pages[]（元素是字符串化JSON，需二次 parse） | 实时新闻/天气，时效性最强 |
jdcloud | 京东云 RAG | {query} | data[]（page_content 整页正文 + recall_distance） | 要整页全文做分析时 |
用法
export JD_AGENTRS_TOKEN='...'
python3 scripts/search.py tavily "人工智能最新趋势"
python3 scripts/search.py cloudsway "中信建投证券" --count 5 --enableContent true --mainText true
python3 scripts/search.py searchpro "今天北京天气"
python3 scripts/search.py jdcloud "AI agent 发展"
打印规整 JSON；遇 1001/9999 在 stderr 给可读提示。
直接 curl
curl -s https://agentrs.jd.com/api/saas/proxy-k/v1/tavily_search \
-X POST -H "Content-Type: application/json" \
-H "Authorization: Bearer $JD_AGENTRS_TOKEN" \
-d '{"query":"搜索关键词"}'
工具名换 cloudsway/SearchPro/jdcloud_search、body 换对应入参即可。
选用范式
- 通用检索 →
tavily；要最新时效 → searchpro；要网页正文做分析 → jdcloud（或 cloudsway --enableContent true）；要限定站点 → cloudsway --sites baijiahao.baidu.com。
地图/经纬度/POI/路径 等见姊妹 skill agentrs-map；天气见 agentrs-weather。三者共用同一个 JD_AGENTRS_TOKEN。
