argo-search 1.0.1 → 2.9.8

package/engines/specs/gdacs.yaml

@@ -0,0 +1,21 @@
+# GDACS — 全球灾害预警协调系统（EU/JRC 官方，免认证 GeoJSON）
+# 补 earth_science 域「多灾种」维度：现有 usgs 只覆盖地震，
+# GDACS 覆盖洪水/台风/野火/干旱/火山，且带 GLIDE 编号与预警等级。
+# 查询为榜单型（按时间窗列事件），与查询词弱相关——判定为事件列表源。
+# 验证:
+#   python3 scripts/engine_validate.py --engine gdacs --stage all --admit --write-doc
+
+engine_id: gdacs
+type: gdacs
+enabled: true
+cost_tier: free
+timeout: 20
+canary_query: "flood"
+desc: "GDACS 全球多灾种预警（洪水/台风/野火/地震，EU JRC 官方，免认证）"
+coverage: [earth_science, disaster, environment, official]
+recommended: false
+latency_ms: 3000
+
+quality_queries:
+  - query: "earthquake"
+  - query: "flood"

package/engines/specs/gdelt.yaml

@@ -0,0 +1,64 @@
+# GDELT 全球新闻事件流（免 Key）
+# 数据源: https://api.gdeltproject.org/api/v2/doc/doc  DOC 2.0 API
+# 能力: 全球媒体文章流——75+ 种语言（GDELT 机器翻译索引），一条查询横扫
+#       英/中/俄/土/阿尔巴尼亚等各国媒体，带 domain/language/sourcecountry
+#       与抓取时间。argo 原有新闻源是「单国单语」（google_news/dw_news/
+#       france24/人民日报），「同一事件看全球媒体怎么报」这个面是盲的。
+# 形态: type=http GET + ArtList 模式，query 驱动（非热榜），归 news_flash 族。
+# 坑: ①查询词太短报 "The specified phrase is too short"（纯文本非 JSON，
+#     走引擎失败路径返回空）——canary/质量查询必须用 ≥4 字符的真实词组。
+#     ②官方限流 1 调用/5 秒，超了 429 且冷却以分钟计（出口 IP 生效）——
+#     qps 压到 0.2，且 429 响应体来得慢（实测 14s），timeout 放宽到 25s
+#     才能读到响应体、正确归因而不是被记成 connection-failed。
+#     ③无摘要字段，snippet 留空；published_at 用 seendate
+#     （YYYYMMDDTHHMMSSZ 原样透传，与其他非 epoch 源一致）。
+# 历史: v2.8.9 曾以下线（当时判定「死源」）。根因是 qps:2 的重试节奏撞进
+#     429 冷却窗（越重试越 429）+ 共享代理出口常年半冷却；2026-09-19 实测
+#     上游活着（200 返回完整 JSON），改 qps 0.2 + direct 出口复活。
+# 验证:
+#   python3 scripts/engine_validate.py --engine gdelt --stage all --admit
+#   python3 scripts/search.py "artificial intelligence" --engine gdelt --json
+
+engine_id: gdelt
+type: http
+enabled: true
+cost_tier: free
+method: GET
+url: https://api.gdeltproject.org/api/v2/doc/doc
+timeout: 25
+query_param: query
+canary_query: "artificial intelligence"
+desc: "GDELT 全球新闻事件流（75+ 语言跨国媒体扫描，带域名/语言/国家标注）"
+coverage: [news, world, multilingual]
+recommended: false
+
+family: news_flash
+# min_interval_ms=5000：官方纪律是 1 调用/5 秒。qps 字段落地为滚动 60s 窗口
+# 的 rpm 上限，12 连发照样 3 秒内全打出去，兜不住 GDELT 的突发冷却——
+# 硬节流靠 min_interval_ms；qps: 1 显式声明配额闸，避免落回域族默认(qps=2)
+qps: 1
+min_interval_ms: 5000
+# explicit_only：限流严格、触发后冷却以分钟计——不能进默认 combo 打流量
+# （不达源门禁会拦），只在显式 --engine gdelt 时出
+explicit_only: true
+
+extra_params:
+  mode: ArtList
+  format: json
+  maxrecords: "{n}"
+  sort: DateDesc
+
+# domain 是真实发布方（土耳其 milliyet.com.tr / 美国 stardem.com...），
+# 保留而非改写为引擎名
+preserve_source: true
+
+output_map:
+  items: articles
+  item_title: title
+  item_url: url
+  item_source: domain
+  item_published_at: seendate
+
+quality_queries:
+  - query: "artificial intelligence"
+  - query: "climate change policy"

package/engines/specs/gleif.yaml

@@ -0,0 +1,55 @@
+# GLEIF — 全球法人识别编码（LEI）注册库（免 key）
+#
+# 补的盲区：**「这家公司到底是谁」的跨境法人底稿**。现有 company 源里
+# opencorporates 需要 token（本机实测 401）、SEC EDGAR 只覆盖美国上市公司，
+# GLEIF 是唯一全球口径、免认证的法人主数据：LEI、法定名称、注册地、
+# 总部地址、注册状态、母公司关系（直接/最终母公司）。
+#
+# 端点语义（2026-10-21 实测）：fulltext 全文过滤（legalName 过滤器是精确匹配，
+# 「Tencent Holdings」会 0 条；fulltext 能命中「騰訊控股有限公司」），支持中英文原文。
+#   GET /api/v1/lei-records?filter[fulltext]=Tencent&page[size]=5
+#   → data[].attributes.entity.legalName.name / legalAddress / registration.status
+# 人名/品牌名可能召回近似主体，是「按名检索」的固有限制，不是脏数据。
+#
+# 验证:
+#   python3 scripts/engine_validate.py --engine gleif --stage health --admit
+#   argo search "Tencent" --engine gleif --json
+
+engine_id: gleif
+type: http
+enabled: true
+cost_tier: free
+label: GLEIF 法人标识
+family: knowledge
+priority: 55
+qps: 2
+period: second
+cost_per_call: 0.0
+cost_unit: free
+recommended: false
+
+method: GET
+url: https://api.gleif.org/api/v1/lei-records
+query_param: "filter[fulltext]"
+extra_params:
+  "page[size]": "{n}"
+timeout: 15
+
+canary_query: Tencent
+desc: "GLEIF 全球法人 LEI 注册库（法定名称/注册地/状态/母公司，免 key）"
+coverage: [company, business, legal, org_entity]
+
+headers:
+  User-Agent: argo-search/2.9 (+gleif)
+  Accept: application/json
+
+output_map:
+  items: data
+  item_title: attributes.entity.legalName.name
+  item_summary: attributes.entity.legalAddress.addressLines.0
+  url_template: https://api.gleif.org/api/v1/lei-records/{id}
+
+quality_queries:
+  - query: Tencent
+  - query: Siemens
+  - query: 阿里巴巴

package/engines/specs/google_news.yaml

@@ -0,0 +1,22 @@
+# Google News RSS — 英文/多语言新闻（免认证，结构化 RSS）
+# 对 local_google_news（HTML）的结构化升级：时间窗（when:1d/1h）、site: 限定、
+# hl/gl/ceid 语言地区参数化。ToS 仅供个人 feed 展示，无配额契约——qps 从紧。
+# 语言映射在 builder 内按查询主语言选择 hl/gl/ceid 组合。
+# 验证:
+#   python3 scripts/engine_validate.py --engine google_news --stage all --admit --write-doc
+
+engine_id: google_news
+type: google_news
+enabled: true
+cost_tier: free
+timeout: 12
+canary_query: "artificial intelligence"
+desc: "Google News RSS（多语言新闻，免认证，支持时间窗与 site: 限定）"
+coverage: [news, realtime, english, international]
+recommended: false
+latency_ms: 1500
+
+quality_queries:
+  - query: "artificial intelligence"
+  - query: "climate change"
+  - query: "quantum computing"

package/engines/specs/gov_regulations.yaml

@@ -0,0 +1,38 @@
+# 中国政府网·规章库 — 部门规章/地方政府规章（与 gov_policy 同一接口族）
+# t=zhengcelibrary_bm 取规章层，与 gov_policy（t=zhengcelibrary_gw，国务院文件）
+# 互补：法规金字塔的中段。响应封套与字段同构，声明直接克隆。
+# 验证:
+#   python3 scripts/engine_validate.py --engine gov_regulations --stage all --admit --write-doc
+
+engine_id: gov_regulations
+type: http
+enabled: true
+cost_tier: free
+method: GET
+url: https://sousuo.www.gov.cn/search-gov/data
+timeout: 10
+query_param: q
+canary_query: "行政处罚"
+desc: "中国政府网规章库（部门规章/地方政府规章，免认证）"
+coverage: [legal, policy, gov, chinese]
+recommended: false
+latency_ms: 1500
+
+headers:
+  User-Agent: argo-search/1.0 (+gov_regulations)
+
+extra_params:
+  t: zhengcelibrary_bm
+  p: "1"
+  n: "{n}"
+
+output_map:
+  items: searchVO.listVO
+  item_title: title
+  item_url: url
+  item_summary: summary
+  item_published_at: pubtimeStr
+
+quality_queries:
+  - query: "行政处罚"
+  - query: "食品安全"

package/engines/specs/guardian_rss.yaml

@@ -0,0 +1,59 @@
+# The Guardian RSS — 卫报世界版（免 key、免注册）
+#
+# 补的盲区：**国际主流媒体的一手通道**。接入前 argo 的新闻域（global_event /
+# news_realtime / financial_news 等）成员全是中文财经向（东财 / 财联社 / 金十 /
+# 人民网）+ 聚合器 google_news，摸到 NYT / BBC / 卫报的唯一路径是聚合器转发，
+# 拿到的是切片而不是原站。
+#
+# 为什么在候选池里选它（2026-09-17 实测 29 个源）：
+#   Guardian  45 条 / 摘要中位 **979 字** / 最长 2769
+#   France24  24 条 / 337 字      ← 第二名
+#   Bloomberg 20 条 / 215 字
+#   NYT       23 条 / 147 字
+#   BBC       32 条 / 106 字
+# 即它的摘要密度是同侪的 3–9 倍——卫报的 <description> 直接给导语加前几段，
+# 其余媒体只给一句话。这是选它而不是选 NYT/BBC 的唯一理由，也是实测值。
+#
+# 形态：**feed_mode=hot（热榜语义）**。种子是固定的最近 45 条，这是实时流
+# 不是检索索引，所以忽略 query、返回最新条目，归 hot_trending 族。
+# 不放进 global_event 之类的话题检索域——实时流混进查询检索会白占槽位
+# （话题词对固定窗口的部分命中本来就极低），仓内 _REFILL_EXCLUDED_FAMILIES
+# 对 hot_trending 的排除注释说的是同一件事。
+#
+# 关于全文：本 RSS 不给全文（无 <content:encoded>）。卫报另有 Open Platform
+# Content API 可给 bodyText 全文（免费 developer key、500 次/天、190 万篇），
+# 但需注册；本引擎走免密路线，先落地这条。
+#
+# 验证:
+#   python3 scripts/engine_validate.py --engine guardian_rss --stage all --admit
+#   python3 scripts/search.py "今日国际要闻" --engine guardian_rss --json
+
+engine_id: guardian_rss
+type: rss_feed
+enabled: true
+cost_tier: free
+label: 卫报 RSS
+family: hot_trending
+feed_mode: hot
+# 热榜语义按设计忽略查询词，相关性词面判据对它不适用（用错标准）。
+# 实测：英文查询「world news today」打最新条目，词面交集为 0 而被误判语料选错。
+relevance_check: false
+priority: 25
+qps: 1
+period: second
+cost_per_call: 0.0
+cost_unit: free
+timeout: 12
+feed_url: https://www.theguardian.com/world/rss
+langs:
+- en
+canary_query: "今日国际要闻"
+coverage:
+- news
+- world
+desc: "卫报世界版 RSS（一手国际新闻实时流；摘要密度最高的一档，免 key）"
+recommended: false
+
+quality_queries:
+  - query: "今日国际要闻"
+  - query: "world news today"

package/engines/specs/hkex.yaml

@@ -0,0 +1,40 @@
+# 港交所披露易（HKEXnews）公告检索（免 key）
+#
+# 补的盲区：**港股一手公告**。A 股有巨潮（cninfo）、美股有 SEC EDGAR，
+# 港股此前没有对应源——查「腾讯回购」「某股供股」只能落到网页搜索。
+# 披露易是港交所官方发布渠道，公告原文 PDF 直链可用。
+#
+# 端点语义（2026-10-21 实测）：两个接口组合。
+#   1) 代码/公司名解析：/search/prefix.do?...&name=<代码或名称>&market=SEHK
+#      → callback({stockInfo:[{stockId, code, name}]})，stockId 是内部 ID
+#   2) 公告检索：/search/titleSearchServlet.do?...&stockId=…&title=…&searchType=…
+#      → {result: "<JSON 字符串>"}，逐条含 TITLE/STOCK_CODE/DATE_TIME/FILE_LINK
+# 文档标题是繁体中文，builder 对高频简体词做了映射；纯简体生僻词可能 0 结果，
+# 此时用代码查询仍可命中（如「00700 回购」）。
+#
+# 验证:
+#   python3 scripts/engine_validate.py --engine hkex --stage health --admit
+#   argo search "00700 回购" --engine hkex --json
+
+engine_id: hkex
+type: hkex
+enabled: true
+cost_tier: free
+label: 港交所披露易
+family: finance_market
+priority: 50
+qps: 1
+period: second
+cost_per_call: 0.0
+cost_unit: free
+recommended: false
+
+timeout: 20
+canary_query: "00700"
+desc: "港交所披露易公告检索（港股一手公告 PDF，代码/公司名/标题关键词，免 key）"
+coverage: [finance, stock, hk_stock, legal, official]
+
+quality_queries:
+  - query: "00700 回购"
+  - query: 腾讯 公告
+  - query: 汇丰 业绩

package/engines/specs/hurriyet.yaml

@@ -0,0 +1,43 @@
+# 自由报 RSS — Hürriyet，土耳其主流日报
+#
+# 补的盲区：**tr 本地一手新闻**。接入前 argo 的新闻链路只有中英源
+# （google_news/guardian_rss/dw_news/france24 都是英语视角），tr 查询
+# 拿不到本地一手报道。
+#
+# 实测（2026-09-21）：**68 条**，摘要中位 236 字、最长 655 字。
+#
+# 形态：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 hurriyet --stage all --admit
+#   python3 scripts/search.py "bugün haberler" --engine hurriyet --json
+
+engine_id: hurriyet
+type: rss_feed
+enabled: true
+cost_tier: free
+label: 自由报 RSS
+family: world_news
+feed_mode: hot
+relevance_check: false
+priority: 51
+qps: 1
+period: second
+cost_per_call: 0.0
+cost_unit: free
+timeout: 12
+feed_url: https://www.hurriyet.com.tr/rss/anasayfa
+langs:
+- tr
+canary_query: "bugün haberler"
+coverage:
+- news
+- turkey
+desc: "自由报（Hürriyet，土耳其主流日报，免 key）"
+recommended: false
+
+quality_queries:
+  - query: "bugün haberler"
+  - query: "Türkiye ekonomi"

package/engines/specs/iplant.yaml

@@ -0,0 +1,25 @@
+# iPlant 植物智（中科院植物所）——中文植物名（含俗名）→ 学名 + 分类
+# 补的是 argo 一条硬盲区：此前没有任何从中文名进入生物数据库的路。gbif 对纯中文
+# 查询返回无关属种（实测「玉米」首条是 Frithia 属，补 qField=VERNACULAR 仍是垃圾），
+# 本仓 gbif builder 也因此在中文查询上直接短路。iPlant 的 /info/{名} 直接吃中文名、
+# 学名、属名、科名，免认证，实测时延 0.29–0.41s。
+# 只承诺名称规范化（学名 + 属/科/目 + 俗名）；植物志正文（frps/foc）是 AJAX
+# 填充且内部接口不可直调，不做承诺。
+# 验证:
+#   python3 scripts/engine_validate.py --engine iplant --stage all --admit --write-doc
+
+engine_id: iplant
+type: iplant
+enabled: true
+cost_tier: free
+timeout: 15
+canary_query: "玉米"
+desc: "iPlant 植物智（中文植物名/俗名 → 学名 + 分类，中科院植物所，免认证）"
+coverage: [species, botany, chinese, science]
+recommended: false
+latency_ms: 1200
+
+quality_queries:
+  - query: "玉米"      # 正名：一级直接命中
+  - query: "包谷"      # 俗名：走二级消歧取接受名
+  - query: "银杏"

package/engines/specs/jikan.yaml

@@ -0,0 +1,24 @@
+# Jikan（MyAnimeList 数据，免认证非官方）——【暂不启用】
+# 2026-09-13 实测：/anime?q= 检索端点持续 504（curl 直连同样 504，非本机问题），
+# 而同站 /top/anime 与 /anime/{id} 返回 200 —— 是其检索端点的上游故障。
+# builder 逻辑已验证正确，待检索端点恢复后把 enabled 改回 true 即可。
+# 补 anime_encyclopedia 域：现有 bangumi（中文圈）+ 萌娘百科，Jikan 覆盖
+# MAL 的全球番剧库（含日文原名与评分）。社区接口，失败诚实空。
+# 验证:
+#   python3 scripts/engine_validate.py --engine jikan --stage all --admit --write-doc
+
+engine_id: jikan
+type: jikan
+enabled: false
+disabled_reason: builder 逻辑已验证正确，待检索端点恢复后把 enabled 改回 true（见文件头注释）；重开前需实测端点可用性
+cost_tier: free
+timeout: 20
+canary_query: "naruto"
+desc: "动漫元数据（Jikan/MyAnimeList，免认证，含评分与集数）"
+coverage: [anime, media, entertainment, japanese]
+recommended: false
+latency_ms: 2500
+
+quality_queries:
+  - query: "naruto"
+  - query: "attack on titan"

package/engines/specs/jolpica.yaml

@@ -0,0 +1,20 @@
+# Jolpica F1 — Ergast API 的社区继任者（免认证）
+# 补 sports_search 域的「赛车」维度。Ergast 已于 2024 停止服务，Jolpica 兼容其接口。
+# 验证:
+#   python3 scripts/engine_validate.py --engine jolpica --stage all --admit --write-doc
+
+engine_id: jolpica
+type: jolpica
+enabled: true
+cost_tier: free
+timeout: 20
+canary_query: "verstappen"
+desc: "F1 车手积分榜/赛程（Jolpica，Ergast 继任，免认证）"
+family: sports
+coverage: [sports, racing, statistics]
+recommended: false
+latency_ms: 2500
+
+quality_queries:
+  - query: "verstappen"
+  - query: "f1 2026 standings"

package/engines/specs/k10plus.yaml

@@ -0,0 +1,20 @@
+# K10plus SRU 联合目录（德国最大，SRU 标准协议，免认证）
+# 补 book_search 域的馆藏维度：现有 open_library/gutenberg 偏英文公版，
+# K10plus 覆盖德语区学术馆藏（3000+ 万条），SRU 标准协议可复用到其他 SRU 馆。
+# 验证:
+#   python3 scripts/engine_validate.py --engine k10plus --stage all --admit --write-doc
+
+engine_id: k10plus
+type: k10plus
+enabled: true
+cost_tier: free
+timeout: 30
+canary_query: "tesla"
+desc: "K10plus 联合目录（德国最大图书馆联合目录，SRU，免认证）"
+coverage: [book, library, academic, german]
+recommended: false
+latency_ms: 2500
+
+quality_queries:
+  - query: "tesla"
+  - query: "kant kritik"

package/engines/specs/keenable.yaml

@@ -0,0 +1,44 @@
+# Keenable 搜索引擎（需 ARGO_KEENABLE_API_KEY）
+# 文档: https://docs.keenable.ai/api-reference/search
+# 认证: X-API-Key: keen_<key>（POST /v1/search）；keyless 走 /public（公共池限流，此处不用）
+# 额度: 按组织限流 + 消费 credits；响应带 X-RateLimit-* 头，429 带 Retry-After
+# 定位: 通用网络搜索（ranked results：URL/title/description/snippet/published_at）
+# 验证:
+#   export ARGO_KEENABLE_API_KEY=<key>
+#   python3 scripts/engine_validate.py --engine keenable --stage all --admit --write-doc
+#   python3 scripts/search.py "OpenAI" --engine keenable --json
+
+engine_id: keenable
+type: http
+enabled: true
+# 免费体验期：量较大，按 free 源对待（auto/fast 均可用），不参与 budget 成本过滤。
+# 不预设「到期后改回 api」——免费期结束或冒问题（额度/报错/变慢）时，
+# 直接置 enabled: false 停用即可（灵活，别为它写自动切换的脆弱逻辑）。
+cost_tier: free
+method: POST
+url: https://api.keenable.ai/v1/search
+timeout: 12
+canary_query: "OpenAI"
+label: Keenable
+family: web_general
+desc: "Keenable 通用网页搜索（ranked results，含 published_at，按 credits 计费）"
+required_env:
+  - ARGO_KEENABLE_API_KEY
+
+headers:
+  X-API-Key: "{ARGO_KEENABLE_API_KEY}"
+  Content-Type: application/json
+
+# POST body; {query} 查询词，{n} 结果数（Keenable max_results 1-50，int 化）
+body:
+  query: "{query}"
+  max_results: "{n}"
+
+# Keenable 返回 {query, results:[{title,url,description,snippet,published_at,acquired_at}]}
+output_map:
+  items: results
+  item_title: title
+  item_url: url
+  item_summary: snippet
+  item_source: keenable
+  item_published_at: published_at

package/engines/specs/keenable_free.yaml

@@ -0,0 +1,36 @@
+# Keenable 免 key 通道（官方 MCP 匿名额度）
+#
+# 与 keenable 并列而不是合并：keyenable 的 REST 通道按 ARGO_KEENABLE_API_KEY
+# 计 credits，本通道走官方 MCP 匿名池、不读任何 key。两条通道额度模型不同，
+# 分开注册才能让「免费源不当计费源」的检查各自成立（同 tavily / parallel 先例）。
+#
+# 端点语义（2026-10-21 实测）：POST https://api.keenable.ai/mcp，
+# JSON-RPC tools/call → search_web_pages {query, mode:"realtime"}；
+# 返回 content[0].text 为纯文本块（Title/URL/Published/Snippets，`---` 分隔）。
+# 匿名池按 IP 限流，失效时返回 4xx/空块，由调度层换源。
+#
+# 验证:
+#   python3 scripts/engine_validate.py --engine keenable_free --stage health --admit
+#   argo search "OpenAI latest news" --engine keenable_free --json
+
+engine_id: keenable_free
+type: keenable_free
+enabled: true
+cost_tier: free
+label: Keenable (keyless)
+family: web_general
+priority: 57
+qps: 1
+period: second
+cost_per_call: 0.0
+cost_unit: free
+recommended: false
+
+timeout: 20
+canary_query: OpenAI
+desc: "Keenable 官方免 key 匿名通道（通用网页搜索，无需注册）"
+coverage: [general, english, chinese]
+
+quality_queries:
+  - query: OpenAI latest news
+  - query: 人工智能 最新进展

package/engines/specs/lefigaro.yaml

@@ -0,0 +1,43 @@
+# 费加罗报 RSS — Le Figaro，法国主流日报
+#
+# 补的盲区：**fr 本地一手新闻**。接入前 argo 的新闻链路只有中英源
+# （google_news/guardian_rss/dw_news/france24 都是英语视角），fr 查询
+# 拿不到本地一手报道。
+#
+# 实测（2026-09-21）：**20 条**，摘要中位 189 字、最长 255 字。
+#
+# 形态：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 lefigaro --stage all --admit
+#   python3 scripts/search.py "actualités du jour" --engine lefigaro --json
+
+engine_id: lefigaro
+type: rss_feed
+enabled: true
+cost_tier: free
+label: 费加罗报 RSS
+family: world_news
+feed_mode: hot
+relevance_check: false
+priority: 45
+qps: 1
+period: second
+cost_per_call: 0.0
+cost_unit: free
+timeout: 12
+feed_url: https://www.lefigaro.fr/rss/figaro_actualites.xml
+langs:
+- fr
+canary_query: "actualités du jour"
+coverage:
+- news
+- france
+desc: "费加罗报（Le Figaro，法国主流日报，免 key）"
+recommended: false
+
+quality_queries:
+  - query: "actualités du jour"
+  - query: "politique France"

package/engines/specs/listenbrainz.yaml

@@ -0,0 +1,19 @@
+# ListenBrainz 收听趋势（免认证，社区收听统计）
+# 补 media_search 域的「收听热度」维度（musicbrainz 只给元数据，无流行度）。
+# 验证:
+#   python3 scripts/engine_validate.py --engine listenbrainz --stage all --admit --write-doc
+
+engine_id: listenbrainz
+type: listenbrainz
+enabled: true
+cost_tier: free
+timeout: 15
+canary_query: "pop"
+desc: "音乐收听趋势榜（ListenBrainz，免认证）"
+coverage: [media, music, statistics]
+recommended: false
+latency_ms: 2000
+
+quality_queries:
+  - query: "pop"
+  - query: "jazz"

package/engines/specs/matichon.yaml

@@ -0,0 +1,43 @@
+# 泰国民族报 RSS — Matichon，泰国主流日报
+#
+# 补的盲区：**th 本地一手新闻**。接入前 argo 的新闻链路只有中英源
+# （google_news/guardian_rss/dw_news/france24 都是英语视角），th 查询
+# 拿不到本地一手报道。
+#
+# 实测（2026-09-21）：**50 条**，摘要中位 65 字、最长 65 字。
+#
+# 形态：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 matichon --stage all --admit
+#   python3 scripts/search.py "ข่าววันนี้" --engine matichon --json
+
+engine_id: matichon
+type: rss_feed
+enabled: true
+cost_tier: free
+label: 泰国民族报 RSS
+family: world_news
+feed_mode: hot
+relevance_check: false
+priority: 48
+qps: 1
+period: second
+cost_per_call: 0.0
+cost_unit: free
+timeout: 12
+feed_url: https://www.matichon.co.th/feed
+langs:
+- th
+canary_query: "ข่าววันนี้"
+coverage:
+- news
+- thailand
+desc: "泰国民族报（Matichon，泰国主流日报，免 key）"
+recommended: false
+
+quality_queries:
+  - query: "ข่าววันนี้"
+  - query: "การเมืองไทย"

package/engines/specs/met_museum.yaml

@@ -0,0 +1,21 @@
+# Met Museum 藏品库 — 大都会艺术博物馆公开馆藏（免认证，两跳：搜索→详情）
+# 艺术品/博物馆藏品的完全空白补位：49 万藏品含高清公版图像。
+# 二跳结构：search 只回 objectIDs，逐个取详情（上限 6 条控延迟）。
+# 验证:
+#   python3 scripts/engine_validate.py --engine met_museum --stage all --admit --write-doc
+
+engine_id: met_museum
+type: met_museum
+enabled: true
+cost_tier: free
+timeout: 20
+canary_query: "van gogh"
+desc: "Met Museum 藏品库（艺术/博物馆藏品，两跳搜索，免认证）"
+coverage: [art, museum, culture, media]
+recommended: false
+latency_ms: 3000
+
+quality_queries:
+  - query: "van gogh"
+  - query: "japanese armor"
+  - query: "egyptian scarab"