mcc-cf · MCC 商户分类码在线查询

线上：mcc.095233.xyz · 备用：mcc-lookup.minis233.workers.dev

mcc-codes-cn 数据集的在线查询站，跑在 Cloudflare Workers 上。

功能

• 4 位数字精确查询 —— 输入 5411 立即看到「超市/食品店」+ 银行积分政策
• 数字前缀匹配 —— 输入 58 列出所有 58xx 段
• 关键词全文搜索 —— 中英文均可，支持「餐厅 / 加油 / hilton / 万豪」等
• 行业目录浏览 —— 13 个分段一键展开
• JSON API —— 支持脚本/工具调用，CORS 全开放

截图

API 端点

端点	说明
GET /api/mcc/:code	单条查询，支持 5411 / 742（自动补零）
GET /api/search?q=&limit=	关键词搜索，默认上限 50
GET /api/sections	13 段元信息
GET /api/all	完整 981 条数据集
GET /healthz	健康检查

# 示例
curl https://mcc.095233.xyz/api/mcc/5411
curl 'https://mcc.095233.xyz/api/search?q=餐厅'

本地开发

npm install
node scripts/build-data.mjs   # 生成 src/data.js（从 data.json 内联进 bundle）
node --test test/*.test.js    # 跑测试
npx wrangler dev              # 本地启动
npx wrangler deploy           # 部署

数据流

data.json (从 mcc-codes-cn 同步)
    │
    ├─ scripts/build-data.mjs
    │    └─ 生成扁平 LOOKUP + SEARCH_INDEX
    │
    └─ src/data.js (auto-generated, 222 KB)
            │
            └─ src/index.js (Worker 入口) + src/html.js (SPA)
                    │
                    └─ Bundle: 440 KiB / gzip 69 KiB / 启动 27ms

数据更新

数据源是 mcc-codes-cn 的 mcc-detailed-cn.json。当上游字典更新后：

curl -sSL https://raw.githubusercontent.com/Minis233/mcc-codes-cn/main/mcc-detailed-cn.json -o data.json
node scripts/build-data.mjs
git commit -am "data: sync from mcc-codes-cn"
git push  # GitHub Actions 自动部署

CI / CD

.github/workflows/deploy.yml —— 推送到 main 触发自动部署，需要在 repo secrets 配：

• CLOUDFLARE_API_TOKEN — 至少需要 Workers Scripts:Edit
• CLOUDFLARE_ACCOUNT_ID

License

MIT · 数据集见 Minis233/mcc-codes-cn