快速开始
- 在提交站点页面填写名称、HTTPS 地址、类别和系统。
- 审核通过后进入公开目录。在站点详情页认领，通过 DNS TXT 或公开验证文件证明域名控制权。
- 原生适配器会读取可公开访问的商品接口。任何自建系统都可以提供以下 JSON Feed。
- 在“我的雷达 → 我的站点”配置 Feed 地址和更新间隔，查看最近成功时间与错误原因。
原生适配表示已实现该接口契约。不同版本、二次开发、访问限制与店铺配置可能需要额外适配。Feed 兼容表示需要商家主动提供数据，不等于已支持该系统的所有私有接口。
系统接入方式
雷电小铺 LDXP 与“链动小铺”名称相近，不能仅凭名称认为接口一致。链动小铺目前通过标准 Feed 接入，原生接口需用具体实例确认。LDXP 当前接口仅覆盖 card 商品类型；ACG-Faka、16688 单次列表不会被当作完整店铺快照。
标准商品 Feed
在站点同源 HTTPS 地址返回 UTF-8 JSON，例如 /leida-feed.json。也可在首页声明：
<link rel="leida-feed" href="/leida-feed.json" />{
"schema_version": "1.0",
"mode": "snapshot",
"is_complete": true,
"items": [
{
"product_id": "membership-standard",
"title": "软件月度订阅",
"category": "subscription",
"brand": "Example",
"url": "https://your-shop.example/products/standard",
"variants": [
{
"variant_id": "cn-30d-private",
"title": "标准版 · 30 天 · 独享",
"price": {
"amount": "29.90",
"currency": "CNY",
"unit": "item"
},
"availability": "in_stock",
"attributes": {
"product": "example-standard",
"region": "CN",
"duration": "P30D",
"sharing": "private",
"delivery_type": "activation_code",
"warranty": "原站明示的售后条款",
"conditions": "具体适用条件"
}
}
]
}
],
"next_cursor": null
}币种和价格单位应明确。每个可购买规格独立提供 variant_id；ID 应长期稳定，避免每次更新产生新商品。商品名称、来源地址与 ID 不可为空。
字段与数据完整性
| 字段 | 约定 |
|---|---|
| category | api / subscription / giftcard / virtualcard / account / software / game / service / other |
| price.amount | 十进制字符串，可为 0；未知用 null。不可用空字符串代替免费。 |
| price.currency | 明确报价币种，例如 CNY、USD；不同币种不直接比较。 |
| price.unit | item、month、year、1m_tokens 等。不同单位不混排价格。 |
| availability | in_stock / out_of_stock / preorder / unknown |
| attributes | 地区、面额、周期、交付、共享方式、售后与其他条件；未知不猜测。 |
| next_url / next_cursor | 下一页地址或游标。同源分页；单次任务最多 50 页、10,000 条。 |
| mode / is_complete | snapshot / delta。每页均须声明 snapshot 和 is_complete:true，遍历全部分页后才检查旧商品缺失；delta 必须设置 is_complete:false。 |
同一个商品在连续两次完整成功快照中缺失才停止展示。列表不完整、来源不可达或解析失败时，保留上次数据并显示采集时间。未获得报价的站点仍可进入站点目录。
模型报价与可比性
按 Token 计价的商品使用 category:api、unit:1m_tokens，提供精确 model_id 与 rates: { input, output, cache_read }，费率均为每百万 tokens。同一模型的不同价格组、上下文档位和条件应分别提供商品规格。
直接可核实的绝对费率可设置 attributes.price_basis:direct。New API 公开倍率会作为原始条件展示；没有充值兑换关系时不换算成绝对单价。缓存费率未知时，含缓存用量的估算显示条件不足。
非 API 商品只有在标准商品、地区、交付方式、周期、共享方式、售后和币种等条件完整一致时才进入同规格组。按数字排序仅适用于已选定同一币种与单位的结果；并排对照本身不说明商品相同。
站点发现 Feed
管理员可接入公开或获得使用授权的站点目录。来源每天读取一次，按规范化地址去重，新站点进入候选审核队列。可以选择 JSON 列表，或配置 HTML 目录中商家链接的 CSS 选择器。HTML 模式仅读取所选元素的 href / data-site-url 与显示名称，不执行页面脚本；需要 JavaScript 才能加载的目录请使用其开放 API 或导出。JSON 格式：
{
"sites": [
{
"name": "示例商店",
"url": "https://shop.example",
"description": "公开目录描述"
}
]
}URL 会移除追踪参数与片段，保留实际店铺路径和必要标识。同一个域名下不同店铺分别保留；跨域镜像不会在没有证据时自动合并。
公开查询 API
API 基础地址：https://www.leida.store/api/v1。响应为 JSON。匿名查询每 IP 每分钟 240 次；登录后可在“我的雷达”创建只读 API Key，每密钥每分钟 600 次。密钥只展示一次，随时可撤销。
curl "https://www.leida.store/api/v1/search?q=Claude&category=api¤cy=USD&unit=1m_tokens"
-H "Authorization: Bearer YOUR_LEIDA_KEY"| 接口 | 用途 |
|---|---|
| GET /search | q、category、brand、currency、unit、availability、site_id、fresh=1、comparable=1、sort、page、limit（最多 60） |
| GET /offers/:id | 商品、来源、最近 180 条价格变更与相同规格报价 |
| GET /sites | 站点列表；q、category、system、page |
| GET /sites/:id | 公开站点资料与最近更新 |
| GET /stats | 收录站点、公开商品与更新时间 |
| GET /systems | 接入方式与分类字典 |
sort 可取 relevance、recent、price_asc、price_desc。价格排序必须同时指定 currency 和 unit；模型按输入费率排序。目标价提醒当前通过站内通知发送，不会代替用户购买。
采集与开放边界
采集器标识：LeidaBot/1.0 (+https://www.leida.store/about)。仅读取公开 HTTPS 资源，遵循 robots.txt，限制请求体积、超时、重定向和分页预算，拒绝内网地址与 DNS 重绑定。不会尝试绕过登录、验证码或访问控制。
原生接口契约参考了各系统官方代码和 MIT 许可的 AI Price Radar。站点数据从对应来源独立获取。受限制的比价平台数据库不会作为默认导入源。
如果站点信息需要修正，请在对应站点或商品详情页提交纠错。数据提供方可以通过已认领站点更新 Feed；后台保留操作和采集审计。