给智能体

二维码,不用浏览器。

FreeQrly 讲 HTTP 和 MCP。从任何智能体、脚本或工作流生成静态二维码——不用密钥,不用注册,不过期。能发请求,就能做二维码。

接入方式

🧰 MCP 服务器

把 https://freeqrly.com/mcp 加到你的 MCP 客户端。一个工具——generate_qr——无需认证。支持 Claude Code、Cursor 和任何讲 Streamable HTTP 的工具。

🌐 HTTP API

一个返回 SVG 的普通 GET 接口。CORS 完全开放,浏览器、curl 和无服务器函数都能直接调用。

📜 智能体技能

一个带载荷配方的 SKILL.md 放在仓库的 skills/qr-generator/。把你的智能体指向它,剩下的它都知道。

🤖 llms.txt

/llms.txt 给爬虫和助手描述整个网站——接口、载荷格式和页面地图,都在一个文件里。

HTTP API

GET https://freeqrly.com/api/qr?data=TEXT&size=1024&margin=4&color=2F4A62&bgcolor=ffffff&ecc=M

返回 image/svg+xml。只有 data 是必填的;其他都有合理的默认值。错误以 JSON 返回,带一个 error 字段。

curl "https://freeqrly.com/api/qr?data=https://example.com&size=1024" \
  -o qr.svg

# WiFi QR code for guests
curl "https://freeqrly.com/api/qr?data=WIFI:T:WPA;S:CafeNet;P:s3cret;;" \
  -o wifi.svg

参数

  • data —— 要编码的文本(必填,最多 2000 个字符)。链接、WiFi 字符串、vCard、纯文本。
  • size —— 输出尺寸,单位 px,128–2048(默认 1024)。
  • margin —— 静区,单位模块,0–10(默认 4)。
  • color / bgcolor —— 6 位十六进制,没有 #(默认 2F4A62 / ffffff)。
  • ecc —— 纠错等级 L、M、Q、H(默认 M)。打印或加 Logo 时用 Q/H。

MCP

POST https://freeqrly.com/mcp

标准 Streamable HTTP:initialize,然后 tools/list / tools/call。generate_qr 工具接受 data、size、color、bgcolor、ecc,返回一个可直接下载的 SVG 链接。

{
  "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": {
    "name": "generate_qr",
    "arguments": { "data": "https://example.com", "size": 1024 }
  }
}

载荷配方

Website : https://example.com/menu
WiFi    : WIFI:T:WPA;S:CafeNet;P:s3cret;;
Contact : BEGIN:VCARD\nVERSION:3.0\nN:Ada Lovelace\nTEL:+15550100\nEND:VCARD
Place   : geo:37.7749,-122.4194
SMS     : sms:+15550100?body=Hello

合理使用

免费,但请善待它:缓存结果,不要重复请求同一个码;自动化流量保持合理。每个 IP 有速率限制。静态码是确定性的——同样的输入永远得到同样的输出,所以缓存很简单。