argo-search 1.0.1 → 2.9.7

package/engines/specs/who_don.yaml

@@ -0,0 +1,21 @@
+# WHO Disease Outbreak News — 世卫官方疫情暴发通报（免认证 OData）
+# 补 medical 域的「官方疫情暴发」维度：现有 medical 只有 clinicaltrials（试验登记）
+# 与 openfda（药品/器械），没有公共卫生事件源。ProMED 无公开 API，此为其官方替代。
+# OData 支持 $top/$orderby/$filter。
+# 验证:
+#   python3 scripts/engine_validate.py --engine who_don --stage all --admit --write-doc
+
+engine_id: who_don
+type: who_don
+enabled: true
+cost_tier: free
+timeout: 20
+canary_query: "cholera"
+desc: "WHO 疫情暴发通报（世卫官方公共卫生事件，免认证 OData）"
+coverage: [medical, health, news, official]
+recommended: false
+latency_ms: 2500
+
+quality_queries:
+  - query: "cholera"
+  - query: "influenza"

package/engines/specs/who_gho.yaml

@@ -0,0 +1,20 @@
+# WHO GHO 全球卫生指标（官方 OData，免认证）
+# 补 medical 域的「全球公共卫生统计」维度：现有 medical 只有临床登记/药品/文献，
+# 没有国别卫生统计。指标目录本地过滤（OData contains 引号转义不可靠）。
+# 验证:
+#   python3 scripts/engine_validate.py --engine who_gho --stage all --admit --write-doc
+
+engine_id: who_gho
+type: who_gho
+enabled: true
+cost_tier: free
+timeout: 15
+canary_query: "malaria"
+desc: "WHO GHO 全球卫生指标（世卫官方统计目录，免认证）"
+coverage: [medical, health, statistics, official]
+recommended: false
+latency_ms: 2500
+
+quality_queries:
+  - query: "malaria"
+  - query: "tobacco"

package/engines/specs/wikimedia_commons.yaml

@@ -0,0 +1,34 @@
+# Wikimedia Commons — 通用图库（免 key，CC 素材，字段齐全）
+#
+# 为什么收这个源：argo 的图片能力此前只有 openverse 一个通用图库，而 Openverse
+# 自身的统计显示其图库主体就来自 Wikimedia（88M 图里 Commons 占最大份额）——
+# 直连 Commons 等于绕过中间层拿上游，且字段更全（extmetadata 带许可全称、
+# 作者、描述原文，imageinfo 带原图直链与宽高）。中文查询覆盖也优于 Openverse
+# （Commons 有大量中文题注的素材）。
+#
+# 与既有图源的分工：
+#   - wikimedia_commons：通用图库，CC 授权明确，**首选素材源**
+#   - openverse：同为 CC 图库，含 Flickr 等来源，与 Commons 互补不重复
+#   - ddgs_images：全网图片（无许可标注），覆盖优先
+#   - met/artic/cleveland/nasa_images：垂直馆藏（艺术/航天）
+#
+# 解析说明：query.pages 是以 pageid 为键的字典，声明式 output_map 处理不了
+# （_extract_items 会把 dict 包成单条且字段全空），故用 builder 展开。
+# 验证:
+#   python3 scripts/engine_validate.py --engine wikimedia_commons --stage all --admit
+
+engine_id: wikimedia_commons
+type: wikimedia_commons
+enabled: true
+cost_tier: free
+label: Wikimedia图库
+desc: "Wikimedia Commons 通用图库（免 key，CC 素材，原图直链+许可+宽高）"
+coverage: [image, media, cc, reference]
+family: misc_vertical
+priority: 30
+timeout: 20
+canary_query: "snow mountain"
+quality_queries:
+  - query: "snow mountain"
+  - query: "ukiyo-e"
+  - query: "cat"

package/engines/specs/wikisource.yaml

@@ -0,0 +1,22 @@
+# 维基文库 — 古文/公版文献全文（MediaWiki API，免认证）
+# 古文引文溯源补位：中文引文核验需要原文全文（出师表/论语/史记），
+# wikipedia 词条给不了。与 zh_wikipedia 同构；标题含空格需编码后拼
+# wiki 路径，builder 内处理（声明式 url_template 不做编码）。
+# 验证:
+#   python3 scripts/engine_validate.py --engine wikisource --stage all --admit --write-doc
+
+engine_id: wikisource
+type: wikisource
+enabled: true
+cost_tier: free
+timeout: 10
+canary_query: "出师表"
+desc: "维基文库（古文/公版文献全文检索，中文引文溯源，免认证）"
+coverage: [reference, chinese, classic]
+recommended: false
+latency_ms: 800
+
+quality_queries:
+  - query: "出师表"
+  - query: "论语"
+  - query: "史记"

package/engines/specs/worms.yaml

@@ -0,0 +1,19 @@
+# WoRMS 世界海洋物种名录（分类学权威，免认证）
+# 与 OBIS 互补：OBIS 给观测记录，WoRMS 给分类学「正确学名/接受名」判定。
+# 验证:
+#   python3 scripts/engine_validate.py --engine worms --stage all --admit --write-doc
+
+engine_id: worms
+type: worms
+enabled: true
+cost_tier: free
+timeout: 15
+canary_query: "Gadus morhua"
+desc: "WoRMS 海洋物种权威命名（分类学标准，免认证）"
+coverage: [species, marine, science, reference]
+recommended: false
+latency_ms: 2000
+
+quality_queries:
+  - query: "Gadus morhua"
+  - query: "Octopus vulgaris"

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/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,74 @@
+# 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]

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.7",
+  "description": "Argo 阿尔戈 — 统一搜索与证据核验。推荐 npx -y github:taxueseek/argo 或 install.sh 安装（不依赖 npm 发版）。多语言路由、264 个源（227 个免密钥开箱可用）、影视/体育/金融等垂直源、19 个 MCP 工具（与 CLI 能力面对齐）。",
   "keywords": [
     "mcp",
     "mcp-server",
@@ -13,31 +13,70 @@
     "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/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",
+    "!data/jobs"
   ],
+  "dsh": {
+    "bundle": {
+      "patch": "cordis.patch.yml"
+    }
+  },
   "engines": {
     "node": ">=18"
   },
-  "os": [
-    "darwin",
-    "linux"
-  ],
   "dependencies": {},
   "devDependencies": {}
-}
+}