argo-search 1.0.1 → 2.9.8

package/engines/specs/sogou_weixin_browser.yaml

@@ -0,0 +1,30 @@
+# 搜狗微信搜索·浏览器兜底通道（ego-browser）
+# 定位：HTTP 快车道 wechat_sogou（spec 在 config.yaml wechat_search 路由）被
+# 搜狗反爬墙拦截（302 antispiderwall）时的域内兜底——借 ego-browser 驱动用户
+# 默认浏览器的真实会话拉取同源结果页，指纹与 cookie 连续，2026-09-30 实测
+# 连查无风控（对比：raw curl 第 2 次查询即被墙）。只挂在 wechat_search 路由
+# 的 engines_combo 里（primary 之后、anysearch 之前），不进任何通用池。
+# 实现：scripts/sogou_weixin_browser.py（纯标准库；空间复用+文件锁+最小间隔；
+# 中间链在浏览器会话内解析为 mp.weixin.qq.com 真实链接，语义与 HTTP 车道对齐）
+# 验证：
+#   python3 scripts/engine_validate.py --engine sogou_weixin_browser --stage all --admit
+#   python3 scripts/search.py "公众号 石墨化" --engine sogou_weixin_browser --json
+
+engine_id: sogou_weixin_browser
+type: cli
+enabled: true
+cost_tier: free
+cmd:
+- python3
+- scripts/sogou_weixin_browser.py
+search_args:
+- '{query}'
+- --n
+- '{n}'
+output_format: yaml
+timeout: 75
+canary_query: "人工智能"
+desc: "搜狗微信搜索·浏览器兜底通道（ego-browser 真实会话，HTTP 车道被反爬时保底；中间链会话内解析为微信真实链接）"
+coverage: [chinese, wechat, article]
+recommended: false
+family: web_general

package/engines/specs/soilgrids.yaml

@@ -0,0 +1,25 @@
+# ISRIC SoilGrids 全球土壤属性（逐点栅格，免认证）——【暂不启用】
+# 2026-09-13 实测：端点可达、schema 正确，但**所有 property × 所有深度的 values 全为 null**
+# （clay/sand/silt/soc/nitrogen/phh2o/bdod × 0-5cm… 全空，多坐标复核一致），
+# 属服务端降级（此前 also 出现过 503）。builder 逻辑已验证正确，待上游恢复后
+# 把 enabled 改回 true 即可启用，无需改代码。
+# 补 earth_science 域的「土壤」维度：usgs（地震/水文）、nasa_cmr（地球观测）、
+# 现在加上土壤属性。查地名 → 地理编码 → 取该点土壤理化属性。
+# 验证:
+#   python3 scripts/engine_validate.py --engine soilgrids --stage all --admit --write-doc
+
+engine_id: soilgrids
+type: soilgrids
+enabled: false
+disabled_reason: 72fd95a 源治理轮批量停用，未单独评估；土壤数据查询占比低，重开前需实测对比
+cost_tier: free
+timeout: 25
+canary_query: "amsterdam"
+desc: "全球土壤属性（ISRIC SoilGrids，逐点栅格，免认证）"
+coverage: [earth_science, agriculture, environment]
+recommended: false
+latency_ms: 4000
+
+quality_queries:
+  - query: "amsterdam"
+  - query: "nairobi"

package/engines/specs/sspai.yaml

@@ -0,0 +1,36 @@
+# 少数派搜索 — 中文效率/数码/软件内容（JSON API，免认证）
+# 补 cn_tech_community 域的效率工具/数码生活维度：juejin/v2ex 偏开发向。
+# v3 路径已 404，用 v1；版本漂移风险自担，失败诚实空。
+# 验证:
+#   python3 scripts/engine_validate.py --engine sspai --stage all --admit --write-doc
+
+engine_id: sspai
+type: http
+enabled: true
+cost_tier: free
+method: GET
+url: https://sspai.com/api/v1/search/article/page/get
+timeout: 10
+query_param: title
+canary_query: "notion"
+desc: "少数派搜索（中文效率/数码/软件文章，免认证）"
+coverage: [chinese, tech, article]
+recommended: false
+latency_ms: 1000
+
+headers:
+  User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36
+
+extra_params:
+  offset: "0"
+  limit: "{n}"
+
+output_map:
+  items: data
+  item_title: title
+  item_summary: summary
+  url_template: "https://sspai.com/post/{id}"
+
+quality_queries:
+  - query: "notion"
+  - query: "iphone"

package/engines/specs/stackexchange.yaml

@@ -0,0 +1,46 @@
+# StackExchange API 族引擎（180+ 问答站官方 API，keyless 匿名直连）
+# 文档: https://api.stackexchange.com/docs/search
+# 额度: 匿名 300/天/IP（全站共享配额，实测 quota_remaining 299/300）；
+#       免费注册 key 后 10,000/天——需要提额时在 extra_params 加
+#       key: "{ARGO_STACKEXCHANGE_API_KEY}" 并配置该环境变量
+# 特点: search/advanced 端点 q 自由文本检索，items 自带 link（无需拼 URL）、
+#       score/IsAnswered 质量信号；--compressed（gzip）由 http_client 统一解压
+# 定位: T2 补充引擎 —— 免费池可路由（daily_support），匿名额度小，
+#       日常 combo 排后排保配额（engine_policy.get_engine_tier 读 spec.tier）
+# 验证:
+#   python3 scripts/engine_validate.py --engine stackexchange --stage all --admit
+#   python3 scripts/search.py "python asyncio" --engine stackexchange --json
+
+engine_id: stackexchange
+type: http
+enabled: true
+cost_tier: free
+# 匿名额度小（300/天/IP 与全站共享），日常只当补位，budget 截断优先命中
+tier: daily_support
+label: StackExchange 问答族
+family: knowledge
+priority: 45
+qps: 1
+period: day
+limit: 300
+cost_per_call: 0.0
+cost_unit: usd
+method: GET
+url: https://api.stackexchange.com/2.3/search/advanced
+timeout: 12
+canary_query: "python asyncio"
+coverage:
+- english
+- tech
+desc: "StackExchange API 族（StackOverflow 等 180+ 问答站结构化检索，匿名 300/天/IP，免费 key 可提额 10000/天）"
+format: json
+query_param: q
+extra_params:
+  site: stackoverflow
+  order: desc
+  sort: relevance
+  pagesize: "{n}"
+output_map:
+  items: items
+  item_title: title
+  item_url: link

package/engines/specs/std_samr.yaml

@@ -0,0 +1,21 @@
+# 全国标准信息公共服务平台 — 国标/行标检索（JSON API，免认证）
+# 标准文档域补位：RFC 有、国标无。C_C_NAME 带 <sacinfo> 高亮标签需剥离，
+# 标题由「标准号 + 名称」拼装。id 字段即 openstd hcno，直通全文页。
+# 验证:
+#   python3 scripts/engine_validate.py --engine std_samr --stage all --admit --write-doc
+
+engine_id: std_samr
+type: std_samr
+enabled: true
+cost_tier: free
+timeout: 12
+canary_query: "数据安全"
+desc: "全国标准信息公共服务平台（国标检索，标准号/状态/日期，免认证）"
+coverage: [standards, tech, chinese]
+recommended: false
+latency_ms: 1500
+
+quality_queries:
+  - query: "数据安全"
+  - query: "个人信息保护"
+  - query: "网络安全"

package/engines/specs/tass.yaml

@@ -0,0 +1,43 @@
+# 塔斯社 RSS — 俄罗斯国家通讯社（ТАСС），俄语一手新闻
+#
+# 补的盲区：**ru 本地一手新闻**。接入前 argo 的新闻链路只有中英源
+# （google_news/guardian_rss/dw_news/france24 都是英语视角），ru 查询
+# 拿不到本地一手报道。
+#
+# 实测（2026-09-21）：**100 条**，摘要中位 64 字、最长 304 字。
+#
+# 形态：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 tass --stage all --admit
+#   python3 scripts/search.py "новости сегодня" --engine tass --json
+
+engine_id: tass
+type: rss_feed
+enabled: true
+cost_tier: free
+label: 塔斯社 RSS
+family: world_news
+feed_mode: hot
+relevance_check: false
+priority: 41
+qps: 1
+period: second
+cost_per_call: 0.0
+cost_unit: free
+timeout: 12
+feed_url: https://tass.ru/rss/v2.xml
+langs:
+- ru
+canary_query: "новости сегодня"
+coverage:
+- news
+- russia
+desc: "塔斯社（俄罗斯国家通讯社（ТАСС），俄语一手新闻，免 key）"
+recommended: false
+
+quality_queries:
+  - query: "новости сегодня"
+  - query: "Россия экономика"

package/engines/specs/tavily_free.yaml

@@ -0,0 +1,56 @@
+# Tavily 免 key 通道（官方 keyless 匿名额度）
+#
+# 为什么与 tavily 并列而不是合并：两者同上游、不同经济模型——tavily 用
+# ARGO_TAVILY_API_KEY 走账号档（额度高、结果稳），本引擎走官方 keyless
+# 头（x-tavily-access-mode），不读任何 key。计费语义不同，合并会让
+# 「免费源不当计费源」的检查失真（与 parallel / parallel_free 同一处理）。
+#
+# 端点语义（2026-10-21 实测）：POST /search，带 `x-tavily-access-mode: keyless`
+# 且不带 Authorization，返回与账号档同构的 {results:[{title,url,content,score}]}。
+# 匿名额度有 IP 级限流；失效时返回 4xx，由调度层换源，不静默伪装成空结果。
+#
+# 验证:
+#   python3 scripts/engine_validate.py --engine tavily_free --stage health --admit
+#   argo search "OpenAI" --engine tavily_free --json
+
+engine_id: tavily_free
+type: http
+enabled: true
+cost_tier: free
+label: Tavily (keyless)
+family: web_general
+priority: 56
+qps: 1
+period: second
+cost_per_call: 0.0
+cost_unit: free
+recommended: false
+
+method: POST
+url: https://api.tavily.com/search
+timeout: 15
+
+headers:
+  Content-Type: application/json
+  x-tavily-access-mode: keyless
+
+body:
+  query: "{query}"
+  max_results: "{n}"
+  search_depth: basic
+  include_answer: false
+
+output_map:
+  items: results
+  item_title: title
+  item_url: url
+  item_summary: content
+  item_published_at: published_date
+
+canary_query: OpenAI
+desc: "Tavily 官方免 key 匿名通道（通用网页搜索，无需注册）"
+coverage: [general, english, chinese]
+
+quality_queries:
+  - query: OpenAI
+  - query: 人工智能 应用

package/engines/specs/tle_mirror.yaml

@@ -0,0 +1,21 @@
+# TLE 两行根数镜像（第三方，免认证）
+# 补 astronomy 域的轨道根数：官方 Celestrak 在本机网络不可达（TLS 握手失败），
+# 此镜像提供同构数据。**第三方非官方 SLA**，接入时应配 fallback 链
+# （Celestrak 官方 → 本镜像），失败诚实空。
+# 验证:
+#   python3 scripts/engine_validate.py --engine tle_mirror --stage all --admit --write-doc
+
+engine_id: tle_mirror
+type: tle_mirror
+enabled: true
+cost_tier: free
+timeout: 15
+canary_query: "ISS"
+desc: "TLE 轨道根数镜像（第三方，Celestrak 不可达时替代，免认证）"
+coverage: [astronomy, space, satellites]
+recommended: false
+latency_ms: 2000
+
+quality_queries:
+  - query: "ISS"
+  - query: "NOAA"

package/engines/specs/train.yaml

@@ -0,0 +1,37 @@
+# 火车余票/中转/经停查询（免 Key）
+# 数据源: 12306 官方接口（init 取会话 Cookie → queryG 查余票 / lcquery 查中转 /
+#         queryTrainInfo 查经停），免 Key，查询路径运行时解析跟随官方改版
+# 能力: 自然语言查询车次时刻与余票（"上海到北京 后天 G"）、中转换乘方案
+#         （"北京到拉萨 中转"，可「经西宁」指定换乘站）、全程经停（"G2 经停"）
+# 输出: 行 URL 带查询身份参数（train_code/first_train_no 等）——表格行不共享
+#         裸 URL，避免被 URL 去重折叠成一条（fred/worldbank 时序引擎同款约定）
+# 实现: scripts/train.py（纯标准库，站点表 station_name.js 解析 + 7 天缓存，输出结构化 YAML）
+# 验证:
+#   python3 scripts/engine_validate.py --engine train --stage all --admit
+#   python3 scripts/search.py "上海到北京高铁" --engine train --json
+#   python3 scripts/search.py "北京到拉萨 中转" --engine train --json
+#   python3 scripts/search.py "G2 经停" --engine train --json
+
+engine_id: train
+type: cli
+enabled: true
+cost_tier: free
+label: 火车余票
+desc: 火车余票/中转/经停查询（免 Key：12306 官方接口）
+canary_query: "北京到上海"
+cmd:
+- python3
+- scripts/train.py
+search_args:
+- '{query}'
+- --n
+- '{n}'
+output_format: yaml
+timeout: 20
+family: misc_vertical
+# 质量门禁自述查询集：通用英文探针（Python asyncio 等）会被当站名解析，
+# 必然 rc=2——垂直引擎按 engine_validate 的设计自述适用集，标准不降
+quality_queries:
+- {id: tickets_zh, query: "上海到北京 高铁", category: travel}
+- {id: transfer_zh, query: "北京到上海 中转", category: travel}
+- {id: route_zh, query: "G2 经停", category: travel}

package/engines/specs/tvmaze.yaml

@@ -0,0 +1,20 @@
+# TVMaze 电视剧元数据（免认证）
+# 补 film_search 域的「剧集/电视」维度：现有 imdb/douban_movie 偏电影，
+# TVMaze 按剧集组织且含播出日期与语言，适合「某剧哪年首播」类查询。
+# 验证:
+#   python3 scripts/engine_validate.py --engine tvmaze --stage all --admit --write-doc
+
+engine_id: tvmaze
+type: tvmaze
+enabled: true
+cost_tier: free
+timeout: 15
+canary_query: "dark"
+desc: "电视剧元数据（TVMaze，免认证，含首播/语言/评分）"
+coverage: [film, tv, media, entertainment]
+recommended: false
+latency_ms: 2000
+
+quality_queries:
+  - query: "dark"
+  - query: "breaking bad"

package/engines/specs/twitter_syndication.yaml

@@ -0,0 +1,31 @@
+# X/Twitter 单条推文（syndication 免登录通道）
+#
+# 定位：按推文取单条的抽取型引擎，与 twitter（搜索型）互为补充。
+# 通道原理：面向第三方网页嵌入的公开接口，访问凭证由推文 ID 本地推导
+#（见 engines_builders_intl.syndication_token），无需任何账号或密钥——
+# X 网页与官方 API 对未登录请求一律拒绝，这是常年可用的第二条通道。
+#
+# 查询词形态：推文 URL（x.com / twitter.com / 分享链接带 tweet_id 参数）或裸 ID。
+# 示例：
+#   python3 scripts/search.py "https://x.com/elonmusk/status/1585841080431321088" --engine twitter_syndication --json
+
+engine_id: twitter_syndication
+type: twitter_syndication
+enabled: true
+cost_tier: free
+timeout: 8
+canary_query: "https://x.com/elonmusk/status/1585841080431321088"
+desc: "X/Twitter 单条推文（syndication 通道，免登录零 key，含正文/作者/时间/媒体计数）"
+coverage: [social]
+recommended: false
+# explicit_only：关键词查询永不触发（无搜索端点），只能按 URL/ID 显式调用；
+# known-url 交接会提示该通道。声明在此，不计入死源。
+explicit_only: true
+latency_ms: 2000
+
+# 抽取型引擎：查询词是推文 URL 而非关键词。质量自述集用真实推文 URL，
+# 避免默认关键词探针对单条抽取引擎误判「零结果」
+quality_queries:
+  - query: "https://x.com/elonmusk/status/1585841080431321088"
+  - query: "https://twitter.com/elonmusk/status/1585841080431321088"
+  - query: "1585841080431321088"

package/engines/specs/un_comtrade.yaml

@@ -0,0 +1,23 @@
+# UN Comtrade — 双边商品贸易（preview 端点免 key；正式端点免费注册提额）
+# 查询形态：「<国家> <HS 码> [年份] [出口]」，如「中国 8541」「美国 8542 2024 出口」。
+# 国家词表 35 个主要经济体；未提供国家或 HS 码诚实返回空（参数解析不做猜测）。
+# preview 返回代码与数值（Desc 字段为 null），标题用查询词回显、每条附
+# comtradeplus 网页链接可核验。
+# 验证:
+#   python3 scripts/engine_validate.py --engine un_comtrade --stage all --admit --write-doc
+
+engine_id: un_comtrade
+type: un_comtrade
+enabled: true
+cost_tier: free
+timeout: 15
+canary_query: "中国 8541 2023"
+desc: "UN Comtrade 双边贸易（国家+HS 码+年份+流向；preview 免 key）"
+coverage: [macro, finance]
+recommended: false
+latency_ms: 4000
+
+quality_queries:
+  - query: "中国 8541 2023"
+  - query: "美国 8703 2023 出口"
+  - query: "日本 8542 2023"

package/engines/specs/unpaywall.yaml

@@ -0,0 +1,54 @@
+# Unpaywall — 开放获取全文定位（免 key，但**必须带真实邮箱**）
+#
+# 补的盲区：这不是搜索源，而是「论文 → 合法免费全文」的**后置解析器**。
+# 用户搜到一篇论文后，真正的问题常是「有没有免费合法全文」。Unpaywall 专门
+# 解决这件事，是 argo 学术链路从「找到论文」升级到「找到合法全文」的关键一环：
+#     paper_found → DOI → Unpaywall → 合法 OA 全文 → fetch
+#
+# 端点语义（实测 2026-09-16）：
+#   /v2/{doi}?email=<邮箱>  → 单对象：is_oa / best_oa_location.url / title ...
+#   邮箱是**硬要求**：上游校验邮箱真实性，测试域名会被 422 拒（实测
+#   "Please use your own email address"）。故走环境变量注入，不写死在仓里。
+#
+# 用法：显式专用（explicit_only）——查询词传裸 DOI，不参与自动路由。
+#
+# 验证（需先设 ARGO_UNPAYWALL_EMAIL）:
+#   ARGO_UNPAYWALL_EMAIL=you@example.org python3 scripts/search.py \
+#     "10.1038/nature12373" --engine unpaywall --json
+
+engine_id: unpaywall
+type: http
+enabled: true
+# 按 DOI 精查，不参与关键词路由
+explicit_only: true
+cost_tier: free
+label: Unpaywall 开放获取定位
+family: academic
+priority: 53
+qps: 2
+period: second
+cost_per_call: 0.0
+cost_unit: free
+method: GET
+# 邮箱从环境变量注入。占位符写**裸名** UNPAYWALL_EMAIL：engine_env 的
+# PLACEHOLDER_ALIASES 会按 [ARGO_UNPAYWALL_EMAIL, UNPAYWALL_EMAIL] 顺序解析；
+# 若这里直接写 ARGO_UNPAYWALL_EMAIL，别名表未命中时会再补一次 ARGO_ 前缀，
+# 报错信息会变成难懂的 ARGO_ARGO_UNPAYWALL_EMAIL（已实测）。
+# 未设置时引擎报 skipped-missing-env（如实提示），而非静默空结果。
+url: https://api.unpaywall.org/v2/{query}?email={UNPAYWALL_EMAIL}
+query_param: ""
+timeout: 12
+format: json
+canary_query: "10.1038/nature12373"
+coverage:
+- academic
+- open_access
+desc: "Unpaywall 开放获取定位（DOI → 是否有合法免费全文及链接；需 ARGO_UNPAYWALL_EMAIL）"
+# 不写 output_map：响应是单对象根、且答案在嵌套字段里，声明式 output_map 只
+# 支持数组根。由 scripts/engines_base.py 的 _CUSTOM_JSON_PARSERS["unpaywall"]
+# 专用解析（与 doi 同一机制）。
+recommended: false
+latency_ms: 900
+
+quality_queries:
+  - query: "10.1038/nature12373"

package/engines/specs/vnpress.yaml

@@ -0,0 +1,43 @@
+# VnExpress RSS — 越南最大网络新闻
+#
+# 补的盲区：**vi 本地一手新闻**。接入前 argo 的新闻链路只有中英源
+# （google_news/guardian_rss/dw_news/france24 都是英语视角），vi 查询
+# 拿不到本地一手报道。
+#
+# 实测（2026-09-21）：**49 条**，摘要中位 140 字、最长 202 字。
+#
+# 形态：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 vnpress --stage all --admit
+#   python3 scripts/search.py "tin tức hôm nay" --engine vnpress --json
+
+engine_id: vnpress
+type: rss_feed
+enabled: true
+cost_tier: free
+label: VnExpress RSS
+family: world_news
+feed_mode: hot
+relevance_check: false
+priority: 49
+qps: 1
+period: second
+cost_per_call: 0.0
+cost_unit: free
+timeout: 12
+feed_url: https://vnexpress.net/rss/tin-moi-nhat.rss
+langs:
+- vi
+canary_query: "tin tức hôm nay"
+coverage:
+- news
+- vietnam
+desc: "VnExpress（越南最大网络新闻，免 key）"
+recommended: false
+
+quality_queries:
+  - query: "tin tức hôm nay"
+  - query: "kinh tế Việt Nam"

package/engines/specs/weather.yaml

@@ -0,0 +1,32 @@
+# 天气查询（免 Key）
+# 数据源: wttr.in（主用，免费公开）+ Open-Meteo（兜底，需要坐标）
+# 能力: 按地点名（城市/机场码/邮编）或坐标查询当前天气与未来预报
+# 实现: scripts/wx.py（纯标准库，输出结构化 YAML 结果列表）
+# 验证:
+#   python3 scripts/engine_validate.py --engine weather --stage all --admit
+#   python3 scripts/search.py "上海天气" --engine weather --json
+
+engine_id: weather
+type: cli
+enabled: true
+cost_tier: free
+cmd:
+- python3
+- scripts/wx.py
+search_args:
+- '{query}'
+- --n
+- '{n}'
+output_format: yaml
+timeout: 15
+canary_query: "Shanghai"
+desc: "天气查询（免 Key：wttr.in 主用 + Open-Meteo 兜底，当前+未来预报）"
+coverage: [weather, forecast, geo]
+recommended: false
+# 数据型源：回答的是天气数据而非与查询词面匹配的文档，相关性判据不适用。
+# 实证：canary "Shanghai" 返回 wttr.in 的中文本地化结果（「上海…」），拉丁
+# 查询配 CJK 输出零词面交集，2026-09-16 实测被相关性门判负——同热榜类，
+# 标准不降，只是问错了问题。
+relevance_check: false
+
+family: misc_vertical

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"