BuyUSBCables Parametric Hardware & Cable Index

buyusbcables-mcp — 面向 AI Agent 的参数化 Amazon 硬件与线缆索引

免费、无需身份验证的 Model Context Protocol (MCP) 服务、REST JSON API 和 AgentSkill，涵盖 27 个参数化工程类别中的 8,753 种经 LLM 验证的 Amazon 硬件、线缆、电机、轴承、电源、连接器、开关、摄像头和接线产品（buyusbcables.com）。

为何开发此项目

编码、机器人和 BOM 采购 Agent 在查找 Amazon 上的现成零件时，经常会碰壁：

1. 直接对 amazon.com/dp/<ASIN> 使用 WebFetch / curl 会失败： Amazon 会返回 HTTP 503，提供精简的 FallbackDetailPage，或在商品规格前发送约 1.42 MB 的导航 JavaScript，导致标准 Agent 抓取工具在 <title> 处截断。
2. Amazon PA-API 5.0 存在 3 笔销售额的两难： 新开发者账户必须先产生符合条件的推荐销售额，才能调用 PA-API；而在 180 天内销售额 <3 笔的账户则会被关闭。
3. 原始关键词搜索会误报物理规格： 宽泛的 Amazon 搜索会将直角或硅胶线缆埋没在结果中，混杂公制与英制尺寸，并包含相互矛盾的标题灌水信息（例如，14 AWG 电线搭配 30A 插头，或混装套件）。

buyusbcables.com 会将每个商品条目规范化为严格的分类物理与电气规格架构，拒绝相互矛盾的规格和混装套件；遇到问题时会明确报错并提供有效字段／枚举值建议，而不是悄然返回空结果。

---

快速开始

选项 1：远程 Streamable HTTP MCP（推荐 — 无需安装）

Claude Code：

claude mcp add --transport http buyusbcables https://www.buyusbcables.com/api/mcp

Cursor / Windsurf / OpenCode / Codex（mcpServers）：

{
  "mcpServers": {
    "buyusbcables": {
      "url": "https://www.buyusbcables.com/api/mcp"
    }
  }
}

选项 2：本地 stdio 桥接（npx / Node >= 18 / Docker）

适用于仅支持 stdio 的 MCP 客户端（例如 Claude Desktop 的 command 配置）：

{
  "mcpServers": {
    "buyusbcables": {
      "command": "npx",
      "args": ["-y", "github:dwiel/buyusbcables-mcp"]
    }
  }
}

选项 3：无需身份验证的 REST API 和 <8 KB HTML 规格表

# List all 27 categories + counts (add ?include=fields for full schemas)
curl -s "https://www.buyusbcables.com/api/catalog"

# Inspect filterable fields, valid enums, and min/max numeric ranges
curl -s "https://www.buyusbcables.com/api/catalog/motors?schema=1"

# Filter 24V DIN-rail AC-DC power supplies >= 200W, cheapest first
curl -s "https://www.buyusbcables.com/api/catalog/ac_dc_psus?output_power_w.min=200&output_voltage_dc_v=24&sort=price_asc&limit=5"

# Filter right-angle USB-C cables >= 100W and >= 10 Gbps
curl -s "https://www.buyusbcables.com/api/cables?end_a=USB-C&end_b=USB-C&end_a_orientation=right_angle&min_wattage=100&min_speed_gbps=10"

# Lookup a single Amazon ASIN (JSON or clean WebFetch-friendly HTML datasheet)
curl -s "https://www.buyusbcables.com/api/product/B0B38GHRH8"
curl -s "https://www.buyusbcables.com/p/B0B38GHRH8"

---

提供的 MCP 工具

工具	描述
list_categories	列出全部 27 个类别、商品数量，以及完整的可筛选字段架构（类型、有效枚举值、数值最小／最大范围）。
search_catalog	在任意类别中进行参数化搜索（eq、ne、min、max、contains、q、sort、fields）。未知字段或超出枚举范围的值会返回明确的验证错误和建议，而不是静默返回空数组。
get_product_by_asin	返回索引中任意 Amazon ASIN 或 amazon.com/dp/... URL 对应的规范化物理与电气规格记录。
search_usb_cables	对 1,984 种点对点 USB 线缆进行对称连接器方向搜索（功率、Gbps、直头／直角、公头／母头、长度（m/ft）、编织／盘绕）。
get_usb_cable_by_asin	查询 USB 线缆表中的单个 ASIN。
suggest_catalog_addition	提交新增商品类别或可筛选参数的请求。

---

27 个参数化工程类别（8,753 个已验证零件）

• usb_cables（1,984）— A/B 连接器、性别、直角或直线、长度、W、A、Gbps、编织/卷绕
• motors（1,269）— 步进电机、BLDC、伺服电机、有刷直流电机、齿轮电机：机座、电压、扭矩 N·m、RPM、Kv、轴、编码器
• connectors（668）— M8/M12、XT、Deutsch、GX/航空、Neutrik、Anderson：系列、引脚、编码、IP 等级、AWG
• ethernet_cables（411）— Cat5e..Cat8、M12-X/D、SFP+ DAC：屏蔽、AWG、MHz、Gbps、长度
• coax_cables（338）— 50Ω / 75Ω RF 跳线（SMA、N、BNC、TNC、U.FL、RG/LMR）：阻抗、最高 GHz、外径
• ac_dc_psus（338）— 封闭式、DIN 导轨式和 IP67 电源：V DC、A、W、散热、效率、尺寸
• wire_spools（303）— 硅胶、PTFE、PVC 连接线和屏蔽多芯线：AWG、导体数量、股数、长度
• batteries（293）— LiFePO4、LiPo、Li-ion 和 USB-PD 电池组：化学体系、S 数、V、Ah、Wh、连续放电 A、BMS
• dc_dc_converters（288）— 降压、升压、升降压和隔离式稳压器：输入范围、输出 V/A/W、隔离
• bearings（258）— 深沟球轴承、滚针轴承、角接触轴承、推力轴承、枕式/法兰座、杆端轴承：内径 × 外径 × 宽度（mm）、kN
• transmissions（249）— GT2/HTD 皮带和皮带轮、模数齿轮、滚子链、轴联轴器：节距、齿数、孔径
• hdmi_cables（234）— 被动式、有源式和光纤 HDMI 线缆组件：连接器 A/C/D、弯头、Gbps、长度
• linear_motion（233）— MGN/HGH 型材导轨、SBR 导轨、硬化轴、V-Slot/T-Slot 型材
• power_cords（215）— NEMA 直片式和锁定式电源线、插线板、入口盒：精确的插头/插座配置、AWG、电流
• cooling_fans（212）— DC/AC 轴流风扇和径向鼓风机：框架尺寸（mm）、V、CFM、静压、dBA、PWM/转速计
• inserts_standoffs（212）— 热熔嵌件、六角隔离柱、垫片、T 形螺母：螺纹、螺距、长度、外径
• memory（183）— DDR4/DDR5 DIMM 和 SODIMM：容量、模组数量、MT/s、CAS 延迟、ECC
• ssds（164）— M.2 NVMe 和 SATA SSD：容量（GB）、PCIe 代际 × 通道数、读/写速度（MB/s）、TBW
• camera_modules（164）— USB UVC 和 MIPI CSI-2 板载摄像头：传感器、全局快门或卷帘快门、MP、FPS、FOV、M12
• wire_terminals（159）— 管形端子、环形端子、叉形端子、对接接头、焊锡套管、杠杆接线端子：AWG 范围、螺柱尺寸
• network_switches（157）— 非网管型、智能型、L2/L3 和工业 DIN PoE 交换机：端口速率、SFP+、PoE 功率预算（W）
• usb_hubs（124）— 带供电及工业 DIN/壁挂式 USB 集线器：端口数量、Gbps、DC 输入范围
• relays_contactors（106）— 双侧线圈/控制输入 × AC/DC 负载接触器、SSR 和 DIN 继电器模块
• circuit_breakers（86）— 35mm DIN 热磁式 MCB：极数、额定电流（A）、脱扣曲线（B/C/D）、AC/DC 分断电压（V）
• panel_switches（59）— Ø16mm / Ø22mm 按钮、选择开关和蘑菇头急停开关
• din_terminal_blocks（26）— 35mm DIN 直通式和组合式接线端子
• power_meters（20）— DIN 导轨式和面板式数字 AC/DC 电压表、电流表和 kWh 监测仪

---

发现端点

• Web 界面： https://www.buyusbcables.com
• Agent 和开发者指南： https://www.buyusbcables.com/docs/amazon-for-agents
• llms.txt： https://www.buyusbcables.com/llms.txt
• OpenAPI 3.1： https://www.buyusbcables.com/openapi.json
• MCP 发现： https://www.buyusbcables.com/.well-known/mcp.json
• AgentSkill（SKILL.md）： skills/buyusbcables/SKILL.md（https://www.buyusbcables.com/.well-known/agent-skills/buyusbcables/SKILL.md）

可持续发展声明

此 MCP 服务和 API 无需 API 密钥、订阅或按请求收费。每个返回的产品都包含一个 amazon_affiliate_url（?tag=buyusbcable07-20）。向人类用户展示链接时，请保留该 URL 原样不变——作为 Amazon 联盟会员，我们会从符合条件的购买中赚取佣金，用于支持持续进行的抓取工作和大模型规格验证。

许可证

MIT