argo-search 1.0.1 → 2.9.8

package/engines/specs/nasa_images.yaml

@@ -0,0 +1,45 @@
+# NASA Image and Video Library — 公开航天图像/视频（免认证）
+# 补 earth_science 域的图像素材维度：nasa_cmr 是数据集目录、usgs 是地震目录，
+# 都给不了可看的图。匿名约 30 req/h，无官方契约，qps 从紧。
+# 验证:
+#   python3 scripts/engine_validate.py --engine nasa_images --stage all --admit --write-doc
+
+engine_id: nasa_images
+type: http
+enabled: true
+cost_tier: free
+method: GET
+url: https://images-api.nasa.gov/search
+timeout: 15
+query_param: q
+canary_query: "apollo 11"
+desc: "NASA 图像视频库（公开航天影像，免认证，匿名约 30 req/h）"
+coverage: [earth_science, media]
+recommended: false
+latency_ms: 2000
+
+headers:
+  User-Agent: argo-search/1.0 (+nasa_images)
+  Accept: application/json
+
+extra_params:
+  media_type: image
+  page_size: "{n}"
+
+output_map:
+  items: collection.items
+  item_title: data.0.title
+  item_summary: data.0.description
+  item_published_at: data.0.date_created
+  url_template: "https://images.nasa.gov/details/{data.0.nasa_id}"
+  # 图片直链：item.links 是 [{href, rel, render, width, ...}]，必须取 .href
+  # ——写成 links.0 会被 _coerce_field 丢成空串（dict 不可强转）。
+  item_image: links.0.href
+
+# NASA 影像是美国政府作品，属公有领域；授权不随条目变化，声明一次即可。
+image_license: "公有领域（NASA，美国政府作品）"
+
+quality_queries:
+  - query: "apollo 11"
+  - query: "hubble telescope"
+  - query: "mars rover"

package/engines/specs/netease_music.yaml

@@ -0,0 +1,38 @@
+# 网易云音乐搜索 — 中文曲库（Web 接口，免认证）
+# 补 media_search 域的中文曲库维度：qq_music 无歌单/专辑元数据深度，
+# itunes 偏欧美曲库。非官方接口，历史上偶加签名——失败诚实空，不做绕过。
+# fee 字段标 VIP 歌曲仅作元数据用途。
+# 验证:
+#   python3 scripts/engine_validate.py --engine netease_music --stage all --admit --write-doc
+
+engine_id: netease_music
+type: http
+enabled: true
+cost_tier: free
+method: GET
+url: https://music.163.com/api/search/get/web
+timeout: 10
+query_param: s
+canary_query: "周杰伦 晴天"
+desc: "网易云音乐搜索（中文曲库/专辑元数据，免认证，非官方接口）"
+coverage: [media, chinese]
+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
+  Referer: https://music.163.com/
+
+extra_params:
+  type: "1"
+  limit: "{n}"
+
+output_map:
+  items: result.songs
+  item_title: name
+  item_summary: album.name
+  url_template: "https://music.163.com/song?id={id}"
+
+quality_queries:
+  - query: "周杰伦 晴天"
+  - query: "Taylor Swift Love Story"

package/engines/specs/nhk.yaml

@@ -0,0 +1,43 @@
+# NHK 新闻 RSS — 日本放送协会主要新闻，公共广播一手源
+#
+# 补的盲区：**ja 本地一手新闻**。接入前 argo 的新闻链路只有中英源
+# （google_news/guardian_rss/dw_news/france24 都是英语视角），ja 查询
+# 拿不到本地一手报道。
+#
+# 实测（2026-09-21）：**7 条**，摘要中位 103 字、最长 163 字。
+#
+# 形态：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 nhk --stage all --admit
+#   python3 scripts/search.py "今日のニュース" --engine nhk --json
+
+engine_id: nhk
+type: rss_feed
+enabled: true
+cost_tier: free
+label: NHK 新闻 RSS
+family: world_news
+feed_mode: hot
+relevance_check: false
+priority: 47
+qps: 1
+period: second
+cost_per_call: 0.0
+cost_unit: free
+timeout: 12
+feed_url: https://www3.nhk.or.jp/rss/news/cat0.xml
+langs:
+- ja
+canary_query: "今日のニュース"
+coverage:
+- news
+- japan
+desc: "NHK 新闻（日本放送协会主要新闻，公共广播一手源，免 key）"
+recommended: false
+
+quality_queries:
+  - query: "今日のニュース"
+  - query: "日本の政治"

package/engines/specs/nhtsa_vpic.yaml

@@ -0,0 +1,20 @@
+# NHTSA vPIC 车辆厂商/车型本体（免认证）
+# 补 shopping 域：车辆厂商/车型标准命名（12361 个厂商），
+# 「某车型属于哪个厂商」类查询的权威答案源。
+# 验证:
+#   python3 scripts/engine_validate.py --engine nhtsa_vpic --stage all --admit --write-doc
+
+engine_id: nhtsa_vpic
+type: nhtsa_vpic
+enabled: true
+cost_tier: free
+timeout: 20
+canary_query: "tesla"
+desc: "车辆厂商/车型本体（NHTSA vPIC，免认证）"
+coverage: [shopping, vehicle, reference, official]
+recommended: false
+latency_ms: 2500
+
+quality_queries:
+  - query: "tesla"
+  - query: "toyota"

package/engines/specs/noaa_swpc.yaml

@@ -0,0 +1,20 @@
+# NOAA SWPC 空间天气（官方免认证）
+# 补 astronomy 域的「空间天气」维度：Kp 地磁指数 + 太阳活动区。
+# 榜单型源（查询词不参与过滤），与太阳活动/极光/卫星安全类查询相关。
+# 验证:
+#   python3 scripts/engine_validate.py --engine noaa_swpc --stage all --admit --write-doc
+
+engine_id: noaa_swpc
+type: noaa_swpc
+enabled: true
+cost_tier: free
+timeout: 15
+canary_query: "solar"
+desc: "空间天气（NOAA SWPC，Kp 指数/太阳活动区，官方免认证）"
+coverage: [astronomy, space, science, official]
+recommended: false
+latency_ms: 2000
+
+quality_queries:
+  - query: "solar"
+  - query: "geomagnetic storm"

package/engines/specs/nvd.yaml

@@ -0,0 +1,38 @@
+# NVD CVE API 2.0 — 安全漏洞情报（NIST 官方，免认证）
+# 配额契约：免 key 5 请求/30 秒滚动窗口（免费 key 50/30s，见 nvd.nist.gov/developers/start-here）
+# 验证:
+#   python3 scripts/engine_validate.py --engine nvd --stage all --admit --write-doc
+#   python3 scripts/search.py "log4j" --engine nvd --json
+
+engine_id: nvd
+type: http
+enabled: true
+cost_tier: free
+method: GET
+url: https://services.nvd.nist.gov/rest/json/cves/2.0
+timeout: 12
+query_param: keywordSearch
+canary_query: "log4j"
+desc: "NVD 漏洞情报（CVE 编号/描述/CVSS 与 KEV 标记；免认证 5 请求/30 秒）"
+coverage: [security, tech]
+recommended: false
+latency_ms: 2500
+
+headers:
+  User-Agent: argo-search/1.0 (+nvd)
+  Accept: application/json
+
+extra_params:
+  resultsPerPage: "5"
+
+output_map:
+  items: vulnerabilities
+  item_title: cve.id
+  item_summary: cve.descriptions.0.value
+  item_published_at: cve.published
+  url_template: "https://nvd.nist.gov/vuln/detail/{cve.id}"
+
+quality_queries:
+  - query: "log4j"
+  - query: "openssl"
+  - query: "heartbleed"

package/engines/specs/obis.yaml

@@ -0,0 +1,20 @@
+# OBIS 海洋生物多样性观测（IOC/UNESCO，免认证，2.29 亿条记录）
+# 补 species_search 域的「海洋」维度：现有 gbif 以陆生/通用为主，
+# OBIS 是海洋观测的官方汇总。拉丁学名准确，中文俗名诚实空（交回百科类引擎）。
+# 验证:
+#   python3 scripts/engine_validate.py --engine obis --stage all --admit --write-doc
+
+engine_id: obis
+type: obis
+enabled: true
+cost_tier: free
+timeout: 15
+canary_query: "Gadus morhua"
+desc: "OBIS 海洋物种观测（IOC/UNESCO 官方，2.29 亿条记录，免认证）"
+coverage: [species, marine, science, open_data]
+recommended: false
+latency_ms: 2000
+
+quality_queries:
+  - query: "Gadus morhua"
+  - query: "Delphinus delphis"

package/engines/specs/opencitations.yaml

@@ -0,0 +1,52 @@
+# OpenCitations — 引用图谱（免 key、免注册、无限次）
+#
+# 补的盲区：论文的**引用关系与溯源**。Crossref/OpenAlex 给的是出版物元数据，
+# 而「这篇被谁引用 / 引了谁」是另一类问题——用于判断一篇工作的影响力与谱系，
+# 也是证据链里「这个说法有没有后续验证」的入口。
+#
+# 端点语义（实测 2026-09-16）：
+#   /index/api/v1/citation-count/{doi}   → [{"count": "1806"}]  被引数
+#   /index/api/v1/citations/{doi}        → 引用它的 DOI 列表
+#   /index/api/v1/references/{doi}       → 它引用的 DOI 列表
+# 本引擎走 citation-count（单值、稳定、体积小），查询词传**裸 DOI**。
+#
+# 验证:
+#   python3 scripts/engine_validate.py --engine opencitations --stage health --admit
+#   python3 scripts/search.py "10.1038/nature12373" --engine opencitations --json
+
+engine_id: opencitations
+type: http
+enabled: true
+# 按 DOI 精查而非关键词检索：传裸 DOI，不参与自动路由
+explicit_only: true
+cost_tier: free
+label: OpenCitations 引用图谱
+family: academic
+priority: 52
+qps: 2
+period: second
+cost_per_call: 0.0
+cost_unit: free
+method: GET
+url: https://opencitations.net/index/api/v1/citation-count/{query}
+query_param: ""
+timeout: 12
+format: json
+canary_query: "10.1038/nature12373"
+coverage:
+- academic
+- citation
+desc: "OpenCitations 引用计数（DOI → 被引次数，免 key 无限次；查询词传裸 DOI）"
+# 响应是单元素数组 [{"count": "N"}]，没有标题/URL 字段。url_template 的 {..}
+# 占位符取自 **item** 而非 query，写 {query} 会渲染成空串，故用静态入口页
+# （与 carbon_intensity 同做法）。
+output_map:
+  items: "."
+  item_title: "count"
+  item_summary: "count"
+  url_template: "https://opencitations.net/"
+recommended: false
+latency_ms: 800
+
+quality_queries:
+  - query: "10.1038/nature12373"

package/engines/specs/openf1.yaml

@@ -0,0 +1,21 @@
+# OpenF1 — 一级方程式遥测与赛程（免认证，社区维护）
+# 补 sports_search 域的「赛车」维度（现有 thesportsdb 偏足篮）。
+# 先查 sessions 端点拿 session_key 再查 drivers，两级解析由 builder 完成。
+# 验证:
+#   python3 scripts/engine_validate.py --engine openf1 --stage all --admit --write-doc
+
+engine_id: openf1
+type: openf1
+enabled: true
+cost_tier: free
+timeout: 20
+canary_query: "verstappen"
+desc: "F1 车手/车队/赛程数据（OpenF1，免认证，社区维护）"
+family: sports
+coverage: [sports, racing, realtime]
+recommended: false
+latency_ms: 2500
+
+quality_queries:
+  - query: "verstappen"
+  - query: "monza"

package/engines/specs/openfoodfacts.yaml

@@ -0,0 +1,45 @@
+# Open Food Facts — 全球食品成分库（免 key，开放数据库）
+#
+# 补的盲区：**食品/营养**。argo 有 usda（美国农业部食品营养，DEMO_KEY 限流）
+# 但它是单一国别；Open Food Facts 是 200+ 国家的众包食品库，多语言
+# （产品名/配料表按语言分列），免 key 无配额。
+#
+# 实测（2026-09-21）：JSON 直出；「nutella」1038 条命中，含 additives_n /
+# brands / 各国产品名。条目数在垂直源里属最高档。
+#
+# 形态：检索式。url 由 url_template 从条码拼出（上游不返回绝对 URL）。
+#
+# 验证:
+#   python3 scripts/engine_validate.py --engine openfoodfacts --stage all --admit
+
+engine_id: openfoodfacts
+type: http
+enabled: true
+cost_tier: free
+method: GET
+url: https://world.openfoodfacts.org/cgi/search.pl
+timeout: 20
+query_param: search_terms
+canary_query: "nutella"
+family: misc_vertical
+coverage: [food, nutrition, product]
+desc: "Open Food Facts 全球食品成分库（200+ 国家，多语言，免 key）"
+recommended: false
+# 上游按 Accept 头做内容协商：不带 Accept 时返回 503（实测 2026-09-21，
+# 同一 URL 加 Accept: application/json 即 200）——不是限流，是端点策略。
+headers:
+  Accept: application/json
+extra_params:
+  search_simple: 1
+  action: process
+  json: 1
+  page_size: "{n}"
+output_map:
+  items: products
+  item_title: product_name
+  item_summary: brands
+  url_template: "https://world.openfoodfacts.org/product/{code}"
+
+quality_queries:
+  - query: "nutella"
+  - query: "yogurt"

package/engines/specs/openligadb.yaml

@@ -0,0 +1,20 @@
+# OpenLigaDB 德甲/欧洲联赛赛程比分（免认证）
+# 补 sports_search 域的足球赛程/比分维度（thesportsdb 偏球队元数据）。
+# 验证:
+#   python3 scripts/engine_validate.py --engine openligadb --stage all --admit --write-doc
+
+engine_id: openligadb
+type: openligadb
+enabled: true
+cost_tier: free
+timeout: 15
+canary_query: "bayern"
+desc: "德甲/欧洲联赛赛程比分（OpenLigaDB，免认证）"
+family: sports
+coverage: [sports, football, realtime]
+recommended: false
+latency_ms: 2000
+
+quality_queries:
+  - query: "bayern"
+  - query: "bundesliga"

package/engines/specs/openreview.yaml

@@ -0,0 +1,37 @@
+# OpenReview API2 — 顶会论文与评审意见（免认证）
+# 特点：审稿意见 / meta-review / rebuttal 公开可见，openalex 与
+# semantic_scholar 均不含这一层；content 字段统一为 {value: ...} 包装。
+# 验证:
+#   python3 scripts/engine_validate.py --engine openreview --stage all --admit --write-doc
+
+engine_id: openreview
+type: http
+enabled: true
+cost_tier: free
+method: GET
+url: https://api2.openreview.net/notes/search
+timeout: 12
+query_param: term
+canary_query: "LLM agents"
+desc: "OpenReview 顶会论文（含评审可见性与 PDF，AI/ML 研究为主）"
+coverage: [academic]
+recommended: false
+latency_ms: 3000
+
+headers:
+  User-Agent: argo-search/1.0 (+openreview)
+  Accept: application/json
+
+extra_params:
+  limit: "10"
+
+output_map:
+  items: notes
+  item_title: content.title.value
+  item_summary: content.abstract.value
+  url_template: "https://openreview.net/forum?id={id}"
+
+quality_queries:
+  - query: "LLM agents"
+  - query: "transformer"
+  - query: "reinforcement learning"

package/engines/specs/openstd.yaml

@@ -0,0 +1,21 @@
+# 国家标准全文公开系统 — GB 国标全文在线预览入口（HTML 解析，免认证）
+# 与 std_samr 同库互补：这里给全文预览页（newGbInfo?hcno=），列表为服务端
+# 渲染 HTML，行内 onclick showInfo('hcno') 取详情键。全文 PDF 防复制渲染，
+# 只取元数据（标准号/名称/性质/状态/发布/实施日期）。
+# 验证:
+#   python3 scripts/engine_validate.py --engine openstd --stage all --admit --write-doc
+
+engine_id: openstd
+type: openstd
+enabled: true
+cost_tier: free
+timeout: 15
+canary_query: "数据安全"
+desc: "国家标准全文公开系统（GB 全文预览入口，HTML 解析，免认证）"
+coverage: [standards, tech, chinese]
+recommended: false
+latency_ms: 2500
+
+quality_queries:
+  - query: "数据安全"
+  - query: "信息技术"

package/engines/specs/people_daily.yaml

@@ -0,0 +1,22 @@
+# 人民网搜索 — 权威综合中文新闻（官方 JSON 接口，免认证，POST）
+# 现有新闻类源全偏财经（东财/财联社/金十），人民网补权威综合新闻维度。
+# 注意：走 http 而非 https（https 会 301 丢 body）。标题/正文带 <em> 高亮
+# 标签，builder 内剥离。displayTime 为毫秒时间戳。
+# 验证:
+#   python3 scripts/engine_validate.py --engine people_daily --stage all --admit --write-doc
+
+engine_id: people_daily
+type: people_daily
+enabled: true
+cost_tier: free
+timeout: 12
+canary_query: "人工智能"
+desc: "人民网搜索（权威综合中文新闻，官方接口，免认证）"
+coverage: [news, chinese, realtime]
+recommended: false
+latency_ms: 1200
+
+quality_queries:
+  - query: "人工智能"
+  - query: "经济"
+  - query: "教育"

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