commerce-vector-search

Combine semantic embeddings with BM25 keyword matching to search commerce records.

Updated Jan 19, 2026
One-click install
npx skills add https://github.com/stateset/icommerce-skills --skill commerce-vector-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: commerce-vector-search
Source: https://github.com/stateset/icommerce-skills/tree/main/skills/commerce-vector-search
Command: npx skills add https://github.com/stateset/icommerce-skills --skill commerce-vector-search

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Cross-entity search often struggles to balance semantic understanding with exact-match precision. This Skill provides a unified search approach that retrieves products, customers, orders, and inventory using natural language queries and typed filters.

Core Features & Use Cases

  • Hybrid semantic and keyword search across commerce entities.
  • Rank results by combined relevance and allow entity-type filtering.
  • Real-world use: locate products by description, find customers by notes, and locate orders by details.

Quick Start

Use a natural language query like 'show me wireless headphones with noise cancellation' to see ranked results across products, customers, orders, and inventory.

Frequently Asked Questions about commerce-vector-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I combine semantic search with keyword matching for e-commerce data?

Hybrid search combines semantic embeddings with BM25 keyword indexing to retrieve commerce records. This balances natural language understanding with exact-match precision across products, customers, orders, and inventory using OpenAI embeddings and SQLite FTS5.

What is hybrid ranking and how does it work with SQLite FTS5?

Hybrid ranking merges semantic relevance from OpenAI embeddings with exact-match scores from SQLite FTS5 BM25 indexing. This unified approach ensures natural language queries retrieve precise text matches across various commerce entity types.

How can I filter e-commerce search results by entity type?

You can filter e-commerce search results by applying entity-type filters to your query. This allows you to restrict hybrid search retrieval to specific commerce records such as products, customers, orders, or inventory.

Do I need OpenAI embeddings to run semantic search on customer and order records?

Yes, generating OpenAI embeddings is required for semantic search across customer and order records. These embeddings provide the natural language understanding necessary to locate specific customer notes and order details.

How do I set a minimum relevance threshold for vector search results?

You can set minimum relevance thresholds to filter vector search results. This ensures only commerce records that meet a specific combined semantic and keyword matching score are returned in the unified search experience.

When should I use BM25 indexing instead of semantic embeddings for product search?

BM25 indexing handles exact-match keyword precision for product search, while semantic embeddings manage natural language understanding. You should use both simultaneously via hybrid ranking to ensure accurate retrieval of products by description.