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.

CI npm License: MIT

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

HerramientaQué hace
search_productsBusca más de 300 productos por palabra clave, dimensiones (mm), precio, color, categoría, marca
get_product_detailEspecificaciones completas: dimensiones interiores, consumibles, almacenamiento compatible, selecciones
search_rakuten_productsBúsqueda en tiempo real en Rakuten Ichiba (más de 200 000 listados con precios y reseñas)
search_amazon_productsGeneració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_productDescripción visual -> candidatos a producto con números de modelo

Coordinación y comparación

HerramientaQué hace
coordinate_storagePropuestas de conjunto estante + caja de almacenamiento: cantidad por nivel, coste total
compare_productsComparación lado a lado (2-5 productos) de precio, tamaño, carga, reseñas
find_replacementModelo descatalogado -> sucesores + alternativas compatibles por dimensiones con fit_score
calc_room_layoutEmpaquetado de rectángulos en plano de planta con coordenadas de colocación
get_related_itemsCadenas de accesorios: artículos necesarios, protección, consumibles, sustitutos alternativos (profundidad 1-2)

Selección e inteligencia

HerramientaQué hace
get_curated_setsPaquetes, ajustes predefinidos por habitación, elecciones de influencers, conjuntos alternativos. Filtra por tipo/escena/presupuesto
get_popular_productsProductos en tendencia por categoría con datos de Rakuten
list_categoriesExplora 31 categorías con recuentos, marcas, muestras
diagnose_ai_visibilityAuditoría de visibilidad para IA: llms.txt, robots.txt, JSON-LD, OGP, puntuación 0-100

Flujos de trabajo con prompts (3)

PromptFlujo
room_coordinatorDimensiones del espacio -> estante + cajas + protección con cantidades y coste
moving_checklistTipo de plano de planta -> lista de compras habitación por habitación con presupuesto
product_showdownDos productos -> comparación completa incluyendo accesorios y costes de uso

Categorías de producto (31)

ÁreaCategorías
AlmacenamientoEstantes, Cajas de colores, Cajas de almacenamiento, Almacenamiento de ropa, Estanterías metálicas, Almacenamiento de armario, Almacenamiento de archivos
MueblesEscritorios, Soportes para TV, Librerías, Comedor, Sofás y sillas, Ropa de cama
Específicas de habitaciónCocina, Lavandería, Baño, Entrada, Seguridad infantil
FerreteríaBarras tensoras, Materiales de protección, Piezas y accesorios, Carros
ElectrodomésticosElectrodomésticos del hogar, Electrodomésticos de cocina, Calidad del aire, Hogar inteligente
Tecnología y estilo de vidaPeriféricos para PC, Dispositivos de belleza, Gadgets, Salud y fitness
DecoraciónCortinas 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

ArchivoURLPropósito
llms.txt/llms.txtResumen para agentes de IA
llms-full.txt/llms-full.txtEsquemas completos de herramientas y ejemplos
OpenAPI/openapi.yamlEspecificación de API REST
Tarjeta de servidor/.well-known/mcp/server-card.jsonMetadatos legibles por máquina
context.md/context.mdContexto estructurado para IA
robots.txt/robots.txtPermisos 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

VariableObligatoriaDescripción
DEPLOYMENT_MODENoprivate (predeterminado, afiliados activados) o public (afiliados desactivados para marketplace)
MCP_API_KEYS_FREENoClaves API de nivel gratuito separadas por comas para límites de velocidad más altos + dimensiones interiores seleccionadas
MCP_API_KEYS_PRONoClaves API de nivel profesional separadas por comas para acceso ilimitado
INNER_DIMENSIONS_DATASolo RenderBase de datos oculta de dimensiones interiores seleccionadas inyectada en el momento de la compilación
AFFILIATE_ID_AMAZONNoEtiqueta de asociado de Amazon
AFFILIATE_ID_RAKUTENNoID de afiliado de Rakuten
RAKUTEN_APP_IDNoID de aplicación de API de Rakuten
RAKUTEN_API_MOCKNotrue (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

PlataformaURL
Registro MCPio.github.ONE8943/ai-furniture-hub
Renderhttps://ai-furniture-hub.onrender.com/mcp
npmnpx 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.