AI Furniture & Home Product Hub

AI 家具与家居产品中心 - MCP 服务

15 个工具 | 355+ 款精选产品 | 31 个品类 | 90+ 个品牌 毫米级精度搜索、精选组合、AI 可见度诊断、OpenAPI 3.1 schema。 适用于 ChatGPT、Claude、Gemini、Cursor、Perplexity 及任何兼容 MCP 的 AI Agent。

发现与安装

• MCP Registry 名称：io.github.ONE8943/ai-furniture-hub
• 远程 MCP 端点：https://ai-furniture-hub.onrender.com/mcp
• 已知发现地址：https://ai-furniture-hub.onrender.com/.well-known/mcp.json
• npm 包：ai-furniture-hub

如果你的 MCP 客户端支持 Registry 搜索，请搜索 io.github.ONE8943/ai-furniture-hub 或 AI Furniture & Home Product Hub。 如果你的客户端支持直接连接远程 MCP，请连接到 https://ai-furniture-hub.onrender.com/mcp。

项目缘起

AI Agent 需要结构化、针对机器优化的产品数据，才能提供有用的推荐。此 MCP 服务提供：

• 精准适配搜索：「查找适合 425mm 间隙的搁架」可返回精度达 1mm 的产品
• 完整解决方案：一次搜索即可返回搁架、配套收纳盒、地板保护用品和理线器
• 专家精选：网红推荐、房间预设、套装优惠和预算友好型替代方案
• 替换推荐智能：产品停产？可根据尺寸兼容性对后继产品排序（fit_score 为 0-100）
• AI 可见度咨询：只需调用一次工具，即可诊断任意网站的 AI 可发现性

快速开始

选项 1：远程（Cursor / Claude / VS Code / ChatGPT）

直接连接到托管服务：

{
  "mcpServers": {
    "furniture-hub": {
      "url": "https://ai-furniture-hub.onrender.com/mcp"
    }
  }
}

适用于任何接受远程 Streamable HTTP URL 的 MCP 客户端。

选项 2：npx（本地）

npx ai-furniture-hub

选项 3：克隆并运行

git clone https://github.com/ONE8943/ai-furniture-hub.git
cd ai-furniture-hub
npm install
cp .env.example .env   # API keys optional - works with mock data
npm start               # stdio mode
npm run start:http      # HTTP mode at localhost:3000/mcp

工具（15 个）

搜索与发现

工具	功能
search_products	按关键词、尺寸（mm）、价格、颜色、品类和品牌搜索 300+ 款产品
get_product_detail	完整规格：内部尺寸、消耗品、兼容的收纳用品、精选信息
search_rakuten_products	实时搜索 Rakuten Ichiba（200K+ 条商品信息，含价格和评价）
search_amazon_products	生成 Amazon 联盟搜索 URL，自动设置 SearchIndex
suggest_by_space	「我有一个 600x400mm 的空间」-> 推荐所有适配物品，并考虑旋转摆放
identify_product	根据外观描述推荐产品候选项及型号

协调与比较

工具	功能
coordinate_storage	提供搁架与收纳盒套装方案：每层数量、总价
compare_products	从价格、尺寸、承重和评价等方面并排比较 2-5 款产品
find_replacement	为停产型号推荐后继产品及尺寸兼容的替代品，并提供 fit_score
calc_room_layout	根据平面图进行矩形排布，并提供摆放坐标
get_related_items	配件链：必需品、保护用品、消耗品、改造替代品（深度为 1-2）

精选与智能分析

工具	功能
get_curated_sets	套装、房间预设、网红推荐、改造套装。可按类型、场景和预算筛选
get_popular_products	根据 Rakuten 数据按品类推荐热门产品
list_categories	浏览 31 个品类及其数量、品牌和示例
diagnose_ai_visibility	AI 可见度审计：llms.txt、robots.txt、JSON-LD、OGP，评分为 0-100

提示词工作流（3）

提示词	流程
room_coordinator	空间尺寸 -> 货架 + 箱子 + 保护用品及其数量与费用
moving_checklist	平面图类型 -> 按房间划分的采购清单及预算
product_showdown	两款产品 -> 包含配件与运行成本的完整对比

产品类别（31）

领域	类别
收纳	货架、彩色箱、收纳箱、衣物收纳、钢制货架、衣柜收纳、文件收纳
家具	桌子、电视柜、书架、餐厅家具、沙发和椅子、床上用品
特定房间	厨房、洗衣房、浴室、玄关、婴儿安全用品
五金	伸缩杆、保护材料、零件和配件、推车
家电	家用电器、厨房电器、空气质量、智能家居
科技与生活方式	PC 外设、美容设备、小工具、健康与健身
装饰	窗帘和百叶窗

主要功能

严丝合缝的搜索

所有尺寸均以毫米为单位，涵盖外部和内部尺寸。查找能放入特定空间的产品，容差为 1 mm。支持旋转检测：自动检查交换宽度和深度后是否能放入。

关联商品链

每款产品都会关联 3-5 件相关商品：必需配件（空气净化器的 HEPA 滤网）、保护材料（重型货架用地垫）、耗材（吸尘器集尘袋）以及兼容的收纳箱。

精选套装

• 组合套装：“新生活入门套装”“居家办公套装”
• 房间预设：IKEA 风格的完整房间配置
• 达人精选：来自 YouTuber 和杂志的真实推荐
• 改造套装：经济型替代品（用 100 日元商品替代 1000 日元配件）

尺寸兼容的替代品

产品已停产？find_replacement 会返回：

• 数据库中登记的后续产品
• 带有 fit_score（0-100）的尺寸兼容替代品
• 乐天实时搜索结果

AI 可见性诊断（AIO）

diagnose_ai_visibility 可审查任意 URL：

• 是否存在 llms.txt
• AI 爬虫是否可访问 robots.txt
• 结构化数据（JSON-LD、Schema.org）
• OGP 标签
• 跨境就绪情况（英文元数据、多币种）
• 返回分数（0-100）、等级（A-F）和可执行建议

归因与分析

每个 API 响应都包含带有唯一 attribution_id 的 _attribution 元数据，可用于：

• 按次付费变现的单次调用跟踪
• 来源检测（Apify、RapidAPI、直接调用）
• 用于收入归因的贡献记录

API 与集成

OpenAPI 3.1 规范

完整的 OpenAPI 规范可在 /openapi.yaml 获取，用于 RapidAPI 和市场集成。

AI 发现端点

文件	URL	用途
llms.txt	/llms.txt	AI Agent 概览
llms-full.txt	/llms-full.txt	完整的工具架构与示例
OpenAPI	/openapi.yaml	REST API 规范
Server Card	/.well-known/mcp/server-card.json	机器可读元数据
context.md	/context.md	结构化 AI 上下文
robots.txt	/robots.txt	AI 爬虫权限

MCP 资源

furniture-hub://llms.txt
furniture-hub://llms-full.txt

架构

AI Agent (ChatGPT, Claude, Gemini, Cursor, Perplexity, ...)
    | MCP (stdio or Streamable HTTP)
    v
+-----------------------------------------------------------+
|  15 Tools + 3 Prompts                                     |
+-----------------------------------------------------------+
|  355+ Products | 31 Categories | 90+ Brands               |
|  Curated Sets: bundles, room presets, influencer picks     |
|  Compatibility DB: dimension-based fit scoring             |
|  Attribution: per-request tracking with attribution_id     |
+-----------------------------------------------------------+
|  Adapters: Rakuten API / Amazon URL / Nitori               |
|  Affiliate Engine + Gap Detector + Analytics               |
+-----------------------------------------------------------+
    |
    v
  /llms.txt        /llms-full.txt        /openapi.yaml
  /context.md      /.well-known/mcp/     /robots.txt

环境变量

变量	必需	说明
DEPLOYMENT_MODE	否	private（默认，启用联盟营销）或 public（面向市场时关闭联盟营销）
MCP_API_KEYS_FREE	否	以逗号分隔的免费层级 API 密钥，可获得更高的速率限制和精选内在维度
MCP_API_KEYS_PRO	否	以逗号分隔的专业层级 API 密钥，可获得无限访问权限
INNER_DIMENSIONS_DATA	仅限 Render	在构建时注入的隐藏精选内在维度数据库
AFFILIATE_ID_AMAZON	否	Amazon Associate 标签
AFFILIATE_ID_RAKUTEN	否	Rakuten 联盟营销 ID
RAKUTEN_APP_ID	否	Rakuten API 应用程序 ID
RAKUTEN_API_MOCK	否	true（默认）表示使用模拟数据，false 表示使用实时数据

所有环境变量都是可选的。该服务开箱即用，并使用模拟数据。

部署

平台	URL
MCP Registry	io.github.ONE8943/ai-furniture-hub
Render	https://ai-furniture-hub.onrender.com/mcp
npm	npx ai-furniture-hub

测试

npm run test:ci      # Vitest
npm run test:all     # Full legacy suite

贡献

欢迎提交问题和 PR。请参阅 GitHub Issues。

许可证

MIT

---

日语 / 日本語

AI Furniture & Home Product Hub 是面向家具、家电和数码产品等领域 AI Agent 的 MCP 服务。

• MCP Registry 名称：io.github.ONE8943/ai-furniture-hub

• 远程连接 URL：https://ai-furniture-hub.onrender.com/mcp

• well-known：https://ai-furniture-hub.onrender.com/.well-known/mcp.json

• 355+ 件商品、31 个类别、90+ 个品牌的精选目录

• 毫米级精度尺寸搜索——立即找到“恰好适合 425 mm 宽空间的架子”

• 相关商品链——从 1 件商品找到 3-5 件相关商品（必需配件、保护材料、耗材）

• 精选内容——套装推荐、房间预设、网红推荐、百元店替代方案技巧

• 后续产品搜索——从停产商品出发，根据 fit_score 推荐尺寸兼容的替代品

• AI 可见性诊断（AIO）——以 0-100 分评估网站的“AI 视角”

• OpenAPI 3.1——支持接入 RapidAPI 等市场

运营方

ONE, Inc.