qr-agent-core

用途：为AI智能体提供二维码即服务（QR-as-a-Service），以REST API或MCP方式程序化创建、更新、追踪动态二维码。二维码指向短链（/r/:shortId），可随时改目标网址，而二维码图片不变；按多租户设计，并提供扫码分析。\n\n主要能力：支持11种二维码类型（URL、vCard、WiFi、Email、SMS、Phone、Event、Text、Location、Social、App Store）；自定义样式（点形状、角样式、颜色、渐变、内嵌Logo、带CTA文字的边框）；输出SVG与PNG；分析含设备、浏览器、操作系统、国家、城市、来源和按日扫描统计；实时Webhook（HMAC-SHA256签名并记录投递）；UTM自动追加、GTM支持、条件重定向（设备、系统、国家、语言、时间范围或A/B分流）；自定义域名（Pro）；到期与定时换链；转化追踪（像素加API记录购买、注册等事件）；批量操作（每请求最多50个，Pro可CSV上传500个）。MCP服务名为qr-for-agent，提供37个工具，可接入Claude Desktop、Cursor等。\n\n使用方式：所有/api/端点需X-API-Key请求头，密钥格式为qr_加32位随机串，首次启动自动生成并打印到控制台，也可用npm run key:create "my-label"创建、npm run key:list列出；/r/、/i/*、/health、/documentation、/.well-known/*为公开端点无需认证；已发布为npm包qr-for-agent，在MCP配置（claude_desktop_config.json或.cursor/mcp.json）中添加即可；注册可POST /api/register（仅需邮箱，无需信用卡）；文档在/documentation（Swagger UI）。\n\n数据与部署：使用SQLite加Drizzle ORM，六张表（api_keys、qr_codes、scan_events、webhooks、webhook_deliveries、conversion_events），迁移在服务启动时自动执行，数据库持久化于Docker卷；含railway.toml和多阶段Dockerfile，可自托管。测试含195个集成测试。\n\n限制：配额按套餐划分，免费版10个二维码、每月1000次扫描，Pro版19美元/月且不限量（以资料为准，价格与配额可能变动）；自定义域名仅Pro可用；转化追踪为像素加API，具体接入细节资料未展开。