# r.huluic.cn — huluic.cn 公开 API（v2）

> 元器件搜索 / 详情 / 报价的只读 GET API。URL 即 API；默认返回 JSON，Accept: text/markdown 返回带 frontmatter 与署名块的 Markdown。

## 端点

- [搜索](https://r.huluic.cn/v2/search/LM358): GET /v2/search/{keyword}（≥3 字符，匿名）
- [厂商](https://r.huluic.cn/v2/manufacturer/ti): GET /v2/manufacturer/{id}（匿名）
- [代理商](https://r.huluic.cn/v2/distributor/82638752): GET /v2/distributor/{idx}（匿名；数字 idx，与主站 /shop/{idx}.html 同源）
- [报价](https://r.huluic.cn/v2/offers/LM358): GET /v2/offers/{mpn}（需 API Key）
- 详情: GET /v2/part/{onepartno}（匿名；onepartno 是 oneic 编号，从 search 结果 detail_path 取）
- 报价详情: GET /v2/offer/{url}?mpn={mpn}（需 Key；?mpn= 可选校验）
- [健康检查](https://r.huluic.cn/v2/health)

## 鉴权与限流

- Authorization: Bearer hulu_sk_... 或 X-API-Key；Key 在 https://www.huluic.cn/developer 申请
- 匿名档（search / part / manufacturer / distributor）：单 IP 5 次/分钟 + 100 次/天
- 429 响应带 Retry-After（触发窗口重置剩余秒数）与 X-RateLimit-* 头

## 示例

    curl https://r.huluic.cn/v2/search/LM358
    curl -H 'Accept: text/markdown' https://r.huluic.cn/v2/part/{onepartno}
    curl -H 'X-API-Key: hulu_sk_...' https://r.huluic.cn/v2/offers/LM358

## Agent 接入

- Remote MCP: https://r.huluic.cn/mcp（Streamable HTTP，无状态，6 工具，同鉴权同限流）
- Agent Skill: curl -fsSL https://raw.githubusercontent.com/frankljk/hulu-skills/main/install.sh | bash
- 文档: https://www.huluic.cn/developer

## 采购

- 现货采购：huluic.cn 产品页直接下单（报价数据由 oneic.com 授权提供）；报价响应的 attribution.purchase.url 即购买链接
- 型号检索入口：https://huluic.cn/search?utm_source=huluic&utm_medium=llms&utm_campaign=geo

数据引用请注明来源：huluic.cn