# CodeBox — 智能二维码生成平台

> CodeBox（码盒）是专业的智能二维码生成平台，支持动态二维码生成、数据追踪分析、API 集成和 AI Agent 接入。提供 REST API、TypeScript SDK 和 MCP Server 三种集成方式。

## 核心功能

- 二维码生成：支持 URL、WiFi、文本等多种类型，20+ 精美模板
- 动态二维码：通过短链接跳转，支持实时数据追踪和扫码统计
- 个性化定制：自定义颜色、渐变、码点样式、Logo、码眼形状
- 数据分析：扫码统计、地理位置分析、设备分布、时间趋势
- UTM 追踪：支持 UTM 参数，精准归因营销渠道效果
- API 集成：REST API + TypeScript SDK，支持批量生成和系统对接
- MCP Server：AI Agent（Claude Desktop、Cursor）直接调用二维码能力
- OpenClaw Skill：通过 OpenClaw AI Agent 平台调用二维码生成和管理功能
- Webhook：扫码事件和创建事件实时推送，HMAC-SHA256 签名验证

## 计费模式

- 免费额度：每月 5 次普通二维码 + 5 次 AI 二维码
- 按量充值：充值额度永不过期，用多少买多少
- 静态码和纯图片生成免费，动态追踪码消耗额度

## API 文档

- [API 概览](https://www.codebox.club/docs/api): REST API 端点列表、鉴权方式、频率限制、错误码
- [鉴权指南](https://www.codebox.club/docs/authentication): API Key 创建、Bearer Token、权限配置
- [二维码生成 API](https://www.codebox.club/docs/qrcode-generate): 公开生成接口，支持匿名/Session/API Key 三层鉴权
- [TypeScript SDK](https://www.codebox.club/docs/sdk): @codebox.club/sdk 安装使用、方法参考
- [npm: @codebox.club/sdk](https://www.npmjs.com/package/@codebox.club/sdk): npm 包页面，零依赖 TypeScript SDK
- [CLI 工具](https://www.codebox.club/docs/cli): @codebox.club/cli 命令行工具，终端管理二维码、模板、Webhook
- [Webhook 指南](https://www.codebox.club/docs/webhooks): 事件类型、Payload 格式、签名验证
- [MCP Server](https://www.codebox.club/docs/mcp): 支持 OAuth 登录或 API Key 的 AI Agent 接入，提供 9 个二维码 Tool，并可在生成前无写入启动完整编辑器
- [Codex Plugin](https://www.codebox.club/docs/codex-plugin): 无需私人 Key，复用 CodeBox 登录/微信扫码；支持先启动编辑器和能力导览，再逐步创建、修改和分析二维码
- [批量操作](https://www.codebox.club/docs/batch-operations): 单次最多 20 个，partial failure 模式

## 产品页面

- [首页](https://www.codebox.club): 产品介绍和功能概览
- [二维码生成器](https://www.codebox.club/zh): 在线编辑器，实时预览
- [专注二维码编辑器](https://www.codebox.club/zh/editor): Codex 内置浏览器复用的完整编辑器页面
- [CodeBox Agent](https://www.codebox.club/zh/agent): 通过自然语言创建、连续修改并下载二维码
- [模板中心](https://www.codebox.club/zh/templates): 品牌/行业/节日/艺术模板库
- [额度充值](https://www.codebox.club/zh/dashboard/pricing): 免费额度 + 按量充值包

## 二维码工具（免费，无需登录）

- [免费二维码工具](https://www.codebox.club/tools): 生成、计算、批量预览等工具集合
- [二维码尺寸计算器](https://www.codebox.club/tools/qr-code-size-calculator): 根据扫码距离、DPI和复杂度计算推荐印刷尺寸
- [UTM二维码生成器](https://www.codebox.club/tools/utm-qr-builder): 添加UTM参数并生成线下投放二维码
- [批量二维码生成器](https://www.codebox.club/tools/bulk-qr-code-generator): 粘贴CSV批量预览二维码
- [二维码对比度检测器](https://www.codebox.club/tools/qr-code-contrast-checker): 检查颜色对比度、模块尺寸和Logo覆盖比例，判断扫码风险
- [二维码跳转检查器](https://www.codebox.club/tools/qr-code-redirect-checker): 检查二维码目标链接的HTTPS、短链、UTM、跳转参数和移动端打开风险
- [Logo 二维码安全检测器](https://www.codebox.club/tools/logo-qr-code-safety-checker): 根据Logo覆盖比例、纠错等级、白色底托和静区判断品牌二维码扫码风险
- [二维码 DPI 计算器](https://www.codebox.club/tools/qr-code-dpi-calculator): 根据印刷尺寸、DPI和复杂度换算导出像素、单模块像素和最低DPI建议
- [Email 二维码生成器](https://www.codebox.club/tools/email-qrcode): 邮箱地址、主题和正文转二维码，扫码打开邮件撰写窗口
- [电话二维码生成器](https://www.codebox.club/tools/phone-qrcode): 手机号或座机号转二维码，扫码唤起拨号界面
- [短信二维码生成器](https://www.codebox.club/tools/sms-qrcode): 手机号和预设短信内容转二维码，扫码打开短信发送窗口
- [地点二维码生成器](https://www.codebox.club/tools/location-qrcode): 地点名称、地址或经纬度转二维码，扫码打开地图位置
- [日历事件二维码生成器](https://www.codebox.club/tools/event-qrcode): 活动名称、时间和地点转二维码，扫码添加到手机日历
- [WhatsApp 二维码生成器](https://www.codebox.club/tools/whatsapp-qrcode): WhatsApp 手机号和默认消息转二维码，扫码打开聊天窗口
- [Telegram 二维码生成器](https://www.codebox.club/tools/telegram-qrcode): Telegram 用户名、频道名或邀请链接转二维码
- [小红书二维码生成器](https://www.codebox.club/tools/xiaohongshu-qrcode): 小红书主页链接、笔记链接或小红书号转二维码
- [抖音二维码生成器](https://www.codebox.club/tools/douyin-qrcode): 抖音主页链接、视频链接或抖音号转二维码
- [Instagram 二维码生成器](https://www.codebox.club/tools/instagram-qrcode): Instagram 用户名、主页链接、帖子或 Reels 链接转二维码
- [TikTok 二维码生成器](https://www.codebox.club/tools/tiktok-qrcode): TikTok 用户名、主页链接或视频链接转二维码
- [URL 二维码](https://www.codebox.club/zh/qr/url): 网址链接二维码
- [WiFi 二维码](https://www.codebox.club/zh/qr/wifi): 扫码自动连 WiFi
- [文本二维码](https://www.codebox.club/zh/qr/text): 纯文本内容二维码

## 博客

- [API 接入开发指南](https://www.codebox.club/blog/qr-code-api-guide): 开发者集成教程，含 Node.js/Python/Java 示例
- [MCP Agent 接入指南](https://www.codebox.club/blog/mcp-agent-qrcode): Claude Desktop/Cursor AI Agent 接入
- [动态 vs 静态二维码](https://www.codebox.club/blog/dynamic-vs-static-qr): 两种模式的区别和适用场景
- [带 Logo 二维码教程](https://www.codebox.club/blog/qr-code-with-logo): 3 步制作品牌二维码
- [WiFi 二维码指南](https://www.codebox.club/blog/wifi-qr-code-guide): 扫码连网完全教程
- [UTM 追踪指南](https://www.codebox.club/blog/utm-tracking-qr-code): 二维码营销归因分析
- [二维码设计技巧](https://www.codebox.club/blog/qr-code-design-tips): 美化设计实用技巧
- [2026 营销趋势](https://www.codebox.club/blog/qr-code-marketing-2026): 二维码营销趋势与策略
- [餐饮行业应用](https://www.codebox.club/blog/restaurant-qr-code): 餐厅二维码解决方案

## 行业解决方案

- [餐饮行业方案](https://www.codebox.club/solutions/restaurant): 扫码点餐、外卖引流、会员运营
- [零售行业方案](https://www.codebox.club/solutions/retail): 商品溯源、会员管理、促销活动
- [教育行业方案](https://www.codebox.club/solutions/education): 课堂签到、资料分发、招生推广
- [营销行业方案](https://www.codebox.club/solutions/marketing): 活动推广、数据追踪、A/B 测试
- [电商行业方案](https://www.codebox.club/solutions/ecommerce): 包裹营销、私域引流、防伪验证
- [医疗行业方案](https://www.codebox.club/solutions/healthcare): 预约挂号、药品溯源、随访管理

## 资源中心

- [资源中心首页](https://www.codebox.club/resources): 部署清单、创意案例、类型对比聚合入口

## pSEO 行业资源（31 个行业，每行业含场景指南、部署清单、创意案例、类型对比）

### 餐饮行业
- [餐饮扫码点餐指南](https://www.codebox.club/solutions/restaurant/扫码点餐): 扫码点餐二维码应用方案
- [餐饮会员注册指南](https://www.codebox.club/solutions/restaurant/会员注册): 会员注册二维码应用方案
- [餐饮部署清单](https://www.codebox.club/resources/checklists/restaurant): 24 项二维码部署检查清单
- [餐饮创意案例](https://www.codebox.club/resources/examples/restaurant): 50 个二维码创意应用案例
- [餐饮动态码 vs 静态码](https://www.codebox.club/resources/compare/restaurant): 完整对比与选择建议

### 零售行业
- [零售会员管理指南](https://www.codebox.club/solutions/retail/会员管理): 会员管理二维码应用方案
- [零售促销活动指南](https://www.codebox.club/solutions/retail/促销活动): 促销活动二维码应用方案
- [零售部署清单](https://www.codebox.club/resources/checklists/retail): 24 项二维码部署检查清单
- [零售创意案例](https://www.codebox.club/resources/examples/retail): 50 个二维码创意应用案例
- [零售动态码 vs 静态码](https://www.codebox.club/resources/compare/retail): 完整对比与选择建议

### 教育行业
- [教育家校沟通指南](https://www.codebox.club/solutions/education/家校沟通): 家校沟通二维码应用方案
- [教育招生推广指南](https://www.codebox.club/solutions/education/招生推广): 招生推广二维码应用方案
- [教育部署清单](https://www.codebox.club/resources/checklists/education): 24 项二维码部署检查清单
- [教育创意案例](https://www.codebox.club/resources/examples/education): 50 个二维码创意应用案例
- [教育动态码 vs 静态码](https://www.codebox.club/resources/compare/education): 完整对比与选择建议

### 医疗行业
- [医疗预约挂号指南](https://www.codebox.club/solutions/healthcare/预约挂号): 预约挂号二维码应用方案
- [医疗药品溯源指南](https://www.codebox.club/solutions/healthcare/药品溯源): 药品溯源二维码应用方案
- [医疗部署清单](https://www.codebox.club/resources/checklists/healthcare): 24 项二维码部署检查清单
- [医疗创意案例](https://www.codebox.club/resources/examples/healthcare): 50 个二维码创意应用案例
- [医疗动态码 vs 静态码](https://www.codebox.club/resources/compare/healthcare): 完整对比与选择建议

### 电商行业
- [电商包裹营销指南](https://www.codebox.club/solutions/ecommerce/包裹营销): 包裹营销二维码应用方案
- [电商私域引流指南](https://www.codebox.club/solutions/ecommerce/私域引流): 私域引流二维码应用方案
- [电商部署清单](https://www.codebox.club/resources/checklists/ecommerce): 24 项二维码部署检查清单
- [电商创意案例](https://www.codebox.club/resources/examples/ecommerce): 50 个二维码创意应用案例
- [电商动态码 vs 静态码](https://www.codebox.club/resources/compare/ecommerce): 完整对比与选择建议

### 营销行业
- [营销AB测试指南](https://www.codebox.club/solutions/marketing/AB测试): AB测试二维码应用方案
- [营销裂变营销指南](https://www.codebox.club/solutions/marketing/裂变营销): 裂变营销二维码应用方案
- [营销部署清单](https://www.codebox.club/resources/checklists/marketing): 24 项二维码部署检查清单
- [营销创意案例](https://www.codebox.club/resources/examples/marketing): 50 个二维码创意应用案例
- [营销动态码 vs 静态码](https://www.codebox.club/resources/compare/marketing): 完整对比与选择建议

### 房地产行业
- [房地产在线看房指南](https://www.codebox.club/solutions/real-estate/在线看房): 在线看房二维码应用方案
- [房地产部署清单](https://www.codebox.club/resources/checklists/real-estate): 24 项二维码部署检查清单
- [房地产创意案例](https://www.codebox.club/resources/examples/real-estate): 50 个二维码创意应用案例

### 制造业行业
- [制造业产品溯源指南](https://www.codebox.club/solutions/manufacturing/产品溯源): 产品溯源二维码应用方案
- [制造业部署清单](https://www.codebox.club/resources/checklists/manufacturing): 24 项二维码部署检查清单
- [制造业创意案例](https://www.codebox.club/resources/examples/manufacturing): 50 个二维码创意应用案例

### 物流行业
- [物流包裹追踪指南](https://www.codebox.club/solutions/logistics/包裹追踪): 包裹追踪二维码应用方案
- [物流部署清单](https://www.codebox.club/resources/checklists/logistics): 24 项二维码部署检查清单

### 旅游行业
- [旅游电子门票指南](https://www.codebox.club/solutions/tourism/电子门票): 电子门票二维码应用方案
- [旅游部署清单](https://www.codebox.club/resources/checklists/tourism): 24 项二维码部署检查清单

### 酒店行业
- [酒店自助入住指南](https://www.codebox.club/solutions/hotel/自助入住): 自助入住二维码应用方案
- [酒店部署清单](https://www.codebox.club/resources/checklists/hotel): 24 项二维码部署检查清单

### 健身行业
- [健身会员签到指南](https://www.codebox.club/solutions/fitness/会员签到): 会员签到二维码应用方案
- [健身部署清单](https://www.codebox.club/resources/checklists/fitness): 24 项二维码部署检查清单

### 美容美发行业
- [美容美发在线预约指南](https://www.codebox.club/solutions/beauty/在线预约): 在线预约二维码应用方案
- [美容美发部署清单](https://www.codebox.club/resources/checklists/beauty): 24 项二维码部署检查清单

### 汽车行业
- [汽车试驾预约指南](https://www.codebox.club/solutions/automotive/试驾预约): 试驾预约二维码应用方案
- [汽车部署清单](https://www.codebox.club/resources/checklists/automotive): 24 项二维码部署检查清单

### 金融 / 政务 / 展会 / 婚庆 / 宗教 / 农业 / 文创 / 游戏 / 法律 / 保险 / 宠物 / 家装 / 母婴 / 物业 / 外贸 / 咨询 / 自媒体
- 每个行业均提供 6 个场景指南 + 部署清单 + 50 个创意案例 + 动态码 vs 静态码对比
- 访问路径: /solutions/{行业slug}/{场景名} | /resources/checklists/{行业slug} | /resources/examples/{行业slug} | /resources/compare/{行业slug}

## 联系方式

- 网站: https://www.codebox.club
- 邮箱: freecloud@emong.com.cn