📦 检查 MCC

CheckMCC 查询任意商户的 MCC 码及可刷信用卡。 API 根地址 https://check-mcc.vercel.app/api

命令 运行打包脚本即可查询： scripts/check-mcc.sh [--country ]

--country （可选）按国家过滤，默认 US。

• US（默认）：仅线上商户，美国信用卡
• SG：线上+线下商户，新加坡信用卡

lookup 按网站域名查商户，返回 MCC、类别、国家、可刷信用卡。 scripts/check-mcc.sh lookup fairprice.com.sg scripts/check-mcc.sh lookup shopee.sg scripts/check-mcc.sh --country US lookup amazon.com scripts/check-mcc.sh --country US lookup walmart.com

search 按名称搜商户，返回匹配结果含 MCC 与类别。 --country US 时仅返回线上商户。 scripts/check-mcc.sh search "cold storage" scripts/check-mcc.sh search grab scripts/check-mcc.sh --country US search amazon scripts/check-mcc.sh --country US search walmart

mcc 按数字查 MCC 或按类别关键词模糊搜索。 scripts/check-mcc.sh mcc 5812 # 餐饮场所 scripts/check-mcc.sh mcc 5411 # 杂货店 scripts/check-mcc.sh mcc restaurant # 模糊搜索

cards 查指定 MCC 可刷信用卡。 --country US 时返回美国卡 bonus 资格。 scripts/check-mcc.sh cards 5812 scripts/check-mcc.sh --country US cards 5812

submit 向数据库提交新商户，AI 自动提取名称、MCC、类型、URL、国家。 MCC 须存在于数据库，否则报错。 scripts/check-mcc.sh submit "shoplet.com with mcc 5812" scripts/check-mcc.sh submit "Starbucks #1234 at Orchard Road, Singapore" scripts/check-mcc.sh submit "Amazon.com purchase $123.45 online shopping"

成功返回： { "merchantName": "Shoplet", "mcc": "5812", "type": "online", "url": "shoplet.com", "country": "Singapore" }

错误返回（无效 MCC）： { "error": "MCC code 9999 is not a valid MCC code. No matching entry found in the MCC database.", "extractedData": {...} }

直接 API 调用 可用 curl 或 web_fetch：

端点 方法 说明 /api/store-by-domain?domain=X®ion=US GET 按域名查（region=US 返回美国卡） /api/store/search?q=X GET 搜商户 /api/mcc GET 全部 300 条 MCC /api/mcc?mcc=5812®ion=US GET 指定 MCC 含美国卡资格 /api/mcc/codes GET 仅 MCC 码列表 /api/extract-merchant-text POST AI 提取商户信息 /api/store POST 提交新商户

返回示例 域名查（SG）： { "Store": "NTUC FairPrice Online", "MCC": "5411", "Category": "Grocery Stores, Supermarkets", "Country": "Singapore", "eligibleCards": [ { "name": "UOB Preferred Platinum Visa", "eligible": true, "mpd": "4 MPD", "spendCap": "Cap at $1,000 a month" }, { "name": "DBS Woman's Card", "eligible": false, "reason": "Not in whitelist" } ] }

域名查（US）： { "Store": "Amazon", "MCC": "5411", "Category": "Grocery Stores, Supermarkets", "type": "online", "eligibleCards": [ { "name": "Chase Freedom Unlimited", "eligible": true, "mpd": "3%", "reason": "Bonus rate: 3% on online" }, { "name": "Amex Blue Cash Preferred", "eligible": false, "reason": "Base rate: 1% (not in bonus category)" } ] }

注：eligibleCards 仅在域名查询与 cards 命令返回；店铺搜索仅含基础 MCC。

常用 MCC 5812 Eating Places and Restaurants 5814 Fast Food Restaurants 5411 Grocery Stores, Supermarkets 5541 Service Stations (Petrol) 4121 Taxicabs and Limousines 5999 Miscellaneous Retail 6010 Financial Institutions 6051 Non-financial Institutions

提示

• 域名查询支持子域及多段 TLD（.com.sg、.co.uk）
• 域名无结果可改用名称搜索
• --country US 仅线上商户+美国信用卡
• 卡资格按国家区分：SG 看本地优惠，US 看 bonus 类别
• MPD：新加坡为里程/美元，美国为百分比返现