argo-search 2.9.7 → 2.9.8

package/docs/ENGINE_CATALOG.md

@@ -6,9 +6,9 @@
 
 ## 一、总量与口径
 
-- **收录 264 个源**（config.yaml + `engines/specs/*.yaml` 声明合并后的总数）
-- **开箱可用 227 个**：不需要你配任何密钥或装额外工具，自动路由就会用上
-- **需自备密钥 22 个**：`bocha`、`bocha_ai`、`byted`、`deepseek_search`、`em_miaoxiang`、`exa`、`keenable`、`octen`、`parallel`、`qweather`、`seltz`、`tavily`、`tinyfish`、`tinyfish_news`、`tinyfish_paper`、`unpaywall`、`weread`、`you`、`zhihu`、`zhihu_global`、`zhihu_hot`、`zhihu_user`（没配也不影响搜索，路由会跳过）
+- **收录 272 个源**（config.yaml + `engines/specs/*.yaml` 声明合并后的总数）
+- **开箱可用 235 个**：不需要你配任何密钥或装额外工具，自动路由就会用上
+- **需自备密钥 22 个**：`bocha`、`bocha_ai`、`byted`、`deepseek_search`、`em_miaoxiang`、`keenable`、`octen`、`parallel`、`qweather`、`seltz`、`tavily`、`tinyfish`、`tinyfish_news`、`tinyfish_paper`、`unpaywall`、`weread`、`you`、`yuanbao`、`zhihu`、`zhihu_global`、`zhihu_hot`、`zhihu_user`（没配也不影响搜索，路由会跳过）
 - **需装后端工具 3 个**：`reddit`、`twitter`、`xiaohongshu`（装好并登录后即可用）
 - **已停用 12 个**：`brave`、`digup`、`europeana`、`felo`、`jikan`、`local_goodreads`、`metaso`、`nbs_stats`、`realtime_index`、`searxng`、`soilgrids`、`wolframalpha`
 - **显式专用 16 个**：`bing_rss`、`datagov_uk`、`deepseek_search`、`doi`、`ecosia`、`gdelt`、`opencitations`、`qwant`、`tineye`、`tinyfish`、`tinyfish_news`、`tinyfish_paper`、`twitter_syndication`、`unpaywall`、`x_trending`、`zbmath`（设计上不进自动路由，按 `--engine` 或交接提示调用）
@@ -26,8 +26,8 @@ argo search --list-engines --detail                 # 逐源状态/密钥/依赖
 
 ## 二、费用与密钥：哪些白用、哪些要钱
 
-- **免费档 250 个**（含已停用）：无需密钥，或只需免费注册的密钥；其中 13 个要自备密钥（免费额度）：em_miaoxiang、keenable、qweather、searxng、tinyfish、tinyfish_news、tinyfish_paper、unpaywall、weread、wolframalpha、zhihu、zhihu_hot、zhihu_user
-- **计费档 14 个**（下表逐个列出，档位取自各源自己的 `cost_tier` 声明）
+- **免费档 257 个**（含已停用）：无需密钥，或只需免费注册的密钥；其中 13 个要自备密钥（免费额度）：em_miaoxiang、keenable、qweather、searxng、tinyfish、tinyfish_news、tinyfish_paper、unpaywall、weread、wolframalpha、zhihu、zhihu_hot、zhihu_user
+- **计费档 15 个**（下表逐个列出，档位取自各源自己的 `cost_tier` 声明）
 
 | 引擎 | 档位 | 是否进自动路由 | 需自备密钥 |
 |---|---|---|---|
@@ -38,15 +38,16 @@ argo search --list-engines --detail                 # 逐源状态/密钥/依赖
 | `brave` | 低价计费 | 是 | ARGO_BRAVE_API_KEY |
 | `byted` | 低价计费 | 是 | ARGO_BYTED_API_KEY |
 | `metaso` | 低价计费 | 是 | ARGO_METASO_API_KEY |
-| `exa` | 按调用计费 | 是 | ARGO_EXA_API_KEY |
+| `exa` | 按调用计费 | 是 | — |
 | `octen` | 按调用计费 | 是 | ARGO_OCTEN_API_KEY |
 | `parallel` | 按调用计费 | 是 | PARALLEL_API_KEY |
 | `seltz` | 按调用计费 | 是 | SELTZ_API_KEY |
 | `tavily` | 按调用计费 | 是 | ARGO_TAVILY_API_KEY |
 | `you` | 按调用计费 | 是 | YDC_API_KEY |
+| `yuanbao` | 按调用计费 | 是 | ARGO_YUANBAO_API_KEY |
 | `zhihu_global` | 按调用计费 | 是 | ARGO_ZHIHU_ACCESS_SECRET |
 
-**结论**：付费档里有 1 个进了自动路由（felo），用之前先确认额度；低价/按量计费的源有 12 个在自动路由路径上，多数带免费额度或已配密钥。额度记在本地配额表（`backends/quota_profiles.json` 的 limit / period，用量存在本机状态库），用尽后该源在语义路由里被降权；本地表统计的是 argo 自己的调用，若同一密钥还被别的工具用，实际额度以服务商侧为准。想彻底避开计费源，用 `--engine` 显式指定免费源，或走 `--mode budget`。
+**结论**：付费档里有 1 个进了自动路由（felo），用之前先确认额度；低价/按量计费的源有 13 个在自动路由路径上，多数带免费额度或已配密钥。额度记在本地配额表（`backends/quota_profiles.json` 的 limit / period，用量存在本机状态库），用尽后该源在语义路由里被降权；本地表统计的是 argo 自己的调用，若同一密钥还被别的工具用，实际额度以服务商侧为准。想彻底避开计费源，用 `--engine` 显式指定免费源，或走 `--mode budget`。
 
 ## 三、特别能力（不是普通网页搜索）
 
@@ -77,12 +78,14 @@ argo search --list-engines --detail                 # 逐源状态/密钥/依赖
 
 状态含义：**可直接用** = 自动路由会用上；**需自配密钥 / 需装后端工具** = 配好后即可用；**被上游封锁** = 源站当前拒绝；**已停用** = 配置层面关闭。
 
-### 全网搜索（35）
+### 全网搜索（38）
 
 | 引擎 | 状态 | 费用 | 频率上限 | 需自备密钥 | 什么时候用到 | 说明 |
 |---|---|---|---|---|---|---|
-| `anysearch` | 可直接用 | 免费 | 2000/天 | — | 域 ai_model、域 book_search、域 chinese_general、域 claim_check、域 code_search、域 crypto_search、域 dataset_search、域 earth_science、域 energy_grid、域 english_tech、域 financial_news、域 fund_query、域 fx_query、域 game_search、域 hackernews_search、域 image_search、域 japan_law、域 kor_law、域 law_text、域 legal、域 lifecycle_search、域 local_code、域 local_general、域 macro_data、域 medical、域 meme_slang、域 outbreak_health、域 package_intel、域 prediction_market、域 redskill_search、域 rfc_search、域 sec_filings、域 security_search、域 semantic_discovery、域 shopping、域 skill_search、域 soil_agri、域 sports_search、域 stackoverflow_search、域 stock_query、域 ths_hot_search、域 trade_stats、域 transport_rt、域 us_fundamentals、域 us_legal、域 us_stock、域 v2ex_search、域 vehicle_data、域 wechat_search、域 wenshu_query、域 world_news、域 zhihu_content、深度研究 boost、语义画像命中、通用兜底链 | 通用搜索主力，进程内 JSON-RPC（HttpClient），零 token |
+| `anysearch` | 可直接用 | 免费 | 1000/天 | — | 域 ai_model、域 book_search、域 chinese_general、域 claim_check、域 code_search、域 crypto_search、域 dataset_search、域 earth_science、域 energy_grid、域 english_tech、域 financial_news、域 fund_query、域 futures_market、域 fx_query、域 game_search、域 hackernews_search、域 hk_filings、域 image_search、域 japan_law、域 kor_law、域 law_text、域 legal、域 lifecycle_search、域 local_code、域 local_general、域 macro_data、域 medical、域 meme_slang、域 outbreak_health、域 package_intel、域 prediction_market、域 redskill_search、域 rfc_search、域 sec_filings、域 security_search、域 semantic_discovery、域 shopping、域 skill_search、域 soil_agri、域 sports_search、域 stackoverflow_search、域 stock_query、域 ths_hot_search、域 trade_stats、域 transport_rt、域 us_fundamentals、域 us_legal、域 us_stock、域 v2ex_search、域 vehicle_data、域 wechat_search、域 wenshu_query、域 world_news、域 zhihu_content、深度研究 boost、语义画像命中、通用兜底链 | 通用搜索主力，进程内 JSON-RPC（HttpClient），零 token |
+| `exa` | 可直接用 | 按调用计费 | 1000/月 | — | 域 english_tech、域 semantic_discovery、域 us_stock、深度研究 boost | Exa 语义搜索（embedding 匹配 + 内容摘要，新户 $20 赠金 + 每月 $10 赠金） |
 | `firecrawl` | 可直接用 | 免费 | 1000/月 | — | 域 semantic_discovery、通用兜底链 | Firecrawl 云搜索（search+全文markdown，JS渲染/学术/PDF垂直，keyless 免费层 1000 credits/月） |
+| `keenable_free` | 可直接用 | 免费 | 不限 | — | 通用兜底链 | Keenable 官方免 key 匿名通道（通用网页搜索，无需注册） |
 | `lieu` | 可直接用 | 免费 | 不限 | — | 域 semantic_discovery、语义画像命中 | webring 专用搜索（只索引加入 webring 的小众站点，HTML 解析） |
 | `local_baidu` | 可直接用 | 免费 | 不限 | — | 语义画像命中、通用兜底链 | 百度本地 |
 | `local_bing` | 可直接用 | 免费 | 不限 | — | 深度研究 boost、通用兜底链 | Bing本地 |
@@ -94,17 +97,17 @@ argo search --list-engines --detail                 # 逐源状态/密钥/依赖
 | `shenma` | 可直接用 | 免费 | 不限 | — | 域 chinese_general | 神马搜索（m.sm.cn/s 移动端 HTML 解析），中文通用网页 |
 | `so` | 可直接用 | 免费 | 不限 | — | 域 chinese_general | 360 搜索（so.com/s HTML 解析），中文通用网页 |
 | `sogou_weixin_browser` | 可直接用 | 免费 | 不限 | — | 域 wechat_search | 搜狗微信搜索·浏览器兜底通道（ego-browser 真实会话，HTTP 车道被反爬时保底；中间链会话内解析为微信真实链接） |
+| `tavily_free` | 可直接用 | 免费 | 不限 | — | 通用兜底链 | Tavily 官方免 key 匿名通道（通用网页搜索，无需注册） |
 | `uapi` | 可直接用 | 免费 | 不限 | — | 域 semantic_discovery、语义画像命中、通用兜底链 | UAPI 聚合搜索 |
 | `wechat_sogou` | 可直接用 | 免费 | 不限 | — | 域 chinese_general、域 wechat_search | 搜狗微信搜索引擎（公众号文章，免登录，中间链自动解析为微信真实链接可引用；fast 跳过解析） |
 | `wiby` | 可直接用 | 免费 | 不限 | — | 域 semantic_discovery、语义画像命中 | Wiby 老式手工网页索引（专收非商业化页面，JSON 免认证） |
 | `bing_rss` | 显式专用 | 免费 | 不限 | — | 显式调用（--engine） | Bing 网页搜索 RSS 出口（免 key 免 HTML 解析；local_bing 改版/风控时的稳定备胎） |
-| `bocha` | 需自备密钥 | 低价计费 | 10000/月 | ARGO_BOCHA_API_KEY | 域 chinese_general、域 local_chinese、域 modal_card、语义画像命中 | 博查搜索 API（中文，freshness 按查询时效动态化） |
+| `bocha` | 需自备密钥 | 低价计费 | 不限 | ARGO_BOCHA_API_KEY | 域 chinese_general、域 local_chinese、域 modal_card、语义画像命中 | 博查搜索 API（中文，freshness 按查询时效动态化） |
 | `brave` | 已停用 | 低价计费 | 不限 | ARGO_BRAVE_API_KEY | 域 semantic_discovery | Brave Search API |
 | `byted` | 需自备密钥 | 低价计费 | 不限 | ARGO_BYTED_API_KEY | 域 chinese_general、域 chinese_tech_deep、域 fact_check、域 financial_news、域 legal、域 local_news、域 news_realtime、域 weather_query、语义画像命中 | 字节搜索 API，中文通用/news |
 | `deepseek_search` | 需自备密钥 + 显式专用 | 付费 | 不限 | DEEPSEEK_API_KEY | 显式调用（--engine） | DeepSeek Search |
 | `digup` | 已停用 | 免费 | 不限 | — | 已停用 | DigUp（EmbeddingGemma 2 本地多模态嵌入，全程离线）——照片/截图/PDF/文档/音视频按内容检索 |
 | `ecosia` | 显式专用 | 免费 | 不限 | — | 显式调用（--engine） | Ecosia（ecosia.org HTML 解析），环保隐私取向通用网页 |
-| `exa` | 需自备密钥 | 按调用计费 | 1000/月 | ARGO_EXA_API_KEY | 域 english_tech、域 semantic_discovery、域 us_stock、深度研究 boost | Exa 语义搜索（embedding 匹配 + 内容摘要，新户 $20 赠金 + 每月 $10 赠金） |
 | `felo` | 已停用 | 付费 | 不限 | ARGO_FELO_API_KEY | 域 semantic_discovery、语义画像命中 | Felo AI 搜索 API |
 | `keenable` | 需自备密钥 | 免费 | 不限 | ARGO_KEENABLE_API_KEY | 域 english_tech | Keenable 通用网页搜索（ranked results，含 published_at，按 credits 计费） |
 | `metaso` | 已停用 | 低价计费 | 不限 | ARGO_METASO_API_KEY | 域 chinese_general | 秘塔搜索 API（中文 AI 搜索） |
@@ -112,9 +115,10 @@ argo search --list-engines --detail                 # 逐源状态/密钥/依赖
 | `parallel` | 需自备密钥 | 按调用计费 | 不限 | PARALLEL_API_KEY | 域 chinese_tech_deep | Parallel AI 批量搜索（excerpts 长文摘录，结果自带正文省 fetch） |
 | `qwant` | 显式专用 | 免费 | 不限 | — | 显式调用（--engine） | Qwant（qwant.com HTML 解析），欧盟 GDPR 合规通用网页 |
 | `searxng` | 已停用 | 免费 | 不限 | ARGO_SEARXNG_URL | 域 semantic_discovery | SearXNG 直连（已废弃，由 T3 替代） |
-| `tavily` | 需自备密钥 | 按调用计费 | 1000/月 | ARGO_TAVILY_API_KEY | 域 semantic_discovery、语义画像命中 | Tavily AI 搜索 API（免费层 1000 次/月，按 credit 计费；与 exa 同为 api 档） |
+| `tavily` | 需自备密钥 | 按调用计费 | 1000/月 | ARGO_TAVILY_API_KEY | 域 semantic_discovery、语义画像命中 | Tavily AI 搜索 API（免费层 1000 次/月，超出按美元计费；与 exa 同为 api 档） |
 | `tinyfish` | 需自备密钥 + 显式专用 | 免费 | 不限 | ARGO_TINYFISH_API_KEY | 显式调用（--engine） | TinyFish 实时网页搜索（免费，浏览器渲染，结果含原文摘要，X-API-Key 认证） |
 | `you` | 需自备密钥 | 按调用计费 | 不限 | YDC_API_KEY | 域 news_realtime | You.com 网页+新闻搜索（时效性强，官方一手源，web/news 合并） |
+| `yuanbao` | 需自备密钥 | 按调用计费 | 2000/月 | ARGO_YUANBAO_API_KEY | 域 chinese_general、域 company_search | 腾讯元宝搜索 |
 | `zhihu_global` | 需自备密钥 | 按调用计费 | 5000/天 | ARGO_ZHIHU_ACCESS_SECRET | 域 chinese_general、域 news_realtime、域 zhihu_content | 知乎开放平台全网搜索（SearchDB=all 全网索引 + Filter host== 站点限定；需 ZHIHU_ACCESS_SECRET） |
 
 ### 学术文献（27）
@@ -207,13 +211,14 @@ argo search --list-engines --detail                 # 逐源状态/密钥/依赖
 | `local_goodreads` | 已停用 | 免费 | 不限 | — | 域 book_search | Goodreads本地 |
 | `weread` | 需自备密钥 | 免费 | 不限 | ARGO_WEREAD_API_KEY | 域 book_search | 微信读书图书搜索（中文书目/评分/在读，需 WEREAD_API_KEY） |
 
-### 百科 / 实体（18）
+### 百科 / 实体（19）
 
 | 引擎 | 状态 | 费用 | 频率上限 | 需自备密钥 | 什么时候用到 | 说明 |
 |---|---|---|---|---|---|---|
 | `baidu_baike` | 可直接用 | 免费 | 不限 | — | 域 cn_encyclopedia、域 company_search、域 entity_search、域 org_entity | 百度百科词条（suggest + OpenAPI 卡片，免认证） |
 | `dnb` | 可直接用 | 免费 | 不限 | — | 域 book_search、语义画像命中 | 德语出版物最全书目（SRU/RDF XML） |
 | `free_dictionary` | 可直接用 | 免费 | 不限 | — | 域 dictionary_search、语义画像命中 | dictionaryapi.dev 英英词典（免认证，响应为数组） |
+| `gleif` | 可直接用 | 免费 | 不限 | — | 域 company_search、域 org_entity | GLEIF 全球法人 LEI 注册库（法定名称/注册地/状态/母公司，免 key） |
 | `local_wikipedia` | 可直接用 | 免费 | 不限 | — | 经 local_search 展开 | Wikipedia本地 |
 | `local_wikiquote` | 可直接用 | 免费 | 不限 | — | 经 local_search 展开 | Wikiquote本地 |
 | `local_wiktionary` | 可直接用 | 免费 | 不限 | — | 经 local_search 展开 | Wiktionary本地 |
@@ -246,7 +251,7 @@ argo search --list-engines --detail                 # 逐源状态/密钥/依赖
 | `v2ex` | 可直接用 | 免费 | 不限 | — | 域 cn_tech_community、域 social、域 v2ex_search | V2EX（中文技术社区，官方 API 候选池 + 本地相关性过滤） |
 | `weibo` | 可直接用 | 免费 | 不限 | — | 域 social、语义画像命中 | 微博 |
 | `reddit` | 需装后端工具 | 免费 | 不限 | — | 域 social、语义画像命中 | Reddit |
-| `twitter` | 需装后端工具 | 免费 | 不限 | — | 域 social、语义画像命中 | Twitter/X |
+| `twitter` | 需装后端工具 | 免费 | 不限 | — | 域 social、语义画像命中 | X/Twitter 关键词搜索（ego-browser 通道，原生布尔语法 from:/-is:retweet/lang:） |
 | `twitter_syndication` | 显式专用 | 免费 | 不限 | — | 显式调用（--engine） | X/Twitter 单条推文（syndication 通道，免登录零 key，含正文/作者/时间/媒体计数） |
 | `xiaohongshu` | 需装后端工具 | 免费 | 不限 | — | 域 social、语义画像命中 | 小红书 |
 | `zhihu` | 需自备密钥 | 免费 | 5000/天 | ARGO_ZHIHU_ACCESS_SECRET | 域 shopping、域 social、域 zhihu_content、域 zhihu_hot_list、语义画像命中 | 知乎搜索，中文观点/评测 |
@@ -271,6 +276,26 @@ argo search --list-engines --detail                 # 逐源状态/密钥/依赖
 | `pypi` | 可直接用 | 免费 | 不限 | — | 域 package_search | PyPI 包查询（/pypi/{name}/json 精确解析，免认证） |
 | `stackoverflow` | 可直接用 | 免费 | 300/天 | — | 域 stackoverflow_search、域 web_docs | Stack Overflow（Stack Exchange API，编程问答） |
 
+### 行情 / 资金（15）
+
+| 引擎 | 状态 | 费用 | 频率上限 | 需自备密钥 | 什么时候用到 | 说明 |
+|---|---|---|---|---|---|---|
+| `cninfo` | 可直接用 | 免费 | 不限 | — | 域 company_search、域 financial_news | 巨潮资讯网官方公告（A股公告第一官方源，免认证） |
+| `defillama` | 可直接用 | 免费 | 不限 | — | 域 crypto_search | DeFiLlama 协议 TVL（8700+ 协议资金规模/24h 与 7d 变化，免 key） |
+| `eastmoney` | 可直接用 | 免费 | 不限 | — | 域 financial_news、域 fund_query、域 fx_query、域 stock_query、域 us_stock、语义画像命中 | 东方财富，金融数据首选 |
+| `em_flow` | 可直接用 | 免费 | 不限 | — | 域 stock_query | 东财资金流向（个股主力/北向/板块，push2.eastmoney.com 免认证） |
+| `finviz` | 可直接用 | 免费 | 不限 | — | 域 us_stock | Finviz 美股快照（HTML，免认证） |
+| `frankfurter` | 可直接用 | 免费 | 不限 | — | 域 fx_query、域 macro_data | Frankfurter ECB 官方参考汇率（免认证，2026-10-06 接入） |
+| `hkex` | 可直接用 | 免费 | 不限 | — | 域 hk_filings | 港交所披露易公告检索（港股一手公告 PDF，代码/公司名/标题关键词，免 key） |
+| `sec_companyfacts` | 可直接用 | 免费 | 不限 | — | 域 us_fundamentals | SEC XBRL companyfacts 年度结构化财务（营收/净利/资产/EPS，免认证） |
+| `sec_edgar` | 可直接用 | 免费 | 不限 | — | 域 sec_filings | SEC EDGAR 美国证监会官方全文检索（公司/财报/申报，免认证） |
+| `seeking_alpha` | 可直接用 | 免费 | 不限 | — | 域 us_stock | Seeking Alpha 美股分析（HTML，反爬较强） |
+| `shfe` | 可直接用 | 免费 | 不限 | — | 域 futures_market | 上海期货交易所日行情（铜/铝/黄金/螺纹钢等品种，官方一手，免 key） |
+| `sina_quote` | 可直接用 | 免费 | 不限 | — | 域 stock_query | 新浪实时行情快照（现价/涨跌/成交量，免认证） |
+| `tencent_kline` | 可直接用 | 免费 | 不限 | — | 域 us_stock、语义画像命中 | 腾讯财经前复权日 K 线（A股+港股+美股） |
+| `tencent_quote` | 可直接用 | 免费 | 不限 | — | 域 stock_query | 腾讯实时行情（qt.gtimg.cn 免认证，含换手率/市盈率/五档） |
+| `yahoo_finance` | 可直接用 | 免费 | 不限 | — | 域 us_stock | Yahoo Finance 美股代码解析+实时行情（search/chart 免认证，2026-10-06 接入） |
+
 ### 本地新闻流（14）
 
 | 引擎 | 状态 | 费用 | 频率上限 | 需自备密钥 | 什么时候用到 | 说明 |
@@ -325,23 +350,6 @@ argo search --list-engines --detail                 # 逐源状态/密钥/依赖
 | `x_trending` | 显式专用 | 免费 | 不限 | — | 显式调用（--engine） | X (Twitter) Trending 全球热榜（ego-browser 浏览器通道，带分类与排名；显式调用） |
 | `zhihu_hot` | 需自备密钥 | 免费 | 100/天 | ARGO_ZHIHU_ACCESS_SECRET | 域 hot_trending、域 zhihu_hot_list | 知乎开放平台热榜 hot_list（日配额约 100；需 ZHIHU_ACCESS_SECRET；原 zhihu skill 迁入） |
 
-### 行情 / 资金（12）
-
-| 引擎 | 状态 | 费用 | 频率上限 | 需自备密钥 | 什么时候用到 | 说明 |
-|---|---|---|---|---|---|---|
-| `cninfo` | 可直接用 | 免费 | 不限 | — | 域 company_search、域 financial_news | 巨潮资讯网官方公告（A股公告第一官方源，免认证） |
-| `eastmoney` | 可直接用 | 免费 | 不限 | — | 域 financial_news、域 fund_query、域 fx_query、域 stock_query、域 us_stock、语义画像命中 | 东方财富，金融数据首选 |
-| `em_flow` | 可直接用 | 免费 | 不限 | — | 域 stock_query | 东财资金流向（个股主力/北向/板块，push2.eastmoney.com 免认证） |
-| `finviz` | 可直接用 | 免费 | 不限 | — | 域 us_stock | Finviz 美股快照（HTML，免认证） |
-| `frankfurter` | 可直接用 | 免费 | 不限 | — | 域 fx_query、域 macro_data | Frankfurter ECB 官方参考汇率（免认证，2026-10-06 接入） |
-| `sec_companyfacts` | 可直接用 | 免费 | 不限 | — | 域 us_fundamentals | SEC XBRL companyfacts 年度结构化财务（营收/净利/资产/EPS，免认证） |
-| `sec_edgar` | 可直接用 | 免费 | 不限 | — | 域 sec_filings | SEC EDGAR 美国证监会官方全文检索（公司/财报/申报，免认证） |
-| `seeking_alpha` | 可直接用 | 免费 | 不限 | — | 域 us_stock | Seeking Alpha 美股分析（HTML，反爬较强） |
-| `sina_quote` | 可直接用 | 免费 | 不限 | — | 域 stock_query | 新浪实时行情快照（现价/涨跌/成交量，免认证） |
-| `tencent_kline` | 可直接用 | 免费 | 不限 | — | 域 us_stock、语义画像命中 | 腾讯财经前复权日 K 线（A股+港股+美股） |
-| `tencent_quote` | 可直接用 | 免费 | 不限 | — | 域 stock_query | 腾讯实时行情（qt.gtimg.cn 免认证，含换手率/市盈率/五档） |
-| `yahoo_finance` | 可直接用 | 免费 | 不限 | — | 域 us_stock | Yahoo Finance 美股代码解析+实时行情（search/chart 免认证，2026-10-06 接入） |
-
 ### 法律判例（11）
 
 | 引擎 | 状态 | 费用 | 频率上限 | 需自备密钥 | 什么时候用到 | 说明 |
@@ -387,10 +395,11 @@ argo search --list-engines --detail                 # 逐源状态/密钥/依赖
 | `who_gho` | 可直接用 | 免费 | 不限 | — | 域 medical、域 outbreak_health | WHO GHO 全球卫生指标（世卫官方统计目录，免认证） |
 | `worms` | 可直接用 | 免费 | 不限 | — | 域 species_search | WoRMS 海洋物种权威命名（分类学标准，免认证） |
 
-### 宏观数据（6）
+### 宏观数据（7）
 
 | 引擎 | 状态 | 费用 | 频率上限 | 需自备密钥 | 什么时候用到 | 说明 |
 |---|---|---|---|---|---|---|
+| `cfets` | 可直接用 | 免费 | 不限 | — | 域 fx_query | 中国外汇交易中心人民币中间价（25 个币种，官方授权口径，免 key） |
 | `eurostat` | 可直接用 | 免费 | 不限 | — | 域 macro_data | 欧盟统计局宏观数据（EU 国家 GDP/人均GDP/失业率/人口，ec.europa.eu SDMX 免认证） |
 | `fred` | 可直接用 | 免费 | 不限 | — | 域 macro_data | FRED 宏观时序数据（CPI/失业率/国债收益率/GDP/M2，免认证） |
 | `fx_rate` | 可直接用 | 免费 | 不限 | — | 域 fx_query、域 macro_data | 实时汇率（open.er-api.com 免认证） |
@@ -413,7 +422,7 @@ argo search --list-engines --detail                 # 逐源状态/密钥/依赖
 |---|---|---|---|---|---|---|
 | `open_meteo` | 可直接用 | 免费 | 不限 | — | 域 weather_query、语义画像命中 | 全球天气（城市/地名 → 坐标 → 当前天气，免认证） |
 | `opensky` | 可直接用 | 免费 | 不限 | — | 域 transport_rt、语义画像命中 | 全球 ADS-B 实时航班（主要都会区 bbox，免 key） |
-| `bocha_ai` | 需自备密钥 | 低价计费 | 10000/月 | ARGO_BOCHA_API_KEY | 域 modal_card | 博查 AI 搜索（ai-search 端点网页结果直连） |
+| `bocha_ai` | 需自备密钥 | 低价计费 | 不限 | ARGO_BOCHA_API_KEY | 域 modal_card | 博查 AI 搜索（ai-search 端点网页结果直连） |
 | `wolframalpha` | 已停用 | 免费 | 不限 | ARGO_WOLFRAM_APPID | 域 fact_check | WolframAlpha 计算知识引擎 |
 
 ### 化学 / 药学（3）
@@ -453,7 +462,7 @@ argo search --list-engines --detail                 # 逐源状态/密钥/依赖
 
 ## 六、分发域清单（自动生成）
 
-共 95 个业务域；命中即按域内的组合取源（多意图时按配置顺序取，窄意图域排在宽泛域之前）。自己看某个域为什么选这些源，看 `config.yaml` 的 `domains` 段。
+共 97 个业务域；命中即按域内的组合取源（多意图时按配置顺序取，窄意图域排在宽泛域之前）。自己看某个域为什么选这些源，看 `config.yaml` 的 `domains` 段。
 
 | 域 | 主源 | 组合 |
 |---|---|---|
@@ -469,10 +478,12 @@ argo search --list-engines --detail                 # 逐源状态/密钥/依赖
 | `em_news_search` | `em_global_news` | `em_global_news`、`cls_telegraph` |
 | `fund_query` | `eastmoney` | `eastmoney`、`anysearch` |
 | `sec_filings` | `sec_edgar` | `sec_edgar`、`anysearch` |
+| `hk_filings` | `hkex` | `hkex`、`anysearch` |
+| `futures_market` | `shfe` | `shfe`、`anysearch` |
 | `us_fundamentals` | `sec_companyfacts` | `sec_companyfacts`、`anysearch` |
 | `us_stock` | `finviz` | `finviz`、`exa`、`yahoo_finance`、`seeking_alpha`、`anysearch`、`eastmoney`、`tencent_kline` |
 | `stock_query` | `sina_quote` | `sina_quote`、`tencent_quote`、`em_flow`、`eastmoney`、`anysearch` |
-| `fx_query` | `fx_rate` | `fx_rate`、`eastmoney`、`frankfurter`、`anysearch` |
+| `fx_query` | `fx_rate` | `fx_rate`、`cfets`、`eastmoney`、`frankfurter`、`anysearch` |
 | `macro_data` | `fred` | `fred`、`worldbank`、`nbs_stats`、`eurostat`、`fx_rate`、`frankfurter`、`anysearch` |
 | `chem_search` | `pubchem` | `pubchem`、`openalex` |
 | `species_search` | `gbif` | `gbif`、`iplant`、`wikipedia`、`obis`、`worms` |
@@ -503,7 +514,7 @@ argo search --list-engines --detail                 # 逐源状态/密钥/依赖
 | `zhihu_hot_list` | `zhihu_hot` | `zhihu_hot`、`zhihu` |
 | `hot_trending` | `baidu_hot` | `baidu_hot`、`toutiao_hot`、`bilibili_hot`、`weibo_hot`、`douyin_hot`、`ths_hot`、`zhihu_hot`、`zhihu_hot_app` |
 | `patent_search` | `google_patents` | `google_patents`、`semantic_scholar`、`local_arxiv` |
-| `crypto_search` | `coingecko` | `coingecko`、`anysearch` |
+| `crypto_search` | `coingecko` | `coingecko`、`defillama`、`anysearch` |
 | `package_search` | `pypi` | `pypi`、`npm`、`crates`、`docker_hub`、`github` |
 | `web_docs` | `mdn` | `mdn`、`stackoverflow` |
 | `ml_models` | `huggingface` | `huggingface`、`github` |
@@ -543,8 +554,8 @@ argo search --list-engines --detail                 # 逐源状态/密钥/依赖
 | `news_realtime` | `byted` | `byted`、`zhihu_global`、`people_daily`、`google_news`、`octen`、`you`、`realtime_index` |
 | `chinese_tech_deep` | `byted` | `byted`、`octen`、`juejin`、`cn_ai_news`、`parallel` |
 | `english_tech` | `octen` | `octen`、`anysearch`、`exa`、`keenable` |
-| `company_search` | `opencorporates` | `opencorporates`、`cninfo`、`baidu_baike` |
-| `chinese_general` | `bocha` | `bocha`、`byted`、`anysearch`、`octen`、`zhihu_global`、`wechat_sogou`、`local_search`、`so`、`shenma`、`metaso` |
+| `company_search` | `opencorporates` | `yuanbao`、`gleif`、`opencorporates`、`cninfo`、`baidu_baike` |
+| `chinese_general` | `bocha` | `bocha`、`yuanbao`、`byted`、`octen`、`anysearch`、`zhihu_global`、`wechat_sogou`、`local_search`、`so`、`shenma`、`metaso` |
 | `local_chinese` | `local_search` | `local_search`、`bocha` |
 | `local_news` | `local_search` | `local_search`、`byted` |
 | `local_code` | `local_search` | `local_search`、`github`、`anysearch` |
@@ -556,7 +567,7 @@ argo search --list-engines --detail                 # 逐源状态/密钥/依赖
 ## 七、怎么自己查当前状态
 
 ```bash
-argo search --list-engines --detail | python3 -m json.tool | less   # 全部 264 个源的详情
+argo search --list-engines --detail | python3 -m json.tool | less   # 全部 272 个源的详情
 argo search --list-engines --detail --routable-only              # 只看现在能用的
 python3 scripts/matrix_search_eval.py --offline                   # 可达性门：有没有死源
 python3 scripts/engine_validate.py --engine <名> --stage all       # 单个源的健康+质量双阶段体检

package/docs/MCP_SETUP.md

@@ -103,4 +103,6 @@ argo mcp undo --all    # 精确移除 entry；无 entry 从备份回滚
 - [x] 无 entry undo：从备份回滚。
 - [x] `atomic_write` 0600 权限。
 - [x] `--dry-run` 不写盘。
-- [x] 单测 `tests/test_mcp_setup.py`（12 例）全过。
+- [x] 单测 `tests/test_mcp_setup.py`（15 例）全过。
+- [x] 客户端矩阵补全：Claude Code、Claude Desktop、Cursor、Windsurf、Codex、Zed、Roo Code、Cline、OpenCode、WorkBuddy。
+- [x] 跨平台声明支持：针对 macOS / Windows / Linux 支持 `config_path_*` 与 `detect_*` 平台适配。

package/docs/RELEASE_NOTES_v2.9.8.md

@@ -0,0 +1,73 @@
+# Argo v2.9.8 发布说明
+
+**版本**：2.9.8
+**定位**：路由精度审计与反馈闭环。把 v2.9.7 以来积累的分发、质量、重构改动一并收进本版，并集中修掉 issue #18 / #19 暴露的路由与夜间任务问题。
+
+**致谢**：感谢 [@wpp666](https://github.com/wpp666)（王平）在 issue #18 提供的复现环境、查询样本和期望对照。这个 issue 把「有结果但答非所问」的链路讲得很清楚，本版沿着它扩展成了更广泛的路由精度审计。
+
+---
+
+## 这次更新有什么（通俗版）
+
+### 1. issue #18 的三件事都已复现并修掉
+
+**以前**：
+
+- 查询里出现 `latest` 就被判进实时新闻域，软件版本查询也会走新闻源
+- 人民网的模糊搜索匹配不到时，返回整页最新 feed，形态正常但内容无关
+- `local_bing` 对「2026年新能源汽车销量数据」只命中「2026」，五条结果全是年表、节假日
+- `cross_validation` 对中文查询恒报 `0/N 相关`，这个信号本身不可信
+
+**现在**：
+
+- `latest` 只有在 `latest news / on / about / in` 等明确新闻搭配下才触发实时新闻
+- 人民网默认 feed、SERP 缓存页按 query token 覆盖率识别为「答非所问」，整页丢弃并触发恢复链
+- `local_bing` 的年份表垃圾页同样被覆盖率门拦下，返回诚实空结果，不再伪装成成功
+- `cross_validation` 改用 CJK 二元组覆盖率，真实中文查询能正确报出相关条数
+
+### 2. 顺着同一类问题，审计并收窄了 16 类误触发
+
+用真实查询回放 + 97 个域规则自检，找到的不是一条查询，而是一批同构问题：
+
+- **CJK 构词成分**：品牌名里的「雪」被当天气、产品名里的「火山」被当地理、UI 排障里的「图标」被当找图、图书馆语境里的「馆藏」被当博物馆、电动车里的「动车」被当车票
+- **ASCII 子串**：`F1` 命中 `off10/off11`，`Go` 命中 `argo`，`Java` 命中 `JavaScript`
+- **跨域同形**：统一社会信用代码/基金代码/商品代码被当代码搜索；代码库语境里的「汇率」被当实时牌价；裸「漏洞」没有域接
+- **域缺口**：「降准」没进财经新闻、工商字段没让位给 `company_search`、中国宏观查询让 FRED 领队返回了美国 GDP
+
+修法的共同点是**保留真查询、只排除撞车说法**：每条收窄都配一条误判反例和一条真查询对照，避免把域改废。
+
+### 3. issue #19：nightly 账本不再因为空日志失败
+
+**以前**：全新 runner 没有使用日志，`argo stats` 只返回 `{"samples": 0}`，夜间账本直接读 `avg_elapsed_ms` 就 `KeyError`。
+
+**现在**：`argo stats` 空日志也返回稳定字段形状，指标用 `None` 表示「没有样本」；夜间工作流按 `samples` 判断，没有样本就不喂 benchmark，不画 0ms 假曲线。
+
+### 4. v2.9.7 以来的其他改动也一并收进本版
+
+- **分发**：打通 PyPI/uvx 标准分发与 MCP 客户端矩阵；npm 包瘦身与自愈提示；Release 资产构建与 Windows 镜像回退
+- **质量**：内容农场过滤真正接线；跨语言长程溯源；BM25+ 与短语邻近度加权；本地工程意图与文件名精准度
+- **重构**：搜索主管线恢复执行器拆出、MCP 压缩/本地沙箱/预热模块化、DSH 插件 wide_research 与执行器连接池拆模块
+- **DSH 插件**：运行监控看板、快速预设、配置即时搜索过滤
+- **路由**：修三处域冲突；补 53 个零用例域的路由用例，并加「每域至少一条路由用例」门禁
+
+---
+
+## 验证
+
+- 全量 `python3 -m pytest -q` 退出码 0
+- 路由精度、域规则 schema、路由快照、矩阵覆盖、macro/fx 专项全部通过
+- 单飞用例连跑 50 次无偶发失败
+- 夜间账本用空日志和真实日志分别模拟：空数据 `samples=0, bench=[]`，真实数据正常产出指标
+- 真实查询复验：issue #18 的两条查询都从「答非所问」回到相关结果；`央行 降准 最新` 从维基实体回到财经新闻；`国家统计局 一季度 GDP` 从 FRED 美国 GDP 回到 worldbank 中国 GDP
+- 路由本身没有变慢：200 条查询平均 1.8ms
+
+## 兼容性
+
+- 无破坏性变更，v2.9.7 的配置与用法继续有效
+- 仓库版本号、五语 README、DSH 插件对照表、hero 图标统一到 2.9.8
+- 测试态隔离只影响测试：adaptive 与熔断状态按用例使用独立临时库，不再跨用例串味
+
+## 相关 issue
+
+- [#18](https://github.com/taxueseek/argo/issues/18)：auto 路由 latest 误判、people_daily 默认 feed、local_bing 只命中 2026
+- [#19](https://github.com/taxueseek/argo/issues/19)：nightly 失败 2026-10-22

package/engines/specs/cfets.yaml

@@ -0,0 +1,41 @@
+# 中国外汇交易中心（CFETS）人民币中间价（免 key）
+#
+# 补的盲区：**在岸人民币官方价**。现有汇率源都是离岸/聚合口径：
+# frankfurter 是 ECB 参考价、fx_rate 是 open.er-api 聚合价，都不是
+# 人民银行授权的中间价。CFETS 是每个交易日 9:15 公布的官方中间价，
+# 也是跨境结算与合同计价的口径来源。
+#
+# 端点语义（2026-10-21 实测）：按货币对 + 日期区间查历史，不支持自由文本。
+#   GET /ags/ms/cm-u-bk-ccpr/CcprHisNew?currency=USD/CNY&startDate=…&endDate=…
+#   → records[].date + values[]（values[0] 即该货币对中间价）
+# 币种覆盖 25 个（USD/EUR/100JPY/HKD/GBP/AUD/NZD/SGD/CHF/CAD/CNY-MOP…
+# CNY-MYR/RUB/ZAR/KRW/AED/SAR/HUF/PLN/DKK/SEK/NOK/TRY/MXN/THB）。
+# builder 负责把「美元」「日元」「USD/CNY」这类查询词解析成货币对；
+# 只说「人民币中间价」时按美元对（市场最常用口径）。
+#
+# 验证:
+#   python3 scripts/engine_validate.py --engine cfets --stage health --admit
+#   argo search "美元 人民币 中间价" --engine cfets --json
+
+engine_id: cfets
+type: cfets
+enabled: true
+cost_tier: free
+label: 人民币中间价
+family: finance_macro
+priority: 51
+qps: 2
+period: second
+cost_per_call: 0.0
+cost_unit: free
+recommended: false
+
+timeout: 15
+canary_query: 美元 人民币 中间价
+desc: "中国外汇交易中心人民币中间价（25 个币种，官方授权口径，免 key）"
+coverage: [finance, macro, china, official, realtime]
+
+quality_queries:
+  - query: 美元 人民币 中间价
+  - query: 日元 人民币 中间价
+  - query: CNY HKD mid rate

package/engines/specs/defillama.yaml

@@ -0,0 +1,38 @@
+# DeFiLlama 协议 TVL（免 key）
+#
+# 补的盲区：**链上资金规模**。现有 crypto 源只有 CoinGecko（币价/市值），
+# 没有「协议里锁了多少钱」这个口径。DeFiLlama 是 DeFi TVL 的事实标准，
+# 免 key、免注册，覆盖 8700+ 协议与 300+ 链。
+#
+# 端点语义（2026-10-21 实测）：单次返回全量协议列表（约 9 MB / 2.4s），
+# 不支持关键词查询，builder 本地过滤（名称/代号/类别/链）并按 TVL 排序。
+# 全量结果进程内缓存 5 分钟，连续查询不重复下载。
+#   GET /protocols → [{name, symbol, category, chain, chains, tvl,
+#                      change_1d, change_7d, slug, url, description}]
+#
+# 验证:
+#   python3 scripts/engine_validate.py --engine defillama --stage health --admit
+#   argo search "aave tvl" --engine defillama --json
+
+engine_id: defillama
+type: defillama
+enabled: true
+cost_tier: free
+label: DeFiLlama
+family: finance_market
+priority: 45
+qps: 1
+period: second
+cost_per_call: 0.0
+cost_unit: free
+recommended: false
+
+timeout: 30
+canary_query: aave
+desc: "DeFiLlama 协议 TVL（8700+ 协议资金规模/24h 与 7d 变化，免 key）"
+coverage: [crypto, finance, blockchain, defi]
+
+quality_queries:
+  - query: aave tvl
+  - query: uniswap 锁仓
+  - query: Lido 质押 规模

package/engines/specs/firecrawl.yaml

@@ -31,7 +31,7 @@ qps: 1
 period: month
 limit: 1000
 cost_per_call: 0.001
-cost_unit: credit
+cost_unit: usd
 
 # 可选密钥（OPTIONAL_ENV_ENGINES）：未配置时不发送 Authorization（keyless 直连免费层）
 headers:

package/engines/specs/fxtwitter.yaml

@@ -6,6 +6,11 @@
 
 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

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/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/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/shfe.yaml

@@ -0,0 +1,39 @@
+# 上海期货交易所（SHFE）日行情（免 key）
+#
+# 补的盲区：**商品期货此前零源**。现有 finance 源覆盖 A/美/港股票、基金、
+# 债券、汇率，唯独没有商品——「铜价」「螺纹钢主力」「黄金期货」这类问题
+# 只能落到网页搜索，拿二手解读。SHFE 是官方一手日行情。
+#
+# 端点语义（2026-10-21 实测）：按交易日全量文件，不支持关键词查询，
+# 所以按「品种」本地过滤（铜/铝/锌/铅/镍/锡/黄金/白银/螺纹钢/热卷/原油等）。
+#   GET /data/tradedata/future/dailydata/kxYYYYMMDD.dat
+#   → o_curinstrument[]：PRODUCTNAME/PRODUCTGROUPID/DELIVERYMONTH/
+#     CLOSEPRICE/SETTLEMENTPRICE/VOLUME/OPENINTEREST
+# 周末与节假日文件不存在，builder 会自动往前找最近一个交易日（最多 12 天）。
+#
+# 验证:
+#   python3 scripts/engine_validate.py --engine shfe --stage health --admit
+#   argo search "沪铜主力" --engine shfe --json
+
+engine_id: shfe
+type: shfe
+enabled: true
+cost_tier: free
+label: 上期所行情
+family: finance_market
+priority: 52
+qps: 2
+period: second
+cost_per_call: 0.0
+cost_unit: free
+recommended: false
+
+timeout: 20
+canary_query: 铜
+desc: "上海期货交易所日行情（铜/铝/黄金/螺纹钢等品种，官方一手，免 key）"
+coverage: [finance, futures, commodity, china, official]
+
+quality_queries:
+  - query: 沪铜主力
+  - query: 螺纹钢 期货
+  - query: 黄金 期货 收盘

package/engines/specs/stackexchange.yaml

@@ -23,8 +23,8 @@ priority: 45
 qps: 1
 period: day
 limit: 300
-cost_per_call: 1.0
-cost_unit: request
+cost_per_call: 0.0
+cost_unit: usd
 method: GET
 url: https://api.stackexchange.com/2.3/search/advanced
 timeout: 12