iwant.fyi
AI智能体需求侧商品匹配引擎
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：iwant.fyi。 它的用途是：AI智能体需求侧商品匹配引擎 详细介绍见：https://321skill.com/skills/iwant-fyi/ 请根据该页面的说明完成安装。
使用示例
'帮我找一台15英寸以内、品牌为联想、价格不超过5000元的笔记本电脑，优先考虑京东和天猫渠道。' 它会调用 iwant.fyi 传入需求，引擎返回跨源匹配结果，按价格排序，并附带每个产品的型号、GTIN、库存状态等，AI 再根据这些信息推荐最佳选项。
介绍
iwant.fyi 解决的是 AI 智能体如何高效、精准地完成商品采购的问题。传统电商搜索接口面向人类用户，返回结果杂乱且缺乏结构化约束；而智能体需要表达购买意图（如“我需要一台 15 英寸以内、品牌为联想的笔记本电脑”），并期望得到跨多个来源、按规则排序的匹配结果。iwant.fyi 提供统一的需求侧协议，让智能体一句话描述需求，即可获得规范化产品数据。
使用方式极其简单：智能体通过 MCP 协议（或 HTTP/A2A 接口）调用 iwant.fyi，传入用户想买什么，并附带结构化约束（如品牌、型号、价格区间、成色下限等）。引擎会跨多个电商源（商品库、比价平台等）进行匹配，返回按相关性或价格等维度的排序结果，每个匹配项都包含标准化的品牌、型号、GTIN、数量等字段，方便智能体直接处理。整个过程一次调用完成，无需多次查询。
这个工具特别适合需要自动采购、比价、库存补充的智能体开发者，以及电商运营、产品经理等需要构建“买家代理”场景的人员。例如，智能体可以代表用户自动搜索商品、比较价格、筛选符合预算的选项，甚至在下单前做合规检查。iwant.fyi 是需求侧协议的参考实现，协议本身开放（v1.0），可扩展支持更多数据源。
建议在使用前明确约束条件的表达粒度，比如品牌、数值范围等字段的格式需与协议一致，否则可能匹配不精确。目前引擎覆盖的品类较多，但特定长尾商品可能覆盖不全，建议先测试核心品类。另外，由于是需求侧协议，智能体需承担“购买意图”的表述，而非直接搜索关键词，需要一定的提示词工程经验。
核心特点
与通用商品搜索 API 不同，iwant.fyi 专为 AI 智能体设计，通过需求侧协议让智能体结构化表达购买意图（品牌、数值范围、成色下限等），并在一次调用中跨多个来源进行排名匹配，返回规范化产品规格，而非简单返回搜索结果列表。
注意事项
不适合需要实时库存或价格动态更新的场景，以及需要用户自主浏览、人工筛选的电商浏览场景，因为它是为智能体自动匹配设计的。
常见问题
如何将 iwant.fyi 集成到我的智能体中？
通过 MCP 协议（推荐）或 HTTP/A2A 接口调用，传入用户购买意图和结构化约束，即可获得跨源匹配结果。参考 README 中的协议文档。
支持哪些数据源？
目前支持多个电商源（具体列表见协议文档），品类无关，可覆盖大多数常见商品。数据源持续扩展中。