argo-search 1.0.1 → 2.9.7

package/engines/specs/federal_register.yaml

@@ -0,0 +1,57 @@
+# Federal Register — 美国联邦公报（免 key、免注册）
+#
+# 补的盲区：**美国联邦法规原文与提案**。已有的 courtlistener 覆盖法院判例、
+# gov_regulations/flk_law 覆盖中国法规、eurlex 类覆盖欧盟，而美国行政法规
+# （rules / proposed rules / notices）此前没有一手源——这类问题搜索引擎只能
+# 给新闻与二手解读，而法规原文本身就是权威证据。
+#
+# 端点语义（实测 2026-09-16）：
+#   /api/v1/documents.json?conditions[term]=<q>  → 全文检索，返回 count + results
+#   实测 "artificial intelligence" → 1565 条
+# 免 key；官方建议加 User-Agent 标识（argo 已统一带）。
+#
+# 验证:
+#   python3 scripts/engine_validate.py --engine federal_register --stage health --admit
+#   python3 scripts/search.py "artificial intelligence" --engine federal_register --json
+
+engine_id: federal_register
+type: http
+enabled: true
+cost_tier: free
+label: Federal Register 联邦公报
+family: legal
+priority: 46
+qps: 2
+period: second
+cost_per_call: 0.0
+cost_unit: free
+method: GET
+url: https://www.federalregister.gov/api/v1/documents.json
+query_param: "conditions[term]"
+extra_params:
+  per_page: "10"
+# 刻意**不声明 fields[]**：该 API 的字段裁剪只认「重复的 fields[] 参数」
+# （fields[]=title&fields[]=html_url），而 extra_params 会把值 str() 后当成
+# 单个参数发送（列表会变成 "['title', ...]" 触发 400；逗号形式亦不认）。
+# 不裁剪的代价是响应多带 excerpts 字段，但结果正确——宁可多几 KB，也不要
+# 「拿到 10 条却因 html_url 被裁掉而静默变 0 条」。
+timeout: 15
+format: json
+canary_query: "artificial intelligence"
+coverage:
+- legal
+- regulation
+- us
+desc: "美国联邦公报全文检索（行政法规/提案/通告原文，免 key；一手法规源）"
+output_map:
+  items: results
+  item_title: title
+  item_summary: abstract
+  item_url: html_url
+  item_published_at: publication_date
+recommended: false
+latency_ms: 1200
+
+quality_queries:
+  - query: "artificial intelligence"
+  - query: "data privacy"

package/engines/specs/firecrawl.yaml

@@ -0,0 +1,53 @@
+# Firecrawl 搜索引擎（官方云 API，keyless 免配置优先启用）
+# 文档: https://docs.firecrawl.dev/api-reference/endpoint/search
+# 额度: 免费层 1000 credits/月（按结果数计费，约 1 credit/条）；Billing Period 月重置。
+#       匿名（不带 Authorization）即走免费层；配置 FIRECRAWL_API_KEY（可选）后
+#       计入注册账号额度并支持更高稳定性
+# 特点: search+scrape 一体化、JS 渲染、categories(github/research/pdf)、tbs 时间窗、
+#       site:/inurl:/filetype: 高级算符
+# 定位: T2 补充引擎 —— 免费池可路由（daily_support），priority 低 + combo 预算截断，
+#       日常少用保护共享免费层配额；deep/research 全量可用
+# 验证:
+#   python3 scripts/engine_validate.py --engine firecrawl --stage all --admit
+#   python3 scripts/search.py "climate change" --engine firecrawl --json
+
+engine_id: firecrawl
+type: http
+enabled: true
+cost_tier: free
+# 分层：daily_support —— 日常 combo 可参与（failover 补位），budget 截断优先命中，
+# 不至于把 1000 credits/月 免费层当主力烧掉（engine_policy.get_engine_tier 读 spec.tier）
+tier: daily_support
+method: POST
+url: https://api.firecrawl.dev/v2/search
+timeout: 20
+canary_query: "climate change"
+desc: "Firecrawl 云搜索（search+全文markdown，JS渲染/学术/PDF垂直，keyless 免费层 1000 credits/月）"
+label: Firecrawl
+family: web_general
+# 预算感知：priority 低 + daily_support，日常排 combo 后排，配额留给 failover 补位
+priority: 50
+qps: 1
+period: month
+limit: 1000
+cost_per_call: 0.001
+cost_unit: credit
+
+# 可选密钥（OPTIONAL_ENV_ENGINES）：未配置时不发送 Authorization（keyless 直连免费层）
+headers:
+  Authorization: Bearer {FIRECRAWL_API_KEY}
+  Content-Type: application/json
+
+# POST body；{query} 查询词，{n} 结果数
+# 注意：argo HTTP builder 仅支持标量值（嵌套数组/对象会失效），故只用 query/limit；
+#       description 字段已含 markdown 全文（API 默认 scrapeOptions.formats=[markdown]）
+body:
+  query: "{query}"
+  limit: "{n}"
+
+# firecrawl 返回 {success, data:{web:[{title,description,url,markdown,...}]}}
+output_map:
+  items: data.web
+  item_title: title
+  item_url: url
+  item_summary: description

package/engines/specs/flk_law.yaml

@@ -0,0 +1,24 @@
+# 国家法律法规数据库 — 法律/行政法规/司法解释/地方性法规（POST JSON，免认证）
+# legal 域的权威法条文本源：此前只有裁判文书（wenshu）+国务院政策（gov_policy），
+# 缺法条本身。接口为 flk SPA 前端逆向（searchRange 1=标题 2=正文，searchType
+# 1=精确 2=模糊；orderByParam 是对象 {order,sort}，扁平 body 会 500）。
+# 高亮 <em> 标签剥离；sxx 时效性映射：1 已废止 / 2 已修改 / 3 有效 / 4 尚未生效。
+# 无验证码无签名；失败诚实空，不做绕过。
+# 验证:
+#   python3 scripts/engine_validate.py --engine flk_law --stage all --admit --write-doc
+
+engine_id: flk_law
+type: flk_law
+enabled: true
+cost_tier: free
+timeout: 25
+canary_query: "行政处罚"
+desc: "国家法律法规数据库（法律/行政法规/司法解释全文，权威法条源，免认证）"
+coverage: [legal, law, chinese, gov]
+recommended: false
+latency_ms: 2000
+
+quality_queries:
+  - query: "行政处罚"
+  - query: "个人信息保护"
+  - query: "劳动法"

package/engines/specs/folha.yaml

@@ -0,0 +1,43 @@
+# 巴西页报 RSS — Folha de S.Paulo，巴西最大日报
+#
+# 补的盲区：**pt 本地一手新闻**。接入前 argo 的新闻链路只有中英源
+# （google_news/guardian_rss/dw_news/france24 都是英语视角），pt 查询
+# 拿不到本地一手报道。
+#
+# 实测（2026-09-21）：**100 条**，摘要中位 279 字、最长 514 字。
+#
+# 形态：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 folha --stage all --admit
+#   python3 scripts/search.py "notícias de hoje" --engine folha --json
+
+engine_id: folha
+type: rss_feed
+enabled: true
+cost_tier: free
+label: 巴西页报 RSS
+family: world_news
+feed_mode: hot
+relevance_check: false
+priority: 44
+qps: 1
+period: second
+cost_per_call: 0.0
+cost_unit: free
+timeout: 12
+feed_url: https://feeds.folha.uol.com.br/poder/rss091.xml
+langs:
+- pt
+canary_query: "notícias de hoje"
+coverage:
+- news
+- brazil
+desc: "巴西页报（Folha de S.Paulo，巴西最大日报，免 key）"
+recommended: false
+
+quality_queries:
+  - query: "notícias de hoje"
+  - query: "política Brasil"

package/engines/specs/france24.yaml

@@ -0,0 +1,44 @@
+# France 24 RSS — 法国 24 英语版（免 key、免注册）
+#
+# 补的盲区：**法语区视角的国际新闻**。接入前 argo 对法语世界没有直采通道，
+# 欧洲视角只能靠英文源转述。
+#
+# 实测（2026-09-17）：24 条，摘要中位 337 字、最长 610——在候选池里排第二，
+# 仅次于卫报（979 字），高于 NYT（147）/ BBC（106）。条目量偏少（24），
+# 所以它是互补位而不是主位。
+#
+# 形态：feed_mode=hot（热榜语义，同 guardian_rss）。归 hot_trending 族，
+# 不进话题检索域。注意同族在组合里有 max_per_family=2 上限，它与
+# guardian_rss 同族，两者在同一 combo 里至多同时出现两个。
+#
+# 验证:
+#   python3 scripts/engine_validate.py --engine france24 --stage all --admit
+#   python3 scripts/search.py "今日国际要闻" --engine france24 --json
+
+engine_id: france24
+type: rss_feed
+enabled: true
+cost_tier: free
+label: France 24 RSS
+family: hot_trending
+feed_mode: hot
+relevance_check: false
+priority: 30
+qps: 1
+period: second
+cost_per_call: 0.0
+cost_unit: free
+timeout: 12
+feed_url: https://www.france24.com/en/rss
+langs:
+- en
+canary_query: "今日国际要闻"
+coverage:
+- news
+- world
+desc: "France 24 英语版 RSS（法语区一手的国际新闻实时流，免 key）"
+recommended: false
+
+quality_queries:
+  - query: "今日国际要闻"
+  - query: "world news today"

package/engines/specs/full_fact.yaml

@@ -0,0 +1,47 @@
+# Full Fact RSS — 英国事实核查（免 key、免注册）
+#
+# 补的盲区：与 factcheck_org 同族（verification），但**口径不同**——
+# Full Fact 核查英国政治与公共数据，FactCheck.org 覆盖美国议题。
+# 两源并存不是重复：同一族内保持不同法域口径，才有交叉验证的意义。
+#
+# 实测（2026-09-17）：10 条，摘要中位 140 字、最长 204。密度明显低于
+# FactCheck.org（482 字），条目数同样只有 10——所以它是 factcheck_org 的
+# 补位而非替代。
+#
+# 召回边界：RSS 固定窗口（最近 10 条）+ 本地关键词过滤，命中面窄。
+#
+# 验证:
+#   python3 scripts/engine_validate.py --engine full_fact --stage all --admit
+#   python3 scripts/search.py "election" --engine full_fact --json
+
+engine_id: full_fact
+type: rss_feed
+enabled: true
+cost_tier: free
+label: Full Fact
+family: verification
+feed_mode: filter
+priority: 34
+qps: 1
+period: second
+cost_per_call: 0.0
+cost_unit: free
+timeout: 12
+feed_url: https://fullfact.org/feed/
+langs:
+- en
+canary_query: "shared"
+coverage:
+- news
+- verification
+desc: "Full Fact（英国事实核查：与 FactCheck.org 分属英美两法域口径）"
+recommended: false
+
+# ⚠️ 五源中命中面最窄的一个：种子仅 10 条且逐日轮换，加之核查文本身是
+# 话题型内容，高频实词极少。实测 2026-09-17 当日 shared 4/10、posts/claims/
+# online/viral 各 3/10——canary 只能取到 4/10 这一档，明显低于其余四源。
+# 若 health 转 fail，第一个怀疑对象是词而非引擎；用 guardian_rss 里那条
+# 命令换词重测。
+quality_queries:
+  - query: "shared"
+  - query: "posts"

package/engines/specs/fxtwitter.yaml

@@ -0,0 +1,31 @@
+# FxTwitter / FxEmbed 公开 API — X/Twitter 推文搜索（零 Key）
+# 文档: https://docs.fxembed.com/api/twitter/
+# 验证:
+#   python3 scripts/engine_validate.py --engine fxtwitter --stage all --admit --write-doc
+#   python3 scripts/search.py "OpenAI" --engine fxtwitter --json
+
+engine_id: fxtwitter
+type: http
+enabled: true
+cost_tier: free
+method: GET
+url: https://api.fxtwitter.com/2/search
+timeout: 10
+query_param: q
+canary_query: "OpenAI"
+desc: "FxTwitter 公开 API：X/Twitter 推文搜索（零认证，含互动元数据）"
+coverage: [social, english]
+recommended: false
+
+headers:
+  User-Agent: argo-search/1.0 (+fxtwitter)
+  Accept: application/json
+
+extra_params:
+  count: "{n}"
+
+output_map:
+  items: results
+  item_title: text
+  item_url: url
+  item_summary: text

package/engines/specs/gbfs_nyc.yaml

@@ -0,0 +1,32 @@
+# GBFS — 通用共享单车/滑板车标准规范（免认证）
+# 补「共享单车实时站点」空白：GBFS 是标准规范，全球数百城市同构，
+# 换 base URL 即可复用（本 spec 以 NYC Citi Bike 为首发，其余城市按需追加）。
+# 榜单/快照型源：查询词不参与过滤，命中即给城市站点清单。
+# 验证:
+#   python3 scripts/engine_validate.py --engine gbfs_nyc --stage all --admit --write-doc
+
+engine_id: gbfs_nyc
+type: http
+enabled: true
+cost_tier: free
+method: GET
+url: https://gbfs.citibikenyc.com/gbfs/en/station_information.json
+timeout: 15
+query_param: ""
+canary_query: "bike"
+desc: "GBFS 共享单车站点（NYC Citi Bike，通用规范，免认证）"
+coverage: [transport, geo, realtime, open_data]
+recommended: false
+latency_ms: 1500
+
+headers:
+  User-Agent: argo-search/1.0 (+gbfs)
+
+output_map:
+  items: data.stations
+  item_title: name
+  item_summary: capacity
+  url_template: "https://maps.google.com/?q={lat},{lon}"
+
+quality_queries:
+  - query: "bike share"

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/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/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"