argo-search 1.0.1 → 2.9.8

package/engines/specs/doi.yaml

@@ -0,0 +1,39 @@
+# DOI 内容协商引擎（doi.org 官方解析器，keyless 直出结构化元数据）
+# 机制: https://doi.org/<DOI> 配 Accept 头做内容协商——
+#       application/vnd.citationstyles.csl+json → CSL JSON（标题/作者/期刊/年份）
+#       text/x-bibtex → BibTeX 引用（本引擎走 CSL JSON）
+# 用法: 显式专用（explicit_only）——查询词传裸 DOI（如 10.1145/3442188.3445922），
+#       不要带 https://doi.org/ 前缀（{query} 原样进路径）
+# 特点: 免 key、不限次；单对象 CSL JSON 响应走 _CUSTOM_JSON_PARSERS["doi"]
+#       （声明式 output_map 只支持数组根，单对象根由专用解析器包裹）
+# 验证:
+#   python3 scripts/engine_validate.py --engine doi --stage health --admit
+#   python3 scripts/search.py "10.1145/3442188.3445922" --engine doi --json
+
+engine_id: doi
+type: http
+enabled: true
+# 按 DOI 精查而非关键词检索，不参与自动路由
+explicit_only: true
+cost_tier: free
+label: DOI 元数据直出
+family: academic
+priority: 50
+qps: 2
+period: second
+limit: null
+cost_per_call: 0.0
+cost_unit: free
+method: GET
+url: https://doi.org/{query}
+timeout: 12
+canary_query: "10.1145/3442188.3445922"
+coverage:
+- academic
+- metadata
+desc: "DOI 内容协商（doi.org 官方解析器，Accept 头直出 CSL JSON 结构化元数据，keyless 免 key 免限次，查询词传裸 DOI）"
+format: json
+# 空字符串 = 该 API 不用查询参数名（DOI 走 URL 路径，由 {query} 注入）
+query_param: ""
+headers:
+  Accept: "application/vnd.citationstyles.csl+json"

package/engines/specs/douban_movie.yaml

@@ -0,0 +1,22 @@
+# 豆瓣电影搜索 — suggest 接口（免认证）
+# film_search 域的中文视角补位：imdb/itunes 全英文视角，豆瓣给中文片名/
+# 年份/类型。豆瓣对无 cookie 请求逐步收紧（音乐口子已死），本接口仍存活，
+# 失败诚实空，不做绕过。
+# 验证:
+#   python3 scripts/engine_validate.py --engine douban_movie --stage all --admit --write-doc
+
+engine_id: douban_movie
+type: douban_movie
+enabled: true
+cost_tier: free
+timeout: 10
+canary_query: "流浪地球"
+desc: "豆瓣电影搜索（中文片名/年份/类型，免认证，suggest 接口）"
+coverage: [film, chinese, media]
+recommended: false
+latency_ms: 1000
+
+quality_queries:
+  - query: "流浪地球"
+  - query: "霸王别姬"
+  - query: "Inception"

package/engines/specs/dw_news.yaml

@@ -0,0 +1,47 @@
+# DW News RSS — 德国之声英语版（免 key、免注册）
+#
+# 补的盲区：**德语区/欧洲公共广播的国际新闻**。与 france24 同批接入，
+# 都是「非英美视角的国际新闻」——这类视角在只用英美源的组合里是盲的。
+#
+# 实测（2026-09-17）：**139 条**，摘要中位 193 字、最长 220。条目数是候选池
+# 里最多的（卫报 45、NYT 23、BBC 32），代价是摘要密度中等（193 字，排中游）。
+# 条目多意味着实时流更长，这是它相对 france24（24 条）的取舍。
+#
+# 形态：feed_mode=hot（热榜语义，同 guardian_rss）。归 hot_trending 族。
+#
+# 可达性（实测 2026-09-17）：它是 intl_news_flash 域的第 3 位，fast 档的
+# combo 预算裁到 2 个引擎，所以 fast 下不出现；`--depth balanced` 起三个
+# 全部入选。也就是说它是「加宽档」的补充源，不是默认档成员——
+# 这不是缺陷，是预算位只有那么多时该有的排序结果。
+#
+# 验证:
+#   python3 scripts/engine_validate.py --engine dw_news --stage all --admit
+#   python3 scripts/search.py "今日国际要闻" --depth balanced --json
+
+engine_id: dw_news
+type: rss_feed
+enabled: true
+cost_tier: free
+label: DW 德国之声 RSS
+family: hot_trending
+feed_mode: hot
+relevance_check: false
+priority: 32
+qps: 1
+period: second
+cost_per_call: 0.0
+cost_unit: free
+timeout: 12
+feed_url: https://rss.dw.com/rdf/rss-en-all
+langs:
+- en
+canary_query: "今日国际要闻"
+coverage:
+- news
+- world
+desc: "德国之声英语版 RSS（德语区/欧洲公共广播视角，条目数最多的一档）"
+recommended: false
+
+quality_queries:
+  - query: "今日国际要闻"
+  - query: "world news today"

package/engines/specs/egov_law.yaml

@@ -0,0 +1,21 @@
+# 日本 e-Gov 法令检索（官方全文，免认证）
+# 补 legal 域的日本法条：现有 flk_law（中国）、kor_law（韩国）、
+# courtlistener（美国判例）、wenshu（中国判例），日本法令此前空白。
+# lawlists 返回全量法令名 XML，本地按关键词过滤（API 无服务端检索参数）。
+# 验证:
+#   python3 scripts/engine_validate.py --engine egov_law --stage all --admit --write-doc
+
+engine_id: egov_law
+type: egov_law
+enabled: true
+cost_tier: free
+timeout: 20
+canary_query: "民法"
+desc: "日本法令检索（e-Gov 官方全文，免认证）"
+coverage: [legal, law_text, japanese, official]
+recommended: false
+latency_ms: 3000
+
+quality_queries:
+  - query: "民法"
+  - query: "個人情報"

package/engines/specs/elpais.yaml

@@ -0,0 +1,43 @@
+# 西班牙国家报 RSS — El País，西语世界发行量最大的日报
+#
+# 补的盲区：**es 本地一手新闻**。接入前 argo 的新闻链路只有中英源
+# （google_news/guardian_rss/dw_news/france24 都是英语视角），es 查询
+# 拿不到本地一手报道。
+#
+# 实测（2026-09-21）：**143 条**，摘要中位 158 字、最长 445 字。
+#
+# 形态：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 elpais --stage all --admit
+#   python3 scripts/search.py "noticias de hoy" --engine elpais --json
+
+engine_id: elpais
+type: rss_feed
+enabled: true
+cost_tier: free
+label: 西班牙国家报 RSS
+family: world_news
+feed_mode: hot
+relevance_check: false
+priority: 43
+qps: 1
+period: second
+cost_per_call: 0.0
+cost_unit: free
+timeout: 12
+feed_url: https://feeds.elpais.com/mrss-s/pages/ep/site/elpais.com/portada
+langs:
+- es
+canary_query: "noticias de hoy"
+coverage:
+- news
+- spain
+desc: "西班牙国家报（El País，西语世界发行量最大的日报，免 key）"
+recommended: false
+
+quality_queries:
+  - query: "noticias de hoy"
+  - query: "economía España"

package/engines/specs/endoflife.yaml

@@ -0,0 +1,21 @@
+# endoflife.date — 产品生命周期（200+ 产品，免认证）
+# 查询词 = 产品 slug（python/nodejs/go/kubernetes/ubuntu…）；API 无搜索端点，
+# slug 提取取查询里第一个 ASCII 词。未识别产品诚实返回空。
+# 验证:
+#   python3 scripts/engine_validate.py --engine endoflife --stage all --admit --write-doc
+
+engine_id: endoflife
+type: endoflife
+enabled: true
+cost_tier: free
+timeout: 10
+canary_query: "python 生命周期"
+desc: "产品生命周期（版本/最新/支持期/EOL，endoflife.date 200+ 产品）"
+coverage: [tech]
+recommended: false
+latency_ms: 2000
+
+quality_queries:
+  - query: "python 生命周期"
+  - query: "nodejs"
+  - query: "kubernetes EOL"

package/engines/specs/energy_charts.yaml

@@ -0,0 +1,21 @@
+# Energy-Charts — 欧洲发电结构与可再生占比（Fraunhofer ISE，免认证）
+# 补 energy 域的「发电结构/可再生实时」维度：按国家给逐时发电类型曲线。
+# 文档要求署名（数据来源 Fraunhofer ISE），已在 desc 与 url 体现。
+# 国家码由 builder 侧按查询词解析，默认 de（德国）。
+# 验证:
+#   python3 scripts/engine_validate.py --engine energy_charts --stage all --admit --write-doc
+
+engine_id: energy_charts
+type: energy_charts
+enabled: true
+cost_tier: free
+timeout: 20
+canary_query: "germany power"
+desc: "Energy-Charts 欧洲发电结构/可再生占比（Fraunhofer ISE，免认证）"
+coverage: [energy, environment, statistics, europe]
+recommended: false
+latency_ms: 2500
+
+quality_queries:
+  - query: "germany power"
+  - query: "france nuclear"

package/engines/specs/factcheck_org.yaml

@@ -0,0 +1,52 @@
+# FactCheck.org RSS — 美国事实核查（免 key、免注册）
+#
+# 补的盲区：**「这个说法有没有被核查过」**。这与 argo 已有的任何一族都不同：
+#   新闻族  回答「发生了什么」
+#   百科族  回答「X 是什么」
+#   本引擎  回答「这个具体声明被判定为真/假/误导」
+# 接入前 argo 的核验能力全靠下游对普通搜索结果打分（evidence.py 的来源类型
+# 加权），没有「声明级」的一手判定。argo 的定位本身是「搜索与证据核验」，
+# 这是补一个不存在的功能维度，不是往新闻池里再加一桶水。
+#
+# 实测（2026-09-17）：10 条，摘要中位 **482 字**、最长 566——除卫报外全场最高。
+# 核查文本身就是密度型内容（结论 + 依据），所以摘要信息量天然高。
+#
+# 覆盖范围：**以美国政治/公共议题为主**，非全球通用。若要英国口径另见 full_fact。
+#
+# 召回边界：RSS 固定窗口（最近 10 条）+ 本地关键词过滤。10 条意味着命中面很窄，
+# 只有查询正好落在近期核查过的议题上才有结果——这是它的固有限制，不是缺陷；
+# 它的价值是「正好问到点上时给出权威判定」。
+#
+# 验证:
+#   python3 scripts/engine_validate.py --engine factcheck_org --stage all --admit
+#   python3 scripts/search.py "election" --engine factcheck_org --json
+
+engine_id: factcheck_org
+type: rss_feed
+enabled: true
+cost_tier: free
+label: FactCheck.org
+family: verification
+feed_mode: filter
+priority: 28
+qps: 1
+period: second
+cost_per_call: 0.0
+cost_unit: free
+timeout: 12
+feed_url: https://www.factcheck.org/feed/
+langs:
+- en
+canary_query: "president"
+coverage:
+- news
+- verification
+desc: "FactCheck.org（美国事实核查：声明级真伪判定，摘要密度仅次于卫报）"
+recommended: false
+
+# 见 guardian_rss 的说明。该种子仅 10 条、逐日轮换，实测 2026-09-17 当日
+# president 命中 8/10、people 10/10——取 president 而非 people，因为后者
+# 是虚义词，命中了也不说明引擎在正确工作。
+quality_queries:
+  - query: "president"
+  - query: "election"

package/engines/specs/faz.yaml

@@ -0,0 +1,43 @@
+# 法兰克福汇报 RSS — FAZ，德国全国性日报
+#
+# 补的盲区：**de 本地一手新闻**。接入前 argo 的新闻链路只有中英源
+# （google_news/guardian_rss/dw_news/france24 都是英语视角），de 查询
+# 拿不到本地一手报道。
+#
+# 实测（2026-09-21）：**162 条**，摘要中位 187 字、最长 288 字。
+#
+# 形态：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 faz --stage all --admit
+#   python3 scripts/search.py "aktuelle Nachrichten" --engine faz --json
+
+engine_id: faz
+type: rss_feed
+enabled: true
+cost_tier: free
+label: 法兰克福汇报 RSS
+family: world_news
+feed_mode: hot
+relevance_check: false
+priority: 46
+qps: 1
+period: second
+cost_per_call: 0.0
+cost_unit: free
+timeout: 12
+feed_url: https://www.faz.net/rss/aktuell/
+langs:
+- de
+canary_query: "aktuelle Nachrichten"
+coverage:
+- news
+- germany
+desc: "法兰克福汇报（FAZ，德国全国性日报，免 key）"
+recommended: false
+
+quality_queries:
+  - query: "aktuelle Nachrichten"
+  - query: "Wirtschaft Deutschland"

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: usd
+
+# 可选密钥（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,36 @@
+# 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
+# 状态注记（2026-10-21 实测）：上游 /2/search 搜索端点已停用（对任意查询返回
+# 空 results，强制调用 6.3s 零结果），status/profile 端点仍正常但不属本引擎职责。
+# X 关键词搜索走 `argo x-search`（ego-browser 通道，见 config.yaml 的 twitter 引擎）
+# 或 `--engine twitter`；单条推文按 URL 取正文仍走 `argo tweet`（twitter_syndication）。
+# 保留注册：上游若恢复搜索端点可直接复用，声明本身无需改动。
+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"