argo-search 1.0.1 → 2.9.8

package/engines/specs/x_trending.yaml

@@ -0,0 +1,34 @@
+# X (Twitter) Trending 热榜（ego-browser，免 Key，独家源）
+# 定位：X 全球趋势榜是别处拿不到的独家热点源（科技/娱乐/全球趋势分类带排名）。
+# 借 ego-browser 驱动用户默认浏览器抓取 x.com/explore/tabs/trending 渲染结果，
+# 复用浏览器 profile 的 cookie 与指纹，避开匿名请求的 X 风控。
+# 与 sogou_weixin_browser 同族但**零状态文件**：不持久化 task space、不加锁，
+# 每次调用自建空间抓完即走（X 的登录态在 profile 层，冷空间实测同样可取数）。
+# 路由：explicit_only —— 本引擎会在用户浏览器开标签页，不进自动路由，
+# 只等显式调用（需要时 --engine x_trending）。
+# 验证：
+#   python3 scripts/engine_validate.py --engine x_trending --stage all --admit
+#   python3 scripts/search.py "热榜" --engine x_trending --json
+
+engine_id: x_trending
+type: cli
+enabled: true
+cost_tier: free
+explicit_only: true
+cmd:
+- python3
+- scripts/x_trending.py
+search_args:
+- '{query}'
+- --n
+- '{n}'
+output_format: yaml
+timeout: 60
+canary_query: "热榜"
+desc: "X (Twitter) Trending 全球热榜（ego-browser 浏览器通道，带分类与排名；显式调用）"
+coverage: [general, social, trending]
+recommended: false
+family: hot_trending
+# 热榜是「固定榜单」而非「与查询词面匹配的文档集」：canary 与结果无词面交集，
+# 相关性门不适用（同 weather 的数据型源口径）。
+relevance_check: false

package/engines/specs/yna.yaml

@@ -0,0 +1,43 @@
+# 韩联社 RSS — 韩国国家通讯社（연합뉴스），韩半岛一手新闻
+#
+# 补的盲区：**ko 本地一手新闻**。接入前 argo 的新闻链路只有中英源
+# （google_news/guardian_rss/dw_news/france24 都是英语视角），ko 查询
+# 拿不到本地一手报道。
+#
+# 实测（2026-09-21）：**120 条**，摘要中位 83 字、最长 93 字。
+#
+# 形态：feed_mode=hot（实时流语义，同 guardian_rss）。归 world_news 族——
+# 与 hot_trending（热榜）分族，避免同族 max_per_family=2 把本地源互相挤掉。
+# 语言由 langs 声明，路由按查询语言选源（见 route._lang_aware_combo_order）。
+#
+# 验证:
+#   python3 scripts/engine_validate.py --engine yna --stage all --admit
+#   python3 scripts/search.py "오늘 뉴스" --engine yna --json
+
+engine_id: yna
+type: rss_feed
+enabled: true
+cost_tier: free
+label: 韩联社 RSS
+family: world_news
+feed_mode: hot
+relevance_check: false
+priority: 40
+qps: 1
+period: second
+cost_per_call: 0.0
+cost_unit: free
+timeout: 12
+feed_url: https://www.yna.co.kr/rss/news.xml
+langs:
+- ko
+canary_query: "오늘 뉴스"
+coverage:
+- news
+- korea
+desc: "韩联社（韩国国家通讯社（연합뉴스），韩半岛一手新闻，免 key）"
+recommended: false
+
+quality_queries:
+  - query: "오늘 뉴스"
+  - query: "한국 정치"

package/engines/specs/ynet.yaml

@@ -0,0 +1,43 @@
+# Ynet 新闻 RSS — 以色列最大新闻站，希伯来语一手源
+#
+# 补的盲区：**he 本地一手新闻**。接入前 argo 的新闻链路只有中英源
+# （google_news/guardian_rss/dw_news/france24 都是英语视角），he 查询
+# 拿不到本地一手报道。
+#
+# 实测（2026-09-21）：**30 条**，摘要中位 267 字、最长 429 字。
+#
+# 形态：feed_mode=hot（实时流语义，同 guardian_rss）。归 world_news 族——
+# 与 hot_trending（热榜）分族，避免同族 max_per_family=2 把本地源互相挤掉。
+# 语言由 langs 声明，路由按查询语言选源（见 route._lang_aware_combo_order）。
+#
+# 验证:
+#   python3 scripts/engine_validate.py --engine ynet --stage all --admit
+#   python3 scripts/search.py "חדשות היום" --engine ynet --json
+
+engine_id: ynet
+type: rss_feed
+enabled: true
+cost_tier: free
+label: Ynet 新闻 RSS
+family: world_news
+feed_mode: hot
+relevance_check: false
+priority: 52
+qps: 1
+period: second
+cost_per_call: 0.0
+cost_unit: free
+timeout: 12
+feed_url: https://www.ynet.co.il/Integration/StoryRss2.xml
+langs:
+- he
+canary_query: "חדשות היום"
+coverage:
+- news
+- israel
+desc: "Ynet 新闻（以色列最大新闻站，希伯来语一手源，免 key）"
+recommended: false
+
+quality_queries:
+  - query: "חדשות היום"
+  - query: "פוליטיקה ישראל"

package/engines/specs/yuanbao.yaml

@@ -0,0 +1,93 @@
+# 腾讯元宝搜索（Tencent WSA SearchPro，需 key）——默认开，无 key 时路由自动跳过
+#
+# 它是什么：腾讯云「联网搜索」的元宝口径（POST api.wsa.cloud.tencent.com/SearchPro）。
+# 中文全网检索，返回**权威源占比很高**：实测「三星堆的由来」10 条里 8 条来自
+# 人民日报 / 新华网 / 国家文物局 / 住建部 / 国家民委 / 中国日报 / 中新网 /
+# 中国经济网，另 2 条为环球网与腾讯新闻。这与 bocha/byted 的「门户+自媒体」
+# 构成互补——同一个查询上，它更偏一手/官方口径。
+#
+# 返回字段（实测）：passage（摘要 ~800 字）、content（更长正文 ~2000 字）、
+# score（相关度 0.55-0.65 区间）、date（`YYYY/MM/DD HH:MM:SS`，东八区）、
+# title、url、site（站点中文名，如「人民日报」）、favicon、pics。
+# 搜索层只取 passage 当摘要，正文按需走 fetch/verify 链（与 DeepSeek 引擎同口径）。
+#
+# 为什么是独立 builder 而不是 type: http（四条声明式表达不了的事实）：
+#   1. Pages 是 **JSON 字符串数组**，要二次解析
+#   2. 错误全部走 HTTP 200 + Response.Error（鉴权/欠费/限流都是），
+#      声明式会把它当「0 结果」
+#   3. date 是斜杠格式，不是 argo 的 ISO 约定
+#   4. Cnt 只接受 10/20/30/50，传别的值回 "illegal Cnt"
+# 详见 scripts/engines_builders_batch15.py 的模块 docstring。
+#
+# 成本口径：**未知**。官方文档未公布单价，只有 ResourceUnavailable「请检查账号
+# 是否欠费」这一条侧面说明它按量计费。故 cost_per_call 记 0.0（预算层因此不会
+# 扣减），并用 explicit_only 把它挡在自动路由之外——在价格与额度未知之前，
+# 不让它进任何域 combo，避免「自动花钱却算不出花了多少」。补齐价格后再按
+# scripts/paid_policy.py 的既有做法决定是否放进白名单域的付费对冲位。
+#
+# 启用前提：
+#   1. 配置 key（两个名字都认）：
+#        ARGO_YUANBAO_API_KEY=<key>      # argo 推荐名
+#        TENCENTCLOUD_WSA_APIKEY=<key>   # 腾讯官方名（文档里的环境变量名）
+#      写进 ~/.config/argo/env 即可，只进环境不落仓库。
+#   2. 健康门：python3 scripts/engine_validate.py --engine yuanbao --stage all --admit
+#   3. 显式调用：argo search "三星堆的由来" --engine yuanbao --json --fields agent
+#
+# 实测（2026-10-21 本机）：单次 POST 0.44s，返回 10 条，响应体 ~90KB。
+engine_id: yuanbao
+type: yuanbao
+enabled: true
+# 额度是**按次**的（默认 2000/月），不是按钱的——用 limit + period 的计数档位，
+# 不用 budget.py 的金额档（金额档要单价，计数档不要；单价官方也没公布）。
+#
+# 「次数」的口径：quota.record_many 的 used 计的是**发出过的调用数（含失败）**，
+# 只有 cost_used 是成功才累加。对硬额度而言这是安全的一侧——本地宁可早停，
+# 不让远端 2000 次的硬上限被撞穿；反过来说，本地显示「已用 100 次」时上游
+# 可能只计了其中成功的那些。本轮不改这个口径（改它要动 record_many 的通用
+# 语义，影响全部引擎）。
+#
+# 额度用完即 is_hard_down（全模式排除，不是仅仅排除路由），到 30 天周期边界
+# 惰性自愈；想提前恢复用 `python3 scripts/quota.py reset yuanbao`。
+#
+# **进自动路由（无 explicit_only）**：2026-10-21 起作为 chinese_general 域的第
+# 2 位对冲位（config.yaml 该域的注释里有实测依据）。之所以敢进，是因为额度是
+# **硬上限 + 自动摘除**：耗尽后 is_hard_down 把它从 combo 里摘掉，组合回落到
+# 此前的 anysearch/zhihu_global 形态——降级是明确的一步，不是静默变窄。
+# 代价是额度按查询量线性消耗（中文通用查询每次 1 次调用），档位见下方 limit。
+cost_tier: api
+method: POST
+url: https://api.wsa.cloud.tencent.com/SearchPro
+timeout: 12
+canary_query: 三星堆的由来
+label: 腾讯元宝搜索
+family: web_general
+priority: 55
+# 上游有 RequestLimitExceeded，但公开文档未给具体 QPS；保守取 2，避免撞限流。
+# 限频与下面的 period 无关：qps 检查走硬编码 60 秒窗口（quota.py:585 的
+# `now - t < 60`），全仓没有限频器读 period。
+qps: 2
+# period 是**额度语义**，今天只影响两处 + 一处展示：
+#   1. 本地额度重置跨度：quota._period_elapsed（month → 30 天，否则 1 天）
+#   2. 远端耗尽冷却窗：quota._PERIOD_SECONDS（month → 30 天；表里查不到的值
+#      ——含 second/minute——落 86400，且「过短一律按 24h 保守处理」）
+#   3. ENGINE_CATALOG 的「频率上限」列展示
+# 本引擎限额是月度，故两处都应为 30 天 = month。
+period: month
+# 月度调用额度。默认按体验额度 2000 次/月；开通更高套餐时改本行 limit
+# （DSH 面板默认值也按 2000 显示，面板写入只覆盖当前环境，不改进本文件）。
+limit: 2000
+# 单价未知（官方未公布超额度后的计价），故不填金额，只由 limit 约束次数。
+cost_per_call: 0.0
+cost_unit: credit
+recommended: false
+
+# key 候选链：任一有值即视为就绪（解析见 engine_env.missing_env_for）
+required_env:
+  - [ARGO_YUANBAO_API_KEY, TENCENTCLOUD_WSA_APIKEY, YUANBAO_API_KEY]
+
+coverage: [web, chinese, news, official]
+
+quality_queries:
+  - query: 三星堆的由来
+  - query: 央行 降准 最新
+  - query: 国家统计局 一季度 GDP

package/engines/specs/zbmath.yaml

@@ -0,0 +1,40 @@
+# zbMATH Open — 数学文献权威索引（免 key，EMS/FIZ Karlsruhe）
+#
+# 补的盲区：**数学**。argo 的学术域覆盖 CS/生物医学/综合，但没有数学专门源——
+# arXiv 的 math.* 分类只是预印本，不含期刊评审后的索引与 MSC 分类号。
+#
+# 实测（2026-09-21）：JSON 直出，免 key；「algebra」返回结构化条目，含
+# title / contributors.authors / year / msc（数学分类）/ zbmath_url。
+#
+# 形态：检索式。summary 取 source.series.0.title（期刊/丛书名），取不到时留空
+# ——zbMATH 不提供摘要字段，宁缺勿假。
+#
+# 验证:
+#   python3 scripts/engine_validate.py --engine zbmath --stage all --admit
+
+engine_id: zbmath
+type: http
+enabled: true
+cost_tier: free
+method: GET
+url: https://api.zbmath.org/v1/document/_search
+timeout: 20
+query_param: search_string
+canary_query: "algebra"
+family: academic
+coverage: [academic, math, paper]
+desc: "zbMATH Open 数学文献索引（含 MSC 分类号，免 key）"
+recommended: false
+explicit_only: true
+extra_params:
+  results_per_page: "{n}"
+output_map:
+  items: result
+  item_title: title.title
+  item_url: zbmath_url
+  item_summary: source.series.0.title
+  item_published_at: year
+
+quality_queries:
+  - query: "algebra"
+  - query: "topology"

package/engines/specs/zdic.yaml

@@ -0,0 +1,22 @@
+# 汉典 — 中文字词典（HTML 解析，免认证）
+# dictionary_search 域的中文补位：该域此前只有英文 dictionaryapi.dev，
+# 缺字义/音韵/字源。词条页为 /hans/{词} 直达，取「详细解释」前几条释义
+# 拼摘要；查无此字返回 404 → 诚实空。
+# 验证:
+#   python3 scripts/engine_validate.py --engine zdic --stage all --admit --write-doc
+
+engine_id: zdic
+type: zdic
+enabled: true
+cost_tier: free
+timeout: 12
+canary_query: "道"
+desc: "汉典（中文字词典：字义/音韵/字源，HTML 解析，免认证）"
+coverage: [dictionary, chinese, reference]
+recommended: false
+latency_ms: 1500
+
+quality_queries:
+  - query: "道"
+  - query: "仁"
+  - query: "信"

package/engines/specs/zenodo.yaml

@@ -0,0 +1,27 @@
+# Zenodo 科研数据集搜索（免 Key）
+# 文档: https://developers.zenodo.org/
+# 验证:
+#   python3 scripts/engine_validate.py --engine zenodo --stage all --admit
+#   python3 scripts/search.py "climate" --engine zenodo --json
+
+engine_id: zenodo
+type: http
+enabled: true
+cost_tier: free
+method: GET
+url: https://zenodo.org/api/records
+timeout: 15
+query_param: q
+canary_query: "climate change"
+desc: "Zenodo 科研数据集搜索（CERN 托管，免认证，DOI 可引用）"
+coverage: [dataset, academic, opendata, paper]
+recommended: false
+
+extra_params:
+  size: "{n}"
+
+output_map:
+  items: hits.hits
+  item_title: metadata.title
+  item_url: links.self_html
+  item_summary: metadata.description

package/engines/specs/zhihu_hot_app.yaml

@@ -0,0 +1,35 @@
+# 知乎热榜匿名通道 — App 端 JSON（免密钥）
+# 与 zhihu_hot（开放平台 hot_list，100/天配额）同一热榜的免密钥通道：
+# 命中后可把开放平台配额留给 zhihu 内容搜索。非公开承诺接口，失败诚实空。
+# 查询与热榜内容无关（热榜是榜单型源，与 baidu_hot/toutiao_hot 同型）。
+# 验证:
+#   python3 scripts/engine_validate.py --engine zhihu_hot_app --stage all --admit --write-doc
+
+engine_id: zhihu_hot_app
+type: http
+enabled: true
+cost_tier: free
+method: GET
+url: https://api.zhihu.com/topstory/hot-list
+timeout: 10
+query_param: ""
+canary_query: "热榜"
+desc: "知乎热榜匿名通道（App JSON，免密钥；开放平台 hot_list 的免费替代）"
+coverage: [chinese, hot, trending, realtime]
+recommended: false
+latency_ms: 800
+
+headers:
+  User-Agent: argo-search/1.0 (+zhihu_hot_app)
+
+extra_params:
+  limit: "{n}"
+
+output_map:
+  items: data
+  item_title: target.title
+  item_summary: detail_text
+  url_template: "https://www.zhihu.com/question/{target.id}"
+
+quality_queries:
+  - query: "热榜"

package/mcp/clients.yaml

@@ -0,0 +1,106 @@
+# mcp/clients.yaml — 多客户端 MCP 注入的声明式真源（自研，零第三方依赖）
+#
+# 设计：加/改客户端只需编辑本文件（对齐 config.yaml / engines/specs/*.yaml 的
+# "配置真源"哲学），无需改代码。mcp_setup.py 读取本文件做 探测/注入/诊断/还原。
+#
+# 字段说明：
+#   id           客户端标识（CLI --client 用）
+#   name         展示名
+#   config_path  配置文件路径（相对 home；用 {home} 占位可指绝对路径）
+#   servers_key  MCP 服务器所在顶层键（mcpServers / servers / mcp_servers / mcp）
+#   format       json | toml（toml 走"行级 append section"，注释零破坏）
+#   detect       探测目录/文件（相对 home，逗号分隔；存在即"已安装"）。
+#                只写宿主自身的目录/文件——写别家客户端的配置文件路径会把
+#                别家已配置误判成本家已安装（cline 曾挂 .cursor/mcp.json）
+#
+# 注入形态：当前全部为 stdio（command=mcp_launch.sh），由 mcp_setup._mcp_command
+# 统一生成；HTTP/远程形态是未来能力，尚未实现——字段表里不设占位。
+#
+# 运行：
+#   python3 scripts/mcp_setup.py status             # 诊断各客户端
+#   python3 scripts/mcp_setup.py inject --all       # 注入所有已安装客户端
+#   python3 scripts/mcp_setup.py inject --cursor    # 注入指定客户端
+#   python3 scripts/mcp_setup.py undo --all         # 还原所有（含备份历史）
+#   python3 scripts/mcp_setup.py inject --all --dry-run
+
+clients:
+  - id: claude-code
+    name: Claude Code
+    config_path: .claude.json
+    servers_key: mcpServers
+    format: json
+    detect: [.claude]
+
+  - id: cursor
+    name: Cursor
+    config_path: .cursor/mcp.json
+    servers_key: mcpServers
+    format: json
+    detect: [.cursor/mcp.json, .cursor]
+
+  - id: windsurf
+    name: Windsurf
+    config_path: .codeium/windsurf/mcp_config.json
+    servers_key: mcpServers
+    format: json
+    detect: [.codeium]
+
+  - id: codex
+    name: Codex
+    config_path: .codex/config.toml
+    servers_key: mcp_servers
+    format: toml
+    detect: [.codex]
+
+  - id: opencode
+    name: OpenCode
+    config_path: .config/opencode/opencode.json
+    servers_key: mcp
+    format: json
+    detect: [.config/opencode]
+
+  - id: cline
+    name: Cline
+    config_path: .cline/mcp_settings.json
+    servers_key: mcpServers
+    format: json
+    detect: [.cline]
+
+  - id: workbuddy
+    name: WorkBuddy
+    config_path: .workbuddy/mcp.json
+    servers_key: mcpServers
+    format: json
+    detect: [.workbuddy]
+
+  - id: claude-desktop
+    name: Claude Desktop
+    config_path: Library/Application Support/Claude/claude_desktop_config.json
+    config_path_darwin: Library/Application Support/Claude/claude_desktop_config.json
+    config_path_win32: AppData/Roaming/Claude/claude_desktop_config.json
+    config_path_linux: .config/Claude/claude_desktop_config.json
+    servers_key: mcpServers
+    format: json
+    detect_darwin: [Library/Application Support/Claude]
+    detect_win32: [AppData/Roaming/Claude]
+    detect_linux: [.config/Claude]
+
+  - id: zed
+    name: Zed
+    config_path: .config/zed/settings.json
+    servers_key: context_servers
+    format: json
+    detect: [.config/zed]
+
+  - id: roo-code
+    name: Roo Code
+    config_path: Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
+    config_path_darwin: Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
+    config_path_win32: AppData/Roaming/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
+    config_path_linux: .config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
+    servers_key: mcpServers
+    format: json
+    detect_darwin: [Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline]
+    detect_win32: [AppData/Roaming/Code/User/globalStorage/rooveterinaryinc.roo-cline]
+    detect_linux: [.config/Code/User/globalStorage/rooveterinaryinc.roo-cline]
+

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "argo-search",
-  "version": "1.0.1",
-  "description": "Argo — 47-engine unified search MCP server with TF-IDF routing, RRF fusion, and Bocha reranker. 6 tools: search, research, evidence, clarify, crawl, extract.",
+  "version": "2.9.8",
+  "description": "Argo 阿尔戈 — 统一搜索与证据核验。推荐 npx -y github:taxueseek/argo 或 install.sh 安装（不依赖 npm 发版）。多语言路由、272 个源（235 个免密钥开箱可用）、影视/体育/金融等垂直源、19 个 MCP 工具（与 CLI 能力面对齐）。",
   "keywords": [
     "mcp",
     "mcp-server",
@@ -13,31 +13,74 @@
     "grok",
     "kimi",
     "codex",
-    "argo"
+    "argo",
+    "npx"
   ],
-  "license": "MIT",
+  "license": "Apache-2.0",
   "author": "Argo Search",
   "repository": {
     "type": "git",
-    "url": "https://github.com/taxueseek/argo"
+    "url": "git+https://github.com/taxueseek/argo.git"
   },
   "bin": {
-    "argo-search": "./bin/argo.js"
+    "argo-search": "bin/argo.js"
   },
   "files": [
     "bin/",
     "scripts/",
     "config.yaml",
+    "engines/",
     "backends/",
-    "sub-skills/"
+    "data/",
+    "sub-skills/",
+    "assets/",
+    "docs/ADDING_NEW_ENGINE.md",
+    "docs/ARGO_INTRO.md",
+    "docs/DATA_SOURCE_GAPS.md",
+    "docs/DESIGN_LOCAL_DATA_FUSION.md",
+    "docs/ENGINE_CATALOG.md",
+    "docs/MCP_SETUP.md",
+    "docs/PLATFORM_PATHS.md",
+    "docs/SEARCH_ARCHIVE.md",
+    "docs/为什么选择argo.md",
+    "docs/RELEASE_NOTES_v2.8.0.md",
+    "docs/RELEASE_NOTES_v2.8.2.md",
+    "docs/RELEASE_NOTES_v2.8.3.md",
+    "docs/RELEASE_NOTES_v2.8.4.md",
+    "docs/RELEASE_NOTES_v2.8.5.md",
+    "docs/RELEASE_NOTES_v2.8.6.md",
+    "docs/RELEASE_NOTES_v2.8.7.md",
+    "docs/RELEASE_NOTES_v2.8.8.md",
+    "docs/RELEASE_NOTES_v2.8.9.md",
+    "docs/RELEASE_NOTES_v2.9.0.md",
+    "docs/RELEASE_NOTES_v2.9.8.md",
+    "docs/assets/",
+    "docs/engines/",
+    "cordis.patch.yml",
+    "mcp/clients.yaml",
+    "packages/dsh-plugin/",
+    "README.md",
+    "SKILL.md",
+    "references/query-templates.yaml",
+    "references/query-templates.md",
+    "LICENSE",
+    "!**/__pycache__/**",
+    "!**/*.pyc",
+    "!sub-skills/**/__pycache__/**",
+    "!sub-skills/**/*.pyc",
+    "!sub-skills/**/tests/**",
+    "!sub-skills/**/references/**",
+    "!assets/readme/*.webp",
+    "!data/jobs"
   ],
+  "dsh": {
+    "bundle": {
+      "patch": "cordis.patch.yml"
+    }
+  },
   "engines": {
     "node": ">=18"
   },
-  "os": [
-    "darwin",
-    "linux"
-  ],
   "dependencies": {},
   "devDependencies": {}
-}
+}