集运 API 开发者平台：用你自己的密钥读取集运与报关数据
免人工审查的集运 API——加「好运器集运官方帐号」企业微信 好友即可自助申请密钥，让你的系统、OpenClaw 或 Hermes 直接读取自己的帐单、包裹、预报与税单。会员事件的 Webhook 推送仍在规划中；货况通知目前透过好运器 App 与 企业微信 官方帐号送达。
免人工审查的集运 API——加「好运器集运官方帐号」企业微信 好友即可自助申请密钥，让你的系统、OpenClaw 或 Hermes 直接读取自己的帐单、包裹、预报与税单。会员事件的 Webhook 推送仍在规划中；货况通知目前透过好运器 App 与 企业微信 官方帐号送达。
好运器集运 API 让会员用自己的密钥，从自己的系统读取自己在好运器的帐单、包裹、预报与税单。门槛只有一个：加「好运器集运官方帐号」企业微信 好友；免人工审查，密钥效期 1 年，每把密钥每分钟 60 次、每日 5,000 次。
| 入口 | 适合谁 | 认证方式 | 能读什么 | 次数上限 |
|---|---|---|---|---|
会员数据 APIhttps://howbridge.cn/api/v1/me | 想让自家系统、ERP、调度脚本读自己数据的会员 | Bearer 密钥（在 /member/api 自助创建） | 自己的帐单、包裹、预报、关税税单与进口报单 | 每把密钥每分钟 60 次、每日 5,000 次 |
会员 MCPhttps://howbridge.cn/mcp | 想用 Claude、ChatGPT 等 AI 助理查自己包裹的会员 | OAuth 2.1 授权，不用拷贝密钥 | 和会员数据 API 相同，以 6 支唯读工具提供 | 预设每分钟 60 次、每日 5,000 次 |
公开 MCPhttps://howbridge.cn/mcp/public | 任何人、任何支持 MCP 的用户端 | 免密钥、免 OAuth | 运费与进口税费试算、CCC 税则与输入规定、超材费、集运流程；不含任何会员数据 | 每个 IP 每分钟 120 次 |
全部端点都是唯读的 GET，Base URL 为 https://howbridge.cn/api/v1/me，回应为 JSON。
GET /api/v1/me：会员基本数据与 企业微信 好友状态，接线后建议先打这支确认密钥有效。GET /api/v1/me/usage：这把密钥目前的每分钟与每日用量。GET /api/v1/me/bills、/bills/{code}：帐单列表与单张明细（帐单以会员手机归户，没填手机会拿到空数组与提示）。GET /api/v1/me/shipments：自己的集运包裹，可用 status 筛选已认领、已预报、已入仓、集运中、已出库等状态。GET /api/v1/me/forecasts：自己申报的集运预报。GET /api/v1/me/customs、/customs/{id}：关税税单与进口报单，可用 type 筛选。列表端点可分页（per_page 上限 100），时间为台北时区，金额一律新台币。新会员还没有任何数据时回 200 与空数组，不会报错。个资预设遮罩：身分证字号只露前 3 码与后 3 码、地址只保留县市、电话遮中段；税单与报单字段采白名单输出，不含 OCR 原始全文。
每把密钥分开计算，同时有「每分钟 60 次」与「每日 5,000 次」两道限制。超过任一道会收到 HTTP 429，并附 Retry-After 标头告诉你几秒后再试；成功回应也会附上剩余次数的标头，方便自己节流。请不要用高频轮询逼近上限来模拟实时更新。
MCP（Model Context Protocol）是让 AI 助理调用外部工具的标准界面。好运器的会员 MCP 读的是和集运 API 相同的数据，差别在授权方式：API 用你自己保管的密钥，会员 MCP 则在好运器页面用 OAuth 授权，AI 助理拿不到你的密码或密钥，门槛与次数上限和 API 相同。只想让 AI 算运费、税金或查税则，用免密钥的公开 MCP 即可。
不需要人工审查。登录会员后到 /member/api，帐号须已链接 企业微信 并加「好运器集运官方帐号」为好友，输入应用名称、同意开发者条款就能创建密钥。每个帐号最多同时保有 5 把有效密钥。
密钥效期 1 年，到期不支持续期，要重新创建。密钥明文只在创建当下显示一次，遗失无法找回，请在 /member/api 撤销旧密钥后重建一把新的。
每把密钥每分钟 60 次、每日 5,000 次，超过任一道就回 429，并附 Retry-After 标头告诉你几秒后再试。成功回应的标头也会附剩余次数，请依此节流，不要用高频轮询逼近上限。
会员数据相同，差在使用方式：自家系统、ERP 或调度脚本用 API 密钥直接调用 REST 端点；想用 Claude、ChatGPT 等 AI 助理以对话方式查包裹，就接会员 MCP，以 OAuth 授权、不必拷贝密钥，接法见〈集运 MCP 教学〉。只想算运费与税金，用免密钥的公开 MCP 即可。
不行。密钥只能读密钥拥有者本人的数据，查不到或不属于你的数据一律回 404。代理查找、转售访问权都违反开发者条款，好运器可径行停权或撤销密钥。
会员事件的 Webhook 推送仍在规划中。目前可以在 /member/api 设置并验证网址，但系统还不会送出帐单、包裹状态、放行等事件。上线前请以较低频率定时查找；包裹状态通知目前透过好运器 App 与 企业微信 官方帐号送达。
任何支持 MCP 的 AI 助理都能直接连上，不需帐号、不需 OAuth。提供台湾进口税费、CCC 税则与输入规定、中国→台湾集运运费试算。
| 服务器网址 | https://howbridge.cn/mcp/public |
|---|---|
| 传输方式 | Streamable HTTP |
| 验证 | 不需要（免密钥、免 OAuth） |
lucky_about |
好运器品牌与服务介绍 |
lucky_freight_quote |
中国→台湾集运运费试算（海快／空运） |
lucky_import_tax_estimate |
台湾进口税费试算（关税＋营业税） |
lucky_ccc_tariff_lookup |
CCC 税则号别 → 税率与输入规定 |
lucky_ccc_predict |
商品名称 → CCC 税则候选 |
lucky_hct_oversize_fee |
新竹物流台湾段超材费 |
lucky_workflow |
集运流程说明 |
lucky_simple_declaration |
台湾简易申报规定 |
所有工具唯读、幂等，不会变更任何数据。试算仅供参考：运费以入仓丈量后帐单为准、税费以海关核定为准。
下方的会员版 MCP 需要 OAuth 绑定，回传的是你自己的包裹、帐单与预报；公开 MCP 只提供公开数据（税则、费率、法规），不含任何会员个人数据。
已登录于官方 MCP Registry，名称 tw.0523/lucky-public。