让 Excel / WPS 自己会选材
不用切网页：在表格里写一句需求，牌号、标准、估算价、热处理工艺直接落进单元格。 公式拖下去，一张 BOM 表的选型就填完了。
第 1 步 · 拿一个 API Key
- 打开 站点首页 登录（没有账号先注册，免费）。
- 点右上角「我的」，找到 API Key 区块。
- 点「新建」，每日配额填
1000（够一张表用很久），复制gc_开头那串字符。
Key 只在创建时显示一次。它等同于你的账号凭证，不要外发或写进公开文档。
第 2 步 · 选一种方式
A · 零代码
Excel 2013+ / WPS 自带 WEBSERVICE，写完就出结果。适合先试一下效果。
B · VBA 函数
函数名更好记（GC选材），能按工况推工艺，报错也更清楚。需要启用宏。
C · Power Query
公司禁用宏时的替代方案。刷新一次全表更新，可配合「数据 → 全部刷新」。
方式 A · 零代码：WEBSERVICE
找一格空单元格，粘贴下面这行（把 你的Key 换成第 1 步复制到的 Key，A2 换成你的需求所在单元格）：
=WEBSERVICE("https://gradecard.online/api/v1/cell?token=你的Key&format=text&field=grade&text="&ENCODEURL(A2))
ENCODEURL 不能省：中文直接写进网址会变成乱码，服务端认不出来。
回车后单元格里出现牌号。往下拖，整列一次算完。换 field= 就能取别的字段：
| 要什么 | field 写 | 例子会显示 |
|---|---|---|
| 推荐牌号 | grade | 40Cr |
| 标准号 | standard | GB/T 3077 |
| 等效牌号 | equivalent_us | 5140 |
| 估算价 | est_price | 6075 |
| 推荐热处理工艺 | process | 调质 |
| 备选牌号 | alternatives | 42CrMo、35CrMo |
| 来源引用行 | source | 40Cr · GB/T 3077 · 等效 5140 · 数据版本 … |
| 一整套 | all | 40Cr | 合金结构钢 | GB/T 3077 | 估算 6075 元/吨 | 工艺：调质 |
提示：WEBSERVICE 在个别版本里会被单元格宽度截断显示，实际值没丢；拉宽列或看编辑栏即可。
如果整列显示 #VALUE!，多半是 Key 少复制了几位。
方式 B · VBA 自定义函数
下载模块文件，或直接复制代码。两者内容一样，导入更省事：
下载 GradeCard.bas （VBA 编辑器 → 文件 → 导入文件）
导入后：打开 VBA 编辑器（Alt + F11）→ 找到模块 GradeCard → 把最上面两行的
GC_KEY 改成你的 Key → 保存为 .xlsm（启用宏的工作簿）。
Public Const GC_BASE As String = "https://gradecard.online" Public Const GC_KEY As String = "把 gc_ 开头的 API Key 粘到这里"
然后就能在单元格里用了：
| 写法 | 结果 |
|---|---|
=GC选材(A2) | 首选牌号 |
=GC选材(A2,"standard") | 标准号 |
=GC选材(A2,"est_price") | 估算价（元/吨） |
=GC选材(A2,"all") | 牌号 + 类别 + 标准 + 价格 + 工艺 |
=GC选材(A2,"grade",1) | 第二名候选（0 是第一名） |
=GC牌号("40Cr","tensile_strength") | 查某个牌号的属性 |
=GC工艺("40Cr","传动轴 耐磨") | 按工况推热处理工艺 |
=GC对比("40Cr","45#") | 两个牌号的关键差异 |
=GC额度() | 今日剩余调用次数 |
=GC诊断() | 连不上时先跑这个，它会指出卡在哪一步 |
两种常见毛病：
显示 #NAME? → 模块没导入成功，或文件存成了 .xlsx（宏被丢掉），改存 .xlsm。
结果以 ! 开头 → 那是错误提示不是牌号，跑一下 =GC诊断() 看具体原因。
方式 C · Power Query（公司禁宏时用）
- 把文件里
GC_KEY改成你的 Key。 - Excel → 数据 → 获取数据 → 其他源 → 空查询 → 高级编辑器 → 粘贴全部内容 → 完成。
- 右侧「查询」面板里把查询改名为
GradeCard。 - 单元格里写
=GradeCard(A2)，可选第二个参数"standard"/"est_price"/"process"/"all"。
注意：Power Query 每次刷新都会重新调用接口。表里 100 行就是 100 次调用， 会消耗 API 额度；数据不动时不用点刷新。
公式生成器
填好下面几项，直接生成一整列公式，复制粘贴进 Excel 即可（从你指定的起始行开始，一行一条）。
常见问题
| 现象 | 原因与处理 |
|---|---|
单元格显示 #NAME? | VBA 模块没导入，或文件没存成 .xlsm。 |
单元格显示 #VALUE! | Key 不完整（少复制了几位），或参数里少了 ENCODEURL。 |
结果是 !今日配额已用完 | 到网站「我的 → API Key」新建一个更高配额的 Key 换上。 |
结果是 !缺少需求（text） | 左边的需求格是空的，先补文字再下拉。 |
| 整列突然变慢 | WEBSERVICE 是同步调用，一列几百行会排队。建议按 Ctrl+Alt+F9 手动重算，别设成自动。 |
| 想批量选材又不想写公式 | 用网页的 BOM 批量选型：粘贴一列需求，导出询价单 xlsx / csv。 |
额度与数据说明
每一次取值算一次调用，按你的 API Key 计。今日用量可以用 =GC额度() 随时看。
牌号数据来自公开国标与手册整理，结果仅供初步参考，最终选材需结合力学计算与试验验证。
需要更高额度或企业内网部署，见 首页 的客服邮箱。 让 AI 助手（Claude / Cursor / Codex）直接调用同一套能力，见 AI 助手接入（MCP）。