argo-search 1.0.1 → 2.9.7

package/engines/specs/realtime_index.yaml

@@ -0,0 +1,34 @@
+# 实时索引数据源（免 Key CLI 桥接）
+# 结构化 YAML 输出，结果带 published_at（发布时间）维度，支持时间窗过滤。
+# 工程侧形态与 hackernews/local_search 一致：声明式 spec + 通用 cli builder，
+# 不新增 Python 特例分支。
+#
+# 部署：将实际索引 CLI 安装/软链为 realtime-index（或把 cmd 改为其绝对路径）；
+#       cmd 不可用时引擎自动禁用（与其他 CLI 引擎同形态）。
+#
+# 验证:
+#   python3 scripts/engine_validate.py --engine realtime_index --stage all --admit
+#   python3 scripts/search.py "rust async" --engine realtime_index --since 7d --json
+
+engine_id: realtime_index
+type: cli
+enabled: true
+disabled_reason: 运行时按 realtime-index CLI 是否存在翻转（config._validate_engine_paths）；未安装 CLI 时等效停用，装好后无需改代码自动启用
+cost_tier: free
+label: 实时索引搜索
+desc: 实时索引数据源（免 Key，结构化输出，带发布时间维度与时间窗过滤）
+canary_query: "climate change"
+cmd:
+- realtime-index
+search_args:
+- search
+- '{query}'
+output_format: yaml
+filter_args:
+  since:
+  - --published-after
+  - '{since}'
+  until:
+  - --published-before
+  - '{until}'
+timeout: 15

package/engines/specs/ror.yaml

@@ -0,0 +1,20 @@
+# ROR 研究机构标识（免认证）
+# 补 org_entity 域的「学术机构」维度：现有 opencorporates/gleif 覆盖企业法人，
+# ROR 是研究机构的唯一标识（含域名映射），机构消歧刚需。
+# 验证:
+#   python3 scripts/engine_validate.py --engine ror --stage all --admit --write-doc
+
+engine_id: ror
+type: ror
+enabled: true
+cost_tier: free
+timeout: 15
+canary_query: "tsinghua"
+desc: "ROR 研究机构标识（含域名映射，免认证）"
+coverage: [org_entity, academic, reference]
+recommended: false
+latency_ms: 2000
+
+quality_queries:
+  - query: "tsinghua"
+  - query: "max planck"

package/engines/specs/satnogs.yaml

@@ -0,0 +1,20 @@
+# SatNOGS 卫星目录（免认证）
+# 补 astronomy 域的卫星目录维度（NORAD ID/发射信息），与 tle_mirror 配合
+# 组成「目录 + 轨道根数」。Celestrak 在本机不可达，SatNOGS 提供稳定替代。
+# 验证:
+#   python3 scripts/engine_validate.py --engine satnogs --stage all --admit --write-doc
+
+engine_id: satnogs
+type: satnogs
+enabled: true
+cost_tier: free
+timeout: 20
+canary_query: "ISS"
+desc: "卫星目录（SatNOGS DB，NORAD ID/发射信息，免认证）"
+coverage: [astronomy, space, satellites, open_data]
+recommended: false
+latency_ms: 2500
+
+quality_queries:
+  - query: "ISS"
+  - query: "starlink"

package/engines/specs/sec_edgar.yaml

@@ -0,0 +1,46 @@
+# SEC EDGAR 美国证监会全文检索（免 Key，官方数据）
+# 文档: https://www.sec.gov/search-filings/edgar-search-assistance
+# 注意: SEC 强制要求 User-Agent
+# q 参数只支持裸关键词搜索（如 q=apple 或 q="apple 10-K"），不支持 field:syntax。
+# 表单过滤必须走 forms= 参数（efts 的 q 参数里写 form_type:10-K 返回 0 条）。
+# 验证:
+#   python3 scripts/engine_validate.py --engine sec_edgar --stage all --admit
+#   python3 scripts/search.py "apple" --engine sec_edgar --json
+#   python3 scripts/search.py "apple" --engine sec_edgar --forms 10-K --json
+
+engine_id: sec_edgar
+type: http
+enabled: true
+cost_tier: free
+method: GET
+url: https://efts.sec.gov/LATEST/search-index
+timeout: 15
+query_param: q
+extra_params:
+  # forms 默认 10-K：年报是这一源最常被问的表单类型，不传也给出可用结果。
+  # 其余三个参数 CLI 暂无开关（ciks=公司 CIK、startdt/enddt=申报日期窗），
+  # 留空即不下发有效过滤——需要时先把开关接进 search_cli 再填占位符。
+  forms: "10-K"
+  ciks: ""
+  startdt: ""
+  enddt: ""
+canary_query: "apple"
+desc: "SEC EDGAR 美国证监会官方全文检索（公司/财报/申报，免认证）"
+coverage: [finance, us_stock, legal, company]
+# 能力族：这个源回答「某家公司的财报/申报文件是什么」，属公司财务披露。
+# 此前没声明，被静默当成 web_general——后果是它跟通用搜索引擎同族比较，
+# 在排序里被顶到后面，而且会被恢复链当成「安全族」误放行。
+family: finance_market
+recommended: false
+
+headers:
+  User-Agent: argo-search/1.0 (research contact@example.com)
+  Accept: application/json
+
+output_map:
+  items: hits.hits
+  item_title: _source.display_names.0
+  # 文档本体 URL：Archives/edgar/data/{cik}/{accession_no_dashes}/{primary_doc}
+  # 如果 efts 返回 accession 字段则拼文档本体，否则回退到 browse 页
+  url_template: https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK={_source.ciks.0}&type={forms}&dateb=&owner=include&count=40
+  item_summary: _source.file_description

package/engines/specs/skillsmp.yaml

@@ -0,0 +1,50 @@
+# SkillsMP — Agent Skills 聚合目录（skill 域跨生态技能索引，GET JSON，keyless）
+# 技能域的广覆盖目录源：独立索引 200 万+ 开源技能，支持语言/职业过滤，
+# 与 redskill（小红书生态 47650 技能本地缓存）互补不重复（不同上游、不同生态）。
+# 免费 REST API 无需密钥（bearerAuth 仅用于提额）；sortBy=stars 按仓库热度排序，
+# stars 口径是源仓库星数非安装量，与 skills.sh 安装遥测、ClawHub 下载量互不可比。
+# 可选过滤参数（按需加进 extra_params）：language（ISO 码，如 zh）、category、occupation。
+# 验证:
+#   python3 scripts/engine_validate.py --engine skillsmp --stage all --admit --write-doc
+
+engine_id: skillsmp
+type: http
+enabled: true
+cost_tier: free
+label: SkillsMP 技能目录
+family: misc_vertical
+priority: 50
+qps: 2
+period: second
+limit: null
+cost_per_call: 0.0
+cost_unit: free
+method: GET
+url: https://skillsmp.com/api/v1/skills/search
+timeout: 15
+canary_query: "git commit"
+coverage:
+- skill
+- developer
+- tech
+desc: "SkillsMP Agent 技能聚合目录（200万+ 开源技能独立索引，免费 keyless REST API，stars 排序）"
+format: json
+query_param: q
+extra_params:
+  limit: "{n}"
+  sortBy: stars
+output_map:
+  items: data.skills
+  item_title: name
+  item_url: skillUrl
+  item_summary: description
+  # 可验证出处：githubUrl 指向该技能在上游仓里的**目录**（…/tree/main/.agents/
+  # skills/xxx），是能核对、能安装的那个地址；skillUrl 只是市场页。
+  item_upstream: githubUrl
+  # updatedAt 是 epoch **秒**（ClawHub 同名字段是毫秒，差 1000 倍，由
+  # engines_base._normalize_epoch 按量级归一成日期）。
+  item_published_at: updatedAt
+quality_queries:
+  - query: "git commit"
+  - query: "code review"
+  - query: "pdf"

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: 1.0
+cost_unit: request
+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/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