AI Furniture Hub
Servidor MCP enfocado en Japón con 15 herramientas para búsqueda de productos con precisión milimétrica en más de 300 artículos y 31 categorías. Conjuntos seleccionados, reemplazos compatibles con dimensiones, diagnóstico de visibilidad con IA.
Documentación
AI Furniture & Home Product Hub - Servidor MCP
15 herramientas | Más de 355 productos seleccionados | 31 categorías | Más de 90 marcas Búsqueda con precisión milimétrica, conjuntos seleccionados, diagnóstico de visibilidad para IA, esquema OpenAPI 3.1. Diseñado para ChatGPT, Claude, Gemini, Cursor, Perplexity y cualquier agente de IA compatible con MCP.
Descubrimiento e instalación
- Nombre en el registro MCP:
io.github.ONE8943/ai-furniture-hub - Endpoint MCP remoto:
https://ai-furniture-hub.onrender.com/mcp - Descubrimiento well-known:
https://ai-furniture-hub.onrender.com/.well-known/mcp.json - Paquete npm:
ai-furniture-hub
Si tu cliente MCP admite búsqueda en el registro, busca io.github.ONE8943/ai-furniture-hub o AI Furniture & Home Product Hub.
Si tu cliente admite MCP remoto directo, conéctalo a https://ai-furniture-hub.onrender.com/mcp.
Por qué existe esto
Los agentes de IA necesitan datos de producto estructurados y optimizados para máquinas para hacer recomendaciones útiles. Este servidor MCP proporciona:
- Búsqueda de ajuste exacto: "Encuentra un estante que quepa en un hueco de 425 mm" devuelve productos con precisión de 1 mm
- Soluciones completas: Una búsqueda devuelve el estante + cajas de almacenamiento compatibles + protección para el suelo + organizadores de cables
- Seleccionado por expertos: Elecciones de influencers, ajustes predefinidos por habitación, ofertas en paquetes y alternativas económicas
- Inteligencia de reemplazo: ¿Producto descatalogado? Obtén sucesores clasificados por compatibilidad dimensional (fit_score 0-100)
- Consultoría de visibilidad para IA: Diagnostica la capacidad de descubrimiento por IA de cualquier sitio web con una sola llamada a una herramienta
Inicio rápido
Opción 1: Remoto (Cursor / Claude / VS Code / ChatGPT)
Conéctate directamente al servidor alojado:
{
"mcpServers": {
"furniture-hub": {
"url": "https://ai-furniture-hub.onrender.com/mcp"
}
}
}
Funciona en cualquier cliente MCP que acepte una URL HTTP Streamable remota.
Opción 2: npx (local)
npx ai-furniture-hub
Opción 3: Clonar y ejecutar
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
Herramientas (15)
Búsqueda y descubrimiento
| Herramienta | Qué hace |
|---|---|
search_products | Busca más de 300 productos por palabra clave, dimensiones (mm), precio, color, categoría, marca |
get_product_detail | Especificaciones completas: dimensiones interiores, consumibles, almacenamiento compatible, selecciones |
search_rakuten_products | Búsqueda en tiempo real en Rakuten Ichiba (más de 200 000 listados con precios y reseñas) |
search_amazon_products | Generación de URL de búsqueda de afiliado de Amazon con SearchIndex automático |
suggest_by_space | "Tengo un espacio de 600x400 mm" -> todo lo que cabe, con detección de rotación |
identify_product | Descripción visual -> candidatos a producto con números de modelo |
Coordinación y comparación
| Herramienta | Qué hace |
|---|---|
coordinate_storage | Propuestas de conjunto estante + caja de almacenamiento: cantidad por nivel, coste total |
compare_products | Comparación lado a lado (2-5 productos) de precio, tamaño, carga, reseñas |
find_replacement | Modelo descatalogado -> sucesores + alternativas compatibles por dimensiones con fit_score |
calc_room_layout | Empaquetado de rectángulos en plano de planta con coordenadas de colocación |
get_related_items | Cadenas de accesorios: artículos necesarios, protección, consumibles, sustitutos alternativos (profundidad 1-2) |
Selección e inteligencia
| Herramienta | Qué hace |
|---|---|
get_curated_sets | Paquetes, ajustes predefinidos por habitación, elecciones de influencers, conjuntos alternativos. Filtra por tipo/escena/presupuesto |
get_popular_products | Productos en tendencia por categoría con datos de Rakuten |
list_categories | Explora 31 categorías con recuentos, marcas, muestras |
diagnose_ai_visibility | Auditoría de visibilidad para IA: llms.txt, robots.txt, JSON-LD, OGP, puntuación 0-100 |
Flujos de trabajo con prompts (3)
| Prompt | Flujo |
|---|---|
room_coordinator | Dimensiones del espacio -> estante + cajas + protección con cantidades y coste |
moving_checklist | Tipo de plano de planta -> lista de compras habitación por habitación con presupuesto |
product_showdown | Dos productos -> comparación completa incluyendo accesorios y costes de uso |
Categorías de producto (31)
| Área | Categorías |
|---|---|
| Almacenamiento | Estantes, Cajas de colores, Cajas de almacenamiento, Almacenamiento de ropa, Estanterías metálicas, Almacenamiento de armario, Almacenamiento de archivos |
| Muebles | Escritorios, Soportes para TV, Librerías, Comedor, Sofás y sillas, Ropa de cama |
| Específicas de habitación | Cocina, Lavandería, Baño, Entrada, Seguridad infantil |
| Ferretería | Barras tensoras, Materiales de protección, Piezas y accesorios, Carros |
| Electrodomésticos | Electrodomésticos del hogar, Electrodomésticos de cocina, Calidad del aire, Hogar inteligente |
| Tecnología y estilo de vida | Periféricos para PC, Dispositivos de belleza, Gadgets, Salud y fitness |
| Decoración | Cortinas y estores |
Características clave
Búsqueda de ajuste Cenicienta
Todas las dimensiones en milímetros: exteriores E interiores. Encuentra productos que quepan en un espacio específico con tolerancia de 1 mm. Con detección de rotación: comprueba automáticamente si intercambiar ancho/profundidad crea un ajuste.
Cadenas de artículos relacionados
Cada producto enlaza con 3-5 artículos relacionados: accesorios necesarios (filtros HEPA para purificadores de aire), materiales de protección (alfombrillas para estantes pesados), consumibles (bolsas de aspiradora), cajas de almacenamiento compatibles.
Conjuntos seleccionados
- Paquetes: "Kit de inicio para nueva vida", "Set para trabajar desde casa"
- Ajustes predefinidos por habitación: Configuraciones completas de habitación estilo IKEA
- Elecciones de influencers: Recomendaciones reales de youtubers y revistas
- Conjuntos alternativos: Alternativas económicas (sustitutos de 100 yenes para accesorios de 1000 yenes)
Reemplazo compatible por dimensiones
¿Producto descatalogado? find_replacement devuelve:
- Sucesores registrados en la base de datos
- Alternativas compatibles por dimensiones con
fit_score(0-100) - Resultados de búsqueda en vivo de Rakuten
Diagnóstico de visibilidad para IA (AIO)
diagnose_ai_visibility audita cualquier URL:
- Presencia de llms.txt
- Acceso de rastreadores de IA en robots.txt
- Datos estructurados (JSON-LD, Schema.org)
- Etiquetas OGP
- Preparación transfronteriza (metadatos en inglés, multidivisa)
- Devuelve puntuación (0-100), calificación (A-F) y recomendaciones prácticas
Atribución y analítica
Cada respuesta de API incluye metadatos _attribution con un attribution_id único, lo que permite:
- Seguimiento por llamada para monetización de pago por llamada
- Detección de fuente (Apify, RapidAPI, directa)
- Registro de contribuciones para atribución de ingresos
API e integración
Esquema OpenAPI 3.1
Especificación OpenAPI completa disponible en /openapi.yaml para integración con RapidAPI y marketplaces.
Endpoints de descubrimiento para IA
| Archivo | URL | Propósito |
|---|---|---|
| llms.txt | /llms.txt | Resumen para agentes de IA |
| llms-full.txt | /llms-full.txt | Esquemas completos de herramientas y ejemplos |
| OpenAPI | /openapi.yaml | Especificación de API REST |
| Tarjeta de servidor | /.well-known/mcp/server-card.json | Metadatos legibles por máquina |
| context.md | /context.md | Contexto estructurado para IA |
| robots.txt | /robots.txt | Permisos para rastreadores de IA |
Recursos MCP
furniture-hub://llms.txt
furniture-hub://llms-full.txt
Arquitectura
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
Variables de entorno
| Variable | Obligatoria | Descripción |
|---|---|---|
DEPLOYMENT_MODE | No | private (predeterminado, afiliados activados) o public (afiliados desactivados para marketplace) |
MCP_API_KEYS_FREE | No | Claves API de nivel gratuito separadas por comas para límites de velocidad más altos + dimensiones interiores seleccionadas |
MCP_API_KEYS_PRO | No | Claves API de nivel profesional separadas por comas para acceso ilimitado |
INNER_DIMENSIONS_DATA | Solo Render | Base de datos oculta de dimensiones interiores seleccionadas inyectada en el momento de la compilación |
AFFILIATE_ID_AMAZON | No | Etiqueta de asociado de Amazon |
AFFILIATE_ID_RAKUTEN | No | ID de afiliado de Rakuten |
RAKUTEN_APP_ID | No | ID de aplicación de API de Rakuten |
RAKUTEN_API_MOCK | No | true (predeterminado) para datos simulados, false para datos en vivo |
Todas las variables de entorno son opcionales. El servidor funciona de serie con datos simulados.
Implementación
| Plataforma | URL |
|---|---|
| Registro MCP | io.github.ONE8943/ai-furniture-hub |
| Render | https://ai-furniture-hub.onrender.com/mcp |
| npm | npx ai-furniture-hub |
Pruebas
npm run test:ci # Vitest
npm run test:all # Full legacy suite
Contribuciones
Se aceptan incidencias y solicitudes de extracción. Consulta Incidencias de GitHub.
Licencia
MIT
Japonés / 日本語
AI Furniture & Home Product Hub は家具・家電・ガジェット等のAIエージェント向け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+ブランド のキュレーション済みカタログ
-
mm精度の寸法検索 - 「幅425mmの隙間にぴったり収まる棚」を即座に発見
-
関連アイテムチェーン - 1商品から3-5個の関連商品(必須アクセサリ、保護材、消耗品)
-
キュレーション - バンドル提案、ルームプリセット、インフルエンサーおすすめ、100均代用ハック
-
後継品検索 - 廃番商品から寸法互換の代替品をfit_scoreで提案
-
AI可視性診断(AIO) - Webサイトの「AIからの見え方」を0-100でスコアリング
-
OpenAPI 3.1 - RapidAPI等のマーケットプレイス連携対応
運営
ONE, Inc.