Skip to content

Repository files navigation

AI CardNav

AI 订阅价格聚合与卡网渠道比价平台

聚合 ChatGPT、Claude、Gemini、Grok、Cursor、Codex 等 AI 产品的订阅、账号、充值及 API 渠道报价, 帮助用户快速查询价格、比较渠道并了解商品库存与数据新鲜度。

在线访问 · 快速开始 · 渠道提交 · 使用规范与免责声明

Python FastAPI React PostgreSQL License


AI CardNav 是一个开源的 AI 订阅价格聚合与卡网渠道比价平台,专注于整理和比较不同店铺、不同商品形态及不同购买渠道的公开价格。

项目收录 ChatGPT、Claude、Gemini、Grok、Cursor、Codex 等产品相关的代充、成品号、日抛、共享账号、独享账号、API 额度及其他数字商品报价。用户可以按商品名称、店铺、AI 产品体系、商品类型、价格、库存和采集时间进行检索与比较。

AI CardNav 仅提供公开价格信息的整理、聚合与比价展示,不销售任何商品,也不参与用户与第三方渠道之间的交易。

汇聚公开渠道报价

当前线上采集规模会随店铺上下架和商品库存实时变化:

指标 当前能力
卡网店铺 支持 1,600+ 店铺的周期采集与状态维护
商品规模 支持 38,000+ 商品的搜索、筛选和比价
更新周期 默认每 30 分钟启动一轮刷新
完整性 分页总数校验、商品去重、失败自动重试
失败保护 网络失败时保留上次快照,并与本轮新鲜数据分开统计

仓库只包含平台源码、示例配置和数据结构,不包含线上商品快照、代理账号、密钥或私人运行数据。

平台截图

卡网与模型价格检索

AI CardNav 价格聚合与比价界面

渠道聚合

AI CardNav 渠道聚合界面

快速访问

买家入口

  • 查看 AI 订阅及卡网渠道公开报价
  • 按 ChatGPT、Claude、Gemini、Grok、Cursor、Codex 等关键词搜索商品
  • 按价格、库存、商品类型、店铺和更新时间筛选结果
  • 对比代充、成品号、日抛、共享、独享及 API 类商品差异

卡网商家与渠道商

  • 前往网站提交渠道收录
  • 在网站提交时提供店铺名称、公开访问地址、发卡系统类型及主要商品范围
  • 保持商品名称、价格、库存和分类字段清晰,可提高自动归类和搜索效果

开发者

项目初衷

AI 订阅和数字商品报价分散在大量不同渠道中,例如卡网、发卡系统、自建商城、社群和二手平台。信息分散会带来两个直接问题:

  • 对于买家:需要反复打开多个店铺查找商品,很难快速判断不同商品形态、价格、库存和售后差异。
  • 对于商家:低价或有特色的商品缺少统一展示入口,用户难以通过商品关键词和价格筛选发现对应渠道。

AI CardNav 希望把公开可访问的商品信息整理成持续更新的索引,让买家更容易比较,让渠道商的公开商品更容易被检索。

适用人群

买家

适合希望比较以下商品的用户:

  • ChatGPT、Claude、Gemini、Grok、Cursor、Codex 等 AI 产品
  • 代充、成品号、日抛、共享账号、独享账号及带质保商品
  • API 额度、中转服务及其他公开数字商品
  • 接码、代理、社交账号等卡网常见扩展商品

平台提供的是公开信息索引。价格最低不代表综合风险最低,购买前仍需核对账号归属、商品期限、售后方式和退款规则。

卡网商家与渠道商

商家可以通过公开 Issue 提交自己的渠道信息。平台按统一数据字段采集和展示,不收取收录费用,也不保证流量或成交结果。

核心特性

卡网渠道价格聚合

统一整理不同店铺的商品名称、价格、库存、分类、店铺地址、商品地址和采集时间,支持跨店铺搜索与价格排序。

AI 商品分类与检索

针对 ChatGPT、Claude、Gemini、Grok、Cursor、Codex 等常见产品进行体系归类,并区分订阅、账号、充值、API、日抛等商品类型。

半小时周期刷新

定时任务默认在每小时 05 分和 35 分启动。单轮采集设置运行截止时间,避免上一轮长期占用并影响下一轮。

网络失败自动重试

连接超时、代理失效和临时网络错误会重新进入失败队列;成功店铺不重复采集。每轮支持多次重试,并在总截止时间内完成尽可能多的刷新。

商品完整性校验

采集器会校验接口分页返回的商品总数,对商品唯一键进行去重,并记录每家店铺的实际商品数量。数量校验失败的结果不会直接覆盖正式数据。

旧快照保护

店铺刷新失败时保留上次成功快照,避免网络波动导致商品突然消失。报告将数据拆分为:

  • fresh_rows:本轮成功刷新的商品
  • preserved_rows:失败店铺保留的旧快照
  • formal_rows:本轮最终对外数据总数

多种存储模式

支持本地 JSON/CSV 文件模式,也支持 PostgreSQL 分代导入、快照记录和原子切换,适合从本地开发逐步迁移到长期线上运行。

附加能力

代码同时包含 AI API 中转站聚合、模型价格比较、公告监测、官方 API 状态、模型检测、AI 资讯和在线对话等功能。

数据更新与完整性

flowchart LR
    A[店铺目录] --> B[代理获取与健康检查]
    B --> C[并发采集店铺与商品分页]
    C --> D[分页总数与商品数量校验]
    D --> E{采集成功?}
    E -->|是| F[写入本轮新鲜商品]
    E -->|否| G[进入下一轮重试]
    G --> C
    G -->|达到截止时间| H[保留上次成功快照]
    F --> I[去重并生成正式数据]
    H --> I
    I --> J[导入 PostgreSQL / 输出 JSON CSV]
Loading

平台重点区分“正式商品总数”和“本轮新鲜商品数”。网络失败保留的数据不会被标记为本轮新鲜数据。

技术栈

层级 技术
前端 React 19、Vite、lucide-react、react-markdown
后端 Python 3.9+、FastAPI、Uvicorn
数据库 PostgreSQL,可选本地 JSON/CSV 模式
数据处理 Python 并发采集、归一化、去重、分页校验与增量导入
部署 Linux、Cron、Uvicorn、Docker 或反向代理

目录结构

ai-cardnav/
├─ server.py                         FastAPI 应用与查询接口
├─ db_schema.sql                     PostgreSQL 表结构
├─ load_json_to_db.py                JSON 数据分代导入
├─ incremental_import.py             增量导入辅助逻辑
├─ normalize_data.py                 站点和模型数据归一化
├─ refresh_sites.py                  站点探活与增量刷新
├─ web/                              React + Vite 前端源码
├─ scripts/
│  ├─ refresh_card_shop_goods.py     卡网商品采集器
│  ├─ run_card_pipelined_proxy_refresh.py  短效代理流水线调度器
│  ├─ run_card_scheduled_refresh.sh  半小时定时入口
│  ├─ import_card_goods.py           卡网商品数据库导入
│  ├─ verify_card_item.py            单商品与分页完整性验证
│  └─ test_card_pipeline_adaptive.py 调度与重试测试
├─ data/                             本地运行数据目录
└─ docs/                             截图、发布说明和文档

快速开始

环境要求

  • Python 3.9 或以上
  • Node.js 18 或以上
  • npm
  • PostgreSQL,可选

1. 克隆项目

git clone https://github.com/bnlbnf/ai-cardnav.git
cd ai-cardnav

2. 安装后端依赖

python -m venv .venv

# Linux / macOS
source .venv/bin/activate

# Windows PowerShell
# .venv\Scripts\Activate.ps1

python -m pip install -r requirements.txt

3. 构建前端

cd web
npm ci
npm run build
cd ..

4. 准备配置

cp .env.example .env

编辑 .env,按实际环境配置数据库和可选服务。不要把真实密钥、Cookie、代理接口或数据库密码提交到仓库。

5. 准备数据

已有站点采集结果时,可以先执行归一化:

python normalize_data.py --input ../api_config_results.json --out-dir data

卡网相关脚本提供独立帮助信息:

python scripts/refresh_card_shop_goods.py --help
python scripts/run_card_pipelined_proxy_refresh.py --help
python scripts/import_card_goods.py --help

6. 启动服务

python -m uvicorn server:app --host 127.0.0.1 --port 8765

访问 http://127.0.0.1:8765

环境变量

变量 说明
DATABASE_URL 设置后启用 PostgreSQL 模式
RELAYWATCH_ADMIN_TOKEN 后台维护接口管理员口令
RELAYWATCH_DETECTOR_BASE_URL 模型检测服务地址
GITHUB_TOKEN / RELAYWATCH_GITHUB_TOKEN 提高 GitHub 信息源请求限额
RELAYWATCH_LINUXDO_COOKIE 可选的信息源访问 Cookie
RELAYWATCH_AI_NEWS_TTL AI 资讯缓存时间
RELAYWATCH_OFFICIAL_STATUS_TTL 官方状态缓存时间

项目保留 RELAYWATCH_* 环境变量名称,以兼容原有部署配置。

API 接口

方法 路径 说明
GET /api/summary 平台统计摘要
GET /api/ldxp/goods 卡网商品搜索、筛选、排序和分页
GET /api/sites 渠道与站点列表
GET /api/sites/{site_id} 站点详情
GET /api/models 模型价格比较
GET /api/model-sites 指定模型的渠道价格
GET /api/announcements 渠道公告流
GET /api/official-status 官方 API 状态
GET /api/ai-news AI 资讯
POST /api/detections 创建模型检测任务

示例:

curl 'http://127.0.0.1:8765/api/ldxp/goods?q=claude&sort=price_asc&page=1&page_size=30'

渠道收录

卡网商家或渠道商可以前往 AI CardNav 网站主页 提交公开渠道。建议提供:

  • 店铺名称
  • 公开访问地址
  • 发卡系统或商城类型
  • 主要商品分类
  • 商品与库存是否无需登录即可查看
  • 联系方式,可选

收录只代表该公开渠道可以被索引,不代表平台对商家、商品或售后作出担保。

贡献

  • 提交渠道:前往 网站主页 提交公开卡网或商城信息。
  • 代码贡献:修复采集兼容性、商品分类、界面和数据质量问题。
  • 文档贡献:补充部署说明、数据字段、发卡系统适配和常见问题。

提交 Pull Request 前建议运行:

python -m py_compile server.py scripts/*.py
python scripts/test_card_pipeline_adaptive.py
python scripts/test_rebuild_card_last_complete_snapshot.py

cd web
npm ci
npm run build

使用规范与免责声明

本项目仅对公开可访问的渠道、商品和价格信息进行整理、聚合与比价展示,不参与任何实际交易,也不对第三方渠道、账号、订阅、商品质量、库存、售后或退款提供担保。

商品信息可能因渠道调整、缓存、网络失败或采集周期产生延迟。平台展示的价格和库存仅供检索与比较,最终信息应以商品原始页面为准。

平台支持按价格等字段进行客观排序,但低价不代表低风险或高质量。用户在购买前应自行核对商品期限、账号归属、登录方式、质保范围、退款规则及原平台条款,相关交易风险由交易双方自行承担。

本项目不提供批量注册、自动化注册、账号生成或攻击服务,也不授权任何人利用项目展示的站点链接、注册入口或公开信息实施以下行为:

  • 批量或自动创建账号,刷取注册赠送、试用额度、优惠权益,或规避第三方风控;
  • 未经许可的压力测试、漏洞利用、凭证攻击、流量攻击、恶意请求或服务干扰;
  • 违反第三方服务条款、注册规则或适用规定的其他操作。

任何使用者访问第三方站点时均应遵守该站点的规则,并对自己的行为独立负责。收到有效滥用投诉后,项目维护者可采取限制访问、隐藏或下架入口、保留必要日志以及配合相关服务商核查等措施。

完整条款、滥用举报和站点下架说明见 DISCLAIMER.md。安全问题请按 SECURITY.md 私下报告。

开源与数据说明

仓库公开:

  • 前后端源码
  • 数据库结构
  • 卡网采集、调度、导入和验证脚本
  • 示例配置与部署文档

仓库不公开:

  • 线上商品数据快照
  • 代理账号与接口密钥
  • 数据库密码、Cookie 和管理员口令
  • 服务器日志、缓存和历史备份

License

本项目采用 MIT License

About

开源的 AI 卡网导航与实时商品比价平台,聚合 ChatGPT、Claude、Gemini、Grok、Cursor 等账号、订阅、充值及 API 商品,提供店铺收录、价格对比、库存状态和半小时更新。

Topics

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages