Changelog

All notable changes to Facetize.io will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

2025-12-02

Added

Enhanced Data Extraction

• Query Terms for Name-Based Product Search
  • New queryTerms parameter for name-based product search in platforms
  • Extracts product names and brand names (e.g., "iPhone 15 Pro", "Nike Air Max")
  • Automatically filters out unrelated data (categories, attributes, prices, availability, tags, collections)
  • Optimized for finding best name matches in product databases

API Enhancements

• Extended translation response to include queryTerms parameter
• Updated REST API and MCP tool documentation to include queryTerms field
• keyTerms is removed from the response in favor of queryTerms

2025-11-21

Added

Enhanced Data Extraction

• Product Collections
  • Collection extraction from natural language queries (e.g., "Summer collection", "Holiday collection")
  • Store-specific product groupings separate from taxonomy categories
  • Automatic extraction when explicitly mentioned in queries

API Enhancements

• Extended translation response to include collections parameter
• Updated REST API and MCP tool documentation to include collections field

2025-11-20

Added

MCP Server

• Model Context Protocol (MCP) Server (/api/mcp)
  • New MCP server endpoint for tool-based integration with MCP-compatible clients
  • Streamable HTTP transport for efficient real-time communication
  • OAuth-protected resource metadata endpoint for authentication discovery
  • Comprehensive MCP documentation page (/mcp-docs)
  • translate tool for natural language query translation via MCP protocol
  • Support for Claude Desktop and other MCP-compatible clients

Enhanced Data Extraction

• Product Identifiers

  • GTIN extraction (EAN, UPC, barcode numbers) from natural language queries
  • Model number extraction (SKUs, part numbers, product codes)
  • Support for multiple identifiers in a single query

• Product Availability

  • Availability status detection (in-stock/out-of-stock) from queries
  • Automatic extraction when explicitly mentioned in queries

• Product Tags

  • Tag extraction when explicitly mentioned in queries
  • Support for filtering products by tags

API Enhancements

• Extended translation response to include GTINs, model numbers, availability status, and tags
• Updated REST API and MCP tool to return new data fields
• Enhanced query parser with support for product identifiers and availability detection

2025-11-15

Added

Core Features

• Natural Language Query Translation API (/api/translate)
  • Transform natural language product queries into structured taxonomy matches
  • Support for complex queries with multiple intents

Query Understanding

• Intelligent parsing of natural language queries
• Automatic extraction of:
  • Product categories and verticals
  • Price ranges (min/max with currency detection)
  • Vendor/brand names
  • Product attributes and values
  • Query intent classification

Taxonomy Matching

• Accurate matching to product taxonomy
• Multi-level taxonomy support (categories → attributes → values)
• Confidence scoring for all matches
• Hierarchical filtering and automatic result refinement
• Relationship-aware matching that understands taxonomy structure

Performance & Reliability

• Query result caching for faster responses
• Automatic cache management
• Comprehensive error handling with graceful fallbacks

Web Interface

• Interactive demo interface for testing queries
• Real-time API response visualization
• Modern, accessible UI