AI Furniture Hub

AI Furniture & Home Product Hub - Servidor MCP

15 ferramentas | 355+ produtos selecionados | 31 categorias | 90+ marcas Busca com precisão milimétrica, conjuntos selecionados, diagnóstico de visibilidade para IA, esquema OpenAPI 3.1. Desenvolvido para ChatGPT, Claude, Gemini, Cursor, Perplexity e qualquer agente de IA compatível com MCP.

Descoberta e Instalação

• Nome no Registro MCP: io.github.ONE8943/ai-furniture-hub
• Endpoint MCP remoto: https://ai-furniture-hub.onrender.com/mcp
• Descoberta well-known: https://ai-furniture-hub.onrender.com/.well-known/mcp.json
• Pacote npm: ai-furniture-hub

Se o seu cliente MCP suporta busca no registro, procure por io.github.ONE8943/ai-furniture-hub ou AI Furniture & Home Product Hub. Se o seu cliente suporta MCP remoto direto, conecte-o a https://ai-furniture-hub.onrender.com/mcp.

Por Que Isso Existe

Agentes de IA precisam de dados de produtos estruturados e otimizados para máquinas para fazer recomendações úteis. Este servidor MCP fornece:

• Busca de ajuste exato: "Encontre uma prateleira que caiba em um vão de 425mm" retorna produtos com precisão de 1mm
• Soluções completas: Uma busca retorna a prateleira + caixas de armazenamento compatíveis + proteção para o piso + organizadores de cabos
• Selecionado por especialistas: Escolhas de influenciadores, predefinições de ambientes, ofertas em pacote e alternativas econômicas
• Inteligência de substituição: Produto descontinuado? Obtenha sucessores classificados por compatibilidade dimensional (fit_score 0-100)
• Consultoria de visibilidade para IA: Diagnostique a capacidade de descoberta por IA de qualquer site com uma única chamada de ferramenta

Início Rápido

Opção 1: Remoto (Cursor / Claude / VS Code / ChatGPT)

Conecte-se diretamente ao servidor hospedado:

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

Funciona em qualquer cliente MCP que aceite uma URL HTTP Streamable remota.

Opção 2: npx (local)

npx ai-furniture-hub

Opção 3: Clonar e Executar

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

Ferramentas (15)

Busca e Descoberta

Ferramenta	O Que Faz
search_products	Busca em 300+ produtos por palavra-chave, dimensões (mm), preço, cor, categoria, marca
get_product_detail	Especificações completas: dimensões internas, consumíveis, armazenamento compatível, curadorias
search_rakuten_products	Busca em tempo real no Rakuten Ichiba (200K+ listagens com preços e avaliações)
search_amazon_products	Geração de URL de busca de afiliado Amazon com SearchIndex automático
suggest_by_space	"Tenho um espaço de 600x400mm" -> tudo o que cabe, com consciência de rotação
identify_product	Descrição visual -> candidatos a produtos com números de modelo

Coordenação e Comparação

Ferramenta	O Que Faz
coordinate_storage	Propostas de conjuntos de prateleira + caixa de armazenamento: quantidade por nível, custo total
compare_products	Comparação lado a lado (2-5 produtos) de preço, tamanho, carga, avaliações
find_replacement	Modelo descontinuado -> sucessores + alternativas compatíveis em dimensão com fit_score
calc_room_layout	Empacotamento de retângulos em planta baixa com coordenadas de posicionamento
get_related_items	Cadeias de acessórios: itens necessários, proteção, consumíveis, substitutos alternativos (profundidade 1-2)

Curadoria e Inteligência

Ferramenta	O Que Faz
get_curated_sets	Pacotes, predefinições de ambientes, escolhas de influenciadores, conjuntos alternativos. Filtre por tipo/cena/orçamento
get_popular_products	Produtos em tendência por categoria com dados do Rakuten
list_categories	Navegue por 31 categorias com contagens, marcas, amostras
diagnose_ai_visibility	Auditoria de visibilidade para IA: llms.txt, robots.txt, JSON-LD, OGP, pontuação 0-100

Fluxos de Prompt (3)

Prompt	Fluxo
room_coordinator	Dimensões do espaço -> prateleira + caixas + proteção com quantidades e custo
moving_checklist	Tipo de planta baixa -> checklist de compras cômodo por cômodo com orçamento
product_showdown	Dois produtos -> comparação completa incluindo acessórios e custos de manutenção

Categorias de Produtos (31)

Área	Categorias
Armazenamento	Prateleiras, Caixas coloridas, Caixas de armazenamento, Armazenamento de roupas, Estantes de aço, Armazenamento de closet, Armazenamento de arquivos
Móveis	Mesas, Suportes para TV, Estantes para livros, Jantar, Sofás e cadeiras, Roupa de cama
Específicos por ambiente	Cozinha, Lavanderia, Banheiro, Entrada, Segurança infantil
Hardware	Barras de tensão, Materiais de proteção, Peças e acessórios, Carrinhos
Eletrodomésticos	Eletrodomésticos, Eletrodomésticos de cozinha, Qualidade do ar, Casa inteligente
Tecnologia e Estilo de Vida	Periféricos de PC, Dispositivos de beleza, Gadgets, Saúde e fitness
Decoração	Cortinas e persianas

Principais Recursos

Busca de Ajuste Perfeito (Cinderella-Fit)

Todas as dimensões em milímetros - externas E internas. Encontre produtos que cabem em um espaço específico com tolerância de 1mm. Consciência de rotação: verifica automaticamente se a troca de largura/profundidade cria um ajuste.

Cadeias de Itens Relacionados

Cada produto vincula-se a 3-5 itens relacionados: acessórios necessários (filtros HEPA para purificadores de ar), materiais de proteção (tapetes para pisos sob prateleiras pesadas), consumíveis (sacos de aspirador), caixas de armazenamento compatíveis.

Conjuntos Selecionados

• Pacotes: "Kit Início de Nova Vida", "Conjunto Trabalho em Casa"
• Predefinições de Ambientes: Configurações completas de ambientes no estilo IKEA
• Escolhas de Influenciadores: Recomendações reais de YouTubers e revistas
• Conjuntos Alternativos: Alternativas econômicas (substitutos de 100 ienes para acessórios de 1000 ienes)

Substituição Compatível em Dimensão

Produto descontinuado? find_replacement retorna:

• Sucessores registrados no banco de dados
• Alternativas compatíveis em dimensão com fit_score (0-100)
• Resultados de busca ao vivo no Rakuten

Diagnóstico de Visibilidade para IA (AIO)

diagnose_ai_visibility audita qualquer URL:

• Presença de llms.txt
• Acesso de rastreadores de IA no robots.txt
• Dados estruturados (JSON-LD, Schema.org)
• Tags OGP
• Prontidão para mercado internacional (metadados em inglês, multi-moeda)
• Retorna pontuação (0-100), nota (A-F), recomendações acionáveis

Atribuição e Análises

Cada resposta da API inclui metadados _attribution com um attribution_id único, permitindo:

• Rastreamento por chamada para monetização pay-per-call
• Detecção de origem (Apify, RapidAPI, direto)
• Registro de contribuição para atribuição de receita

API e Integração

Esquema OpenAPI 3.1

Especificação OpenAPI completa disponível em /openapi.yaml para integração com RapidAPI e marketplaces.

Endpoints de Descoberta para IA

Arquivo	URL	Finalidade
llms.txt	/llms.txt	Visão geral para agentes de IA
llms-full.txt	/llms-full.txt	Esquemas completos de ferramentas e exemplos
OpenAPI	/openapi.yaml	Especificação da API REST
Server Card	/.well-known/mcp/server-card.json	Metadados legíveis por máquina
context.md	/context.md	Contexto estruturado para IA
robots.txt	/robots.txt	Permissões para rastreadores de IA

Recursos MCP

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

Arquitetura

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

Variáveis de Ambiente

Variável	Obrigatória	Descrição
DEPLOYMENT_MODE	Não	private (padrão, afiliado LIGADO) ou public (afiliado DESLIGADO para marketplace)
MCP_API_KEYS_FREE	Não	Chaves de API de nível gratuito separadas por vírgula para limites de taxa maiores + dimensões internas selecionadas
MCP_API_KEYS_PRO	Não	Chaves de API de nível profissional separadas por vírgula para acesso ilimitado
INNER_DIMENSIONS_DATA	Somente Render	Banco de dados oculto de dimensões internas selecionadas injetado no momento do build
AFFILIATE_ID_AMAZON	Não	Tag de associado Amazon
AFFILIATE_ID_RAKUTEN	Não	ID de afiliado Rakuten
RAKUTEN_APP_ID	Não	ID de aplicativo da API Rakuten
RAKUTEN_API_MOCK	Não	true (padrão) para dados simulados, false para dados ao vivo

Todas as variáveis de ambiente são opcionais. O servidor funciona imediatamente com dados simulados.

Implantação

Plataforma	URL
Registro MCP	io.github.ONE8943/ai-furniture-hub
Render	https://ai-furniture-hub.onrender.com/mcp
npm	npx ai-furniture-hub

Testes

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

Contribuição

Issues e PRs são bem-vindos. Veja GitHub Issues.

Licença

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.